Ein Produkt veröffentlichen

Der ganze Ablauf besteht aus zwei Schreibvorgängen und einer Wartezeit.

1. Das Produkt anlegen

curl -X POST https://api.nembol.com/rest/v1/products \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-VDJ-001" \
  -d '{
    "title": "Vintage denim jacket",
    "description": "<p>Classic 90s denim jacket.</p>",
    "brand": "Acme",
    "price": "49.90", "quantity": 3, "sku": "VDJ-M-001",
    "images": [{"url": "https://your-cdn.com/jacket.jpg"}]
  }'

Die Antwort ist das Produkt, synchron. Merk dir die id und die Bild-IDs.

2. Veröffentlichen

curl -X POST https://api.nembol.com/rest/v1/listings \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: publish-VDJ-001-shopify" \
  -d '{"product_id": "prod_…", "channel_account_id": "chac_…"}'

202 mit status: "ongoing". Die Veröffentlichung läuft über die Kanal-Worker von Nembol. Die channel_account_id erhältst du über GET /channel_accounts.

3. Erfahren, wann es live ist

Abonniere den Webhook listing.status_changed (am besten) oder frage GET /listings/{id} ab, bis status gleich listed ist. Du erhältst id_on_channel und url_on_channel. Auf einem funktionierenden Kanal dauert das Sekunden, nicht Minuten.

Lehnt der Kanal es ab, erhältst du status: "error" und die eigene Meldung des Kanals in issues[]. Siehe Fehler behandeln.

Stolperfallen

• Zuerst die Bilder. Kanäle lehnen Angebote ohne Bilder ab, daher schlägt eine Veröffentlichung ohne Bilder sofort mit photo_required_for_channel fehl.
• Bild-URLs müssen öffentlich sein. Nembol lädt jede url einmal herunter und speichert eine eigene Kopie. Sind deine Bilder nicht aus dem Internet erreichbar (ein lokales ERP, ein privater Bucket), sende sie stattdessen als {"base64": "…"} (max. 10 MB pro Bild). Lass url auf die Bilddatei selbst zeigen, nicht auf eine Seite, die sie anzeigt: Nembol prüft die Bytes. Eine URL, die eine HTML-Seite liefert, erhält 422 unsupported_file_type, und eine, die sich nicht herunterladen lässt, 422 image_unreachable, jeweils mit dem Bild in param. In beiden Fällen wird nichts angelegt.
• Alt-Text. Gib jedem Bild ein alt (Barrierefreiheit, SEO), bis zu 512 Zeichen. Es erreicht Shopify, WooCommerce, Etsy, Wix, Squarespace und die Storefront, wenn die Bilder übertragen werden: beim Veröffentlichen und bei einer Änderung, wenn der Schalter für Push-Updates des Kontos an ist. Etsy behält die ersten 500 Zeichen, Squarespace die ersten 200. Ein Import von diesen Kanälen übernimmt deren Alt-Text. eBay, Amazon, TikTok Shop, Google Merchant Center und Meta haben keinen Alt-Text für Bilder und erhalten ihn daher nicht. Ändere ihn später, indem du das Bild über seine id mit einem neuen alt zurücksendest ("" löscht ihn); Verkäufer können ihn auch im Dashboard bearbeiten (Tab Medien, unter jedem Bild).
• Varianten müssen eine vollständige Matrix bilden. Mit options (z. B. Farbe × Größe) braucht jede Kombination eine Variante. Kanäle erzeugen die ganze Matrix, daher wird ein lückenhafter Satz mit 422 abgelehnt, statt fehlerhafte Varianten zu veröffentlichen.
• Währungen werden nicht umgerechnet. Preise sind in der Währung des Shops (GET /store → currency), und Nembol veröffentlicht die Zahl unverändert: 19.90 in einem EUR-Shop sind 19.90 USD in einem US-Shopify-Shop. Jedes Kanalkonto zeigt die Währung, in der es verkauft (currency), und, wenn sie von der des Shops abweicht, eine Warnung currency_mismatch (am Konto in warnings, an seinen Angeboten in issues). Behebe das mit einer Preisregel für dieses Konto (PATCH /channel_accounts/{id} mit pricing) oder verbinde einen Shop in der Währung des Shops.
• Der Kanalpreis kann von deinem abweichen. Verkäufer können in Nembol Preisregeln pro Kanal konfigurieren (prozentuale oder feste Anpassung). Behandle einen abweichenden Preis auf dem Kanal also nicht als Bug.
• WooCommerce veröffentlicht eventuell als Entwurf. Hat der Verkäufer in seinen Nembol-Kanaleinstellungen Produktstatus: Entwurf gesetzt, ist das Angebot listed, aber die Produkt-URL ist erst öffentlich, wenn er es in WooCommerce veröffentlicht.
• Veröffentlichen ist idempotent pro (product_id, channel_account_id): Ein erneuter POST liefert das vorhandene Angebot. Ist beim Angebot ein Fehler aufgetreten, wiederholt ein erneuter POST die Veröffentlichung.

Nach dem Veröffentlichen

• Preis- und Textänderungen: PATCH /products/{id}. Sie erreichen den Kanal, wenn der Schalter sync.product_edits des Kontos an ist (er startet ausgeschaltet): siehe Ein Produkt bearbeiten.
• Bestand aus deinem System: POST /inventory/batch über die SKU, siehe Bestand und Preise in großen Mengen synchronisieren.
• Verkäufe und Versand: Webhooks order.created, dann POST /orders/{id}/fulfillment, siehe Bestellungen abwickeln.

Zuletzt aktualisiert am 20. Oktober 2026