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 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

• Wohnen
  • Küche
    • Elektrogeräte