Regeln und Limits

Alles auf dieser Seite wurde durchgängig auf echten Kanälen geprüft. Wird eine Regel verletzt, antwortet die API mit 422 validation_failed (oder dem angegebenen Code) und einer Meldung, die das Feld nennt. Nichts wird stillschweigend geändert.

Produkte und Varianten

• Eine SKU pro Variante. Bestand, Bestellungen und POST /inventory/batch ordnen Varianten über die SKU zu, daher können sich zwei Varianten eines Produkts keine SKU teilen (422, Two variants share the SKU …).
• Jede Optionskombination. Ein Produkt mit Größe S/M und Farbe Rot/Blau hat genau 4 Varianten. Um eine Farbe hinzuzufügen, füge sie in jeder Größe hinzu; um eine Größe zu streichen, streiche sie für jede Farbe. Kanäle bauen das vollständige Raster auf, eine fehlende Kombination würde dort also als Phantomvariante erscheinen.
• Höchstens 3 Optionen und 100 Varianten pro Produkt.
• Preise haben höchstens 2 Dezimalstellen; Mengen sind ganze Zahlen ≥ 0.
• Bilder: Ein Produkt braucht mindestens ein Bild, um veröffentlicht zu werden (photo_required_for_channel). Bis zu 20 pro Produkt.
• Das Löschen eines Produkts, das noch auf einem Kanal ist, wird abgelehnt (422 product_still_listed), auch wenn sein Angebot im Status error, aber dort noch live ist. Entferne es zuerst vom Kanal (DELETE /listings/{id}).

Texte pro Kanal

• PATCH /listings/{id} mit overrides.title / overrides.description setzt den Text nur für diesen Kanal; null kehrt zum Text des Produkts zurück.
• Titel, die länger sind, als der Kanal erlaubt, werden sofort abgelehnt: Shopify 255, Etsy 140, eBay 80 Zeichen.
• Ein Produkt auf einem einzigen Kanal: Bearbeitest du Titel oder Beschreibung des Produkts, ändert sich auch der des Kanals, aber nur das Feld, das du bearbeitet hast (eine Änderung der Beschreibung behält einen für den Kanal gesetzten Titel bei).
• Ein als Leitkanal festgelegter Kanal (seine Änderungen fließen in Nembol) überschreibt die Texte des Produkts und die jedes Kanals.
• Beschreibungen sind HTML und erreichen die Kanäle als HTML.

Bestellungen

• Eine Bestellung pro Kanalbestellung: Eine Bestellung mit mehreren Positionen kommt als eine Bestellung zurück, mit jeder Position in lines und dem vollen total; order.created wird einmal pro Bestellung ausgelöst.
• Neue Bestellungen kommen innerhalb von Sekunden per Webhook an, wo der Kanal sie sendet, sonst beim nächsten Abruf. Statusänderungen auf dem Kanal (storniert, erstattet, anderswo versendet) kommen innerhalb von 10 Minuten an.
• source_status ist der eigene Status-String des Kanals, wie zuletzt gelesen.

Versand (POST /orders/{id}/fulfillment)

• mark_shipped ohne Sendungsverfolgung aktualisiert nur Nembol: Der Marktplatz wird nicht informiert.
• Mit einer Sendungsnummer wird der Marktplatz einmal pro Bestellung benachrichtigt. Eine später gesendete Sendungsverfolgung (nach mark_shipped) wird dann gemeldet. Sobald der Marktplatz eine Sendungsverfolgung hat, wird eine andere Nummer nur in Nembol gespeichert, und die Antwort lautet channel_notification.error: channel_already_notified. Korrigiere sie direkt auf dem Marktplatz.
• tracking.number ≤ 64, carrier ≤ 64, url ≤ 512 Zeichen: Längeres wird abgelehnt, nie gekürzt.
• Eine stornierte oder erstattete Bestellung kann nicht als versendet markiert werden (order_not_fulfillable).

Kanalverbindungen

• Ein Verbindungslink funktioniert einmal und eine Stunde lang.

• Amazon: params.country wählt die Region; params.marketplace muss ein Marktplatz dieser Region sein.

• OAuth-Kanäle (eBay, Etsy, Shopify, WooCommerce, TikTok Shop, Temu, Amazon, Google Merchant Center, Facebook Catalog, Square, Squarespace, Faire, Wix, Facebook, Pinterest, Tumblr) werden über einen Link verbunden.

• Kaufland, OnBuy, PrestaShop und Subito werden mit Zugangsdaten in params verbunden (kein Link).

• Das Veröffentlichen auf eBay erfordert Geschäftsrichtlinien (Business Policies): Ist das Konto nicht angemeldet, POST /channel_accounts/{id}/enable_business_policies (mit Bestätigung).

• Ein neues Kanalkonto erhält beim Verbinden die Standardeinstellungen des Kanals, über die API genauso wie im Dashboard.

Zeiten und Limits

• Rate-Limits und Idempotency-Keys gelten pro Shop (pro Unternehmen bei Partnern). Siehe Rate-Limits.
• Ein Angebot wird normalerweise innerhalb von Sekunden listed; Marktplätze, die Produkte prüfen (Amazon, TikTok Shop), können länger brauchen.

Zuletzt aktualisiert am 20. Oktober 2026