Produkte per REST-API übertragen | OCI und cXML PunchOut-Kataloge erstellen | PunchCommerce                           ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

Produkte per REST-API übertragen
================================

Sie haben die Möglichkeit, für jeden Ihren Kunden einen API-Schlüssel zu generieren und diesen für die automatisierte Übertragung von Produkten zu verwenden. Hierfür steht Ihnen aktuell eine PHP-Bibliothek als composer-Bundle zur Verfügung.

**API-Url und Authentifizierung**

Die aktuelle Version der REST-API ist unter  erreichbar. Die Authentifizierung erfolgt über das Bearer-Token, welches in Ihrem PunchCommerce-Kunden angezeigt wird.

**Produkte abrufen**

GET

**Produkt abrufen**

GET }

```
{
    "brand_ordernumber": "",
    "category": "Freizeit & Elektro",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Hauptartikel",
    "description": "Hauptartikel",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "classification_type": "UNSPSC",
    "classification": "43232403",
    "shipping_time": 3,
    "active": true
}
```

**Produkt anlegen**

POST

```
{
    "brand_ordernumber": "",
    "category": "Freizeit & Elektro",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Hauptartikel",
    "description": "Hauptartikel",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "shipping_time": 3,
    "classification_type": "UNSPSC",
    "classification": "43232403",
    "active": true
}
```

**Produkt aktualisieren**

PUT }

```
{
    "brand_ordernumber": "",
    "category": "Freizeit & Elektro",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Hauptartikel",
    "description": "Hauptartikel",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "shipping_time": 3,
    "classification_type": "UNSPSC",
    "classification": "43232403",
    "active": true
}
```

**Alle Produkte löschen**

DELETE

**Ein Produkt löschen**

DELETE }

**Composer Bundle**

Die PunchCommerce-Client-Library als composer-Bundle finden Sie in unserem Git-Repository unter

**Mengeneinheiten**

Wir empfehlen schon für die Auszeichnung der Artikel UN/CEFACT-Einheiten zu verwenden. Eine vollständige Liste der Einheiten können Sie unter dem nachfolgenden Link abrufen:

[https://unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20\_rev3\_Annex3e.pdf](https://unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20_rev3_Annex3e.pdf)

**Kategorie**

Als Kategorie kann ein Pfad von Kategorien angegeben werden. Dabei müssen die einzelnen Kategorienamen durch ein "|" voneinander getrennt werden. Der Pfad wird von links nach rechts als Verschachtelung interpretiert.

Beispiel:

Wohnen|Küche|Elektrogeräte

wird zu

- Wohnen
    - Küche
        - Elektrogeräte

 [ PunchCommerce® ist ein Produkt der ![Netzdirektion GmbH](https://www.punchcommerce.de/static/netzdirektion-logo.png "PunchCommerce® ist ein Produkt der netzdirektion | Gesellschaft für digitale Wertarbeit mbH") ](https://netzdirektion.de)

 [Feedback erwünscht - Ihre Meinung hilft uns, noch besser zu werden!](https://easy-feedback.de/umfrage/1883200/5FuM95 "Ihre Meinung hilft uns, noch besser zu werden!")