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 https://www.punchcommerce.de/api/v1/products erreichbar. Die Authentifizierung erfolgt über das Bearer-Token, welches in Ihrem PunchCommerce-Kunden angezeigt wird.
Produkte abrufen
GET https://www.punchcommerce.de/api/v1/products
Produkt abrufen
GET https://www.punchcommerce.de/api/v1/products/{ordernumber}
{
"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 https://www.punchcommerce.de/api/v1/products
{
"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 https://www.punchcommerce.de/api/v1/products/{ordernumber}
{
"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 https://www.punchcommerce.de/api/v1/products
Ein Produkt löschen
DELETE https://www.punchcommerce.de/api/v1/products/{ordernumber}
Composer Bundle
Die PunchCommerce-Client-Library als composer-Bundle finden Sie in unserem Git-Repository unter
https://stash.netzdirektion.de/scm/pun/punchcommerce-client-php.git
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
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
