Bestellungen vom Marketplace importieren

Bestellungen gelangen ausschließlich durch Abfragen des Marketplaces ins System. Die Kanäle senden keine Benachrichtigungen; zum Kaufzeitpunkt kommt nichts „von selbst“ an.

Schritt für Schritt

Prüfen, wann dieser Kanal zuletzt Bestellungen abgerufen hat

1. Öffne Integrationen → Integrationen, Tab Meine Integrationen, und die Verbindung.
2. Im Kopfbereich steht auf einer Kachel Letzte Sync. mit Datum und Uhrzeit. Das ist die schnellste Prüfung.
3. Genauere Informationen findest du in der Phase Erweitert, im Abschnitt Synchronisierungsdaten (mit dem Hinweis Admin). Er enthält Letzter Bestellabruf und Letzte Angebotssynchronisierung, jeweils mit Datum.
4. Ein Strich neben Letzter Bestellabruf bedeutet, dass der Import für diese Verbindung noch nie gestartet wurde. Bei einer neuen Einrichtung ist das der häufigste Grund, warum nichts ankommt.

Das Importzeitfenster zurücksetzen

1. Im selben Abschnitt Synchronisierungsdaten gibt es bei jeder Zeile drei Schaltflächen: -1h, -1d und -7d.
2. Damit wird der Marker des letzten Abrufs zurückgesetzt. Der nächste Lauf blickt weiter zurück und holt Bestellungen, die aus dem vorherigen Zeitfenster gefallen sind.
3. Das ist ein Verwaltungstool — daher der Hinweis Admin. Klicke nicht darauf, um den Import zu „beschleunigen“: Es startet nichts sofort, sondern erweitert nur den Bereich für den nächsten Lauf.
4. Bewegt sich das Datum über mehrere Läufe nicht von selbst vorwärts, hilft ein Zurücksetzen nicht. Eine einzelne Bestellung hält den Marker fest, weil sie bei jedem Lauf nicht importiert werden kann. Suche sie im Modul Tickets und behebe das Problem, bei Bedarf mit dem NOXTI-Support. Danach rückt das Datum von selbst weiter. Bei Shoper hat ein größeres Zeitfenster seinen Preis: Für jede Bestellung wird der Shop einzeln nach den Positionen gefragt. Ein sehr großes Fenster kann daher das Zeitlimit des Laufs überschreiten. Bestellungen mit demselben Status und Betrag werden übersprungen, wenn sie schon vorliegen; der erste Lauf nach dem Zurücksetzen ist trotzdem aufwendig.
5. Beim Speichern wird ein 2FA-Code abgefragt.

Importverhalten für einen Kanal einstellen

1. Öffne in der Verbindungsansicht die Phase Bestellungen. Der Hinweis lautet: „Wie Bestellungen aus der Integration in WMS gelangen und wie ihre Status deinen zugeordnet werden.“
2. Die Einstellungen sind in Abschnitte gruppiert. Importregeln stehen unter Bestellungen vom Marketplace importieren („Regeln zum Bestellabruf, einschließlich nicht bezahlter Bestellungen“), der Umgang mit unbezahlten Bestellungen unter Unbezahlte Bestellungen. Bestätigung, Status, Rechnungen und Sendungsnummern findest du unter Marketplace-Einstellungen.
3. Die verfügbaren Felder unterscheiden sich je Kanal — das liegt an den Daten, nicht am Code der Ansicht. Suche einen Parameter über Einstellungen suchen… über der Phasenliste (Vertriebskanal – Integration, Verbindung und Einstellung).
4. Änderungen speicherst du über Änderungen speichern in der unteren Leiste. Dafür wird ein 2FA-Code abgefragt.

Prüfen, was angekommen ist

1. Öffne Synchronisierungskonsole — sehen, was passiert und wechsle zur Phase Bestellungen.
2. Die Tabelle hat die Spalten Kanalnummer, Systemnummer, Status, Status dort und Zeitpunkt. Status dort ist der rohe Wert vom Marketplace; Status ist dein zugeordneter Wert.
3. Eine separate Statustabelle zeigt Paare Im Kanal → Im System. Ein Auftrag mit einem dort fehlenden Status erhält still den Standardwert; siehe Marketplace-Bestellstatuswerte – Zuordnung in beide Richtungen.

Wenn Bestellungen nicht ankommen

Eine korrekt eingerichtete Verbindung genügt nicht — der Import muss regelmäßig gestartet werden. Ändern sich die Synchronisierungsdaten nicht und erscheinen keine neuen Bestellungen, prüfe Tickets und wende dich an den NOXTI-Support.

Was den Import steuert

Produkte automatisch hinzufügen — mit Bedacht

Ist diese Option aktiv, legt ein unbekanntes Produkt in der Bestellung automatisch einen neuen Produktdatensatz an. Das verhindert eine Blockade wegen einer fehlenden Artikelnummer, füllt aber den Katalog mit Dubletten, wenn die Zuordnung nicht überwacht wird. Aktiviere die Funktion bewusst und prüfe die neu angelegten Einträge.

Status beim Import

Marketplace-Status werden anhand der Zuordnungstabelle in deine Status übersetzt. Ein unbekannter Status fällt still auf default zurück; siehe Marketplace-Bestellstatuswerte – Zuordnung in beide Richtungen. Prüfe die Tabelle einige Tage nach dem Anschluss eines neuen Kanals erneut.

Bestellungen mit mehreren Paketen

Bei Versand in mehreren Paketen übermitteln manche Konnektoren an den Marketplace nur eine Sendungsnummer. Weitere Nummern gehen verloren, obwohl der Versand als abgeschlossen erfasst ist. Meldet ein Kunde aus dem Kanal, dass die zweite Sendung keine Nummer hat, liegt es daran.

Kaufland: Stornierungen und Sendungsnummern

• Wird die gesamte Bestellung bei Kaufland storniert, storniert der nächste Import sie auch im System, sofern cancelled in der Statustabelle dem Storno-Status zugeordnet ist. Als storniert gilt die Bestellung erst, wenn alle Positionen storniert sind. Ist ein Teil bereits versendet, bleibt dessen Versandstatus bestehen.
• Wird ein Teil der Bestellung storniert (zum Beispiel 1 von 2 Stück), sinkt die Positionsmenge und die Kommissionierwarteschlange wird entsprechend gekürzt. Hat die Kommissionierung oder Verpackung dieser Position bereits begonnen, wird die ganze Bestellung aus der Warteschlange genommen (bereits verpackte Ware bleibt verpackt) und die Ware kommt an den Sammelstandort zurück. Im nächsten Zyklus kehrt die Bestellung mit den neuen Mengen in die Warteschlange zurück. Eine Rückgabe, nachdem die Warteschlange bereits zugestellt wurde, löst das nicht aus. Hinweis: Der automatische Import aktualisiert Bestellpositionen standardmäßig nicht, damit manuell gelöschte Positionen nicht wieder auftauchen. Ausnahme: Hat der Marketplace seit dem letzten Import Positionen geändert (Produkt, Menge oder Preis), ruft der nächste Import sie selbst ab und entfernt den Überschuss. Dasselbe bewirken eine manuelle Aktualisierung mit Produkten oder der Abschnitt products unter orders_auto_refresh_sections.
• Positionsänderung nach dem Verpacken. Ändert der Marketplace Positionen einer bereits verpackten Bestellung, ändert das System die Positionen nicht. Es erstellt das Ticket „Marketplace changed the order lines after packing“. Vergleiche die Bestellung mit dem Marketplace und stoppe bei Bedarf den Versand. Bestellungen, die vor Einführung dieser Funktion importiert wurden, erhalten erst beim ersten Import nach der Bereitstellung einen Vergleichswert — an ihnen wird nichts geändert.
• Pakete mit verschiedenen Versanddienstleistern in einer Bestellung: Kaufland akzeptiert einen Versanddienstleister pro Position. Das System verweigert daher die Sendungsnummern und meldet einen Fehler; berücksichtigt werden nur Pakete, deren Nummer noch nicht gesendet wurde. Trage die Nummern im Kaufland-Panel ein.
• Wartet auf Kaufland keine Position mehr auf den Versand (sie wurde versendet, zugestellt oder storniert), wird die Nummer nicht gesendet und vom System nicht als übermittelt markiert. Beim manuellen Senden erscheint „übersprungen“. Eine Nummer für ein zusätzliches Paket zu einer bereits versendeten Bestellung musst du im Kaufland-Panel eintragen.
• Eine Stornierung aus dem System schlägt fehl, wenn bei irgendeiner Kaufland-Position der Identifikator fehlt. Storniere die übrigen Positionen im Kaufland-Panel.

OTTO: Stücke, Stornierungen und Bestellsumme

OTTO führt Bestellungen stückweise: Jedes Stück ist eine eigene Position mit eigenem Bearbeitungsstatus.

• Ein storniertes Stück (CANCELLED_BY_PARTNER oder CANCELLED_BY_MARKETPLACE) kommt mit Menge 0 und Status storniert ins System. Es zählt nicht zur Bestellsumme und seine Sendungsnummer wird nicht mitgesendet — OTTO würde sonst die gesamte Sendung ablehnen. Die Kommissionierwarteschlange wird wie bei Kaufland gekürzt: nach einer manuellen Aktualisierung mit Produkten oder wenn in orders_auto_refresh_sections der Verbindung products steht. Eine Position mit Menge 0 gelangt nicht in die Kommissionierwarteschlange und ändert den Auftragstyp nicht (ein aktives Stück ist weiterhin SINGLE).
• Eine vollständig stornierte Bestellung wird beim nächsten Import auch im System storniert, wenn CANCELLED_BY_PARTNER und CANCELLED_BY_MARKETPLACE dem Storno-Status zugeordnet sind. Ohne diesen Tabelleneintrag fallen sie still auf den Standardwert zurück. Eine Bestellung, die noch nicht im System existiert, wird nicht angelegt.
• Die Bestellsumme ergibt sich aus den nicht stornierten Stücken plus allen Liefergebühren. Früher war die Lieferung nicht enthalten. Deshalb stimmte die Positionssumme nicht mit der Zahlung überein und die Bestätigung blieb stehen.
• Eine Bestellung, bei der kein Stück einen lesbaren Preis hat, wird nicht mit Wert null importiert. Der Import stoppt bei dieser Bestellung und versucht es im nächsten Zyklus erneut. Der Grund steht im Worker-Protokoll.
• Bei einer manuellen Aktualisierung sucht das System eine OTTO-Bestellung über ihre OTTO-Bestellkennung (salesOrderId), nicht über die dem Kunden angezeigte Nummer.
• An OTTO wird eine Sendungsnummer pro Bestellung übermittelt. Die Nummer für das zweite Paket trägst du im OTTO-Panel ein.

Zahlungen

Bei manchen Kanälen kann das System den Zahlungseingang prüfen und die Bestellung automatisch in den nächsten Status versetzen. Bei den übrigen ist eine manuelle Bestätigung nötig.

Bestätigung ist nicht Zahlung

Eine Bestellbestätigung auf dem Marketplace bedeutet nicht, dass das Geld eingegangen ist. Das sind zwei getrennte Ereignisse. Bei einigen Kanälen treten sie entgegen der erwarteten Reihenfolge auf.

Bei Empik und Modivo wird der Kunde erst belastet, nachdem der Verkäufer die Bestellung angenommen hat. Also:

Bestellung geht ein  →  wir nehmen sie an  →  ~45 Sekunden  →  Marketplace belastet den Kunden
                                                                  ↑
                                                   ERST JETZT ist die Bestellung bezahlt

Deshalb bleibt eine frisch angenommene Bestellung aus diesen Kanälen kurz im Status für unbezahlte Bestellungen. Das ist korrekt. Beim nächsten Import nach der Abbuchung verlässt sie den Status von selbst (der Importzyklus dauert üblicherweise einige Minuten).

Bleibt die Bestellung länger als etwa zwölf Minuten dort, hat der Marketplace das Geld nicht eingezogen. Am häufigsten wurde die Karte abgelehnt. Lass die Bestellung warten und gib sie nicht manuell „frei, damit es weitergeht“ — sonst wird die Ware kostenlos versendet. Das ist tatsächlich passiert: Zwei Empik-Bestellungen wurden kommissioniert und verpackt, obwohl der Kunde nie bezahlt hatte.

Hinweis aus der Praxis: Dieselben Kanäle geben Käuferdaten — Telefonnummer und Adresse — ebenfalls erst nach der Belastung heraus. Für eine unbezahlte Bestellung lässt sich kein Versandetikett drucken. Beim Verpacken stoppt sie mit einem Fehler wegen fehlender Telefonnummer oder Postleitzahl. Das ist dieselbe ausbleibende Zahlung aus einer anderen Perspektive, kein eigener Fehler.

Empik, Kurierversand. Eine Bestellung an einen Abholpunkt (Empik-Filiale oder Paketautomat) enthält den Namen des Punkts schon vor der Annahme. Sie gelangt daher ins System und wird erst dann angenommen. Vor der Annahme hat eine Kuriersendung weder Abholpunkt noch Adresse — die Angaben für eine Bestellung fehlen. Ist auto_confirm aktiviert, nimmt das System sie deshalb bei Empik direkt beim Abruf an, noch bevor sie ins System gelangt. Empik belastet den Kunden und gibt die Adresse frei; die Bestellung kommt beim nächsten Import an. Ist auto_confirm ausgeschaltet, musst du sie im Empik-Panel manuell annehmen. Bis dahin erscheint sie nicht im System und blockiert die übrigen Importe nicht.

Eine bei Empik abgelehnte Bestellung (manuell oder nach Ablauf der Annahmefrist), die nicht im System ist, wird übersprungen — es gibt nichts zu übermitteln. Eine abgelehnte oder stornierte Bestellung, die bereits im System ist, kommt weiterhin an und wird im System storniert, wenn REFUSED/CANCELED in der Statustabelle dem Storno-Status zugeordnet ist — wie bei Modivo. Hat die Kommissionierung oder Verpackung bereits begonnen, storniert das System sie nicht selbst, sondern erstellt ein Ticket. Der Versand einer Bestellung, die Empik nicht angenommen oder storniert hat, schlägt mit einem Fehler fehl, statt still als „bereits versendet“ zu gelten. Das System markiert diese Bestellung nicht als bestätigt, selbst wenn es später versucht, sie anzunehmen. Workflows, die durch die Bestätigung ausgelöst werden (Kurierauftrag, ERP-Dokument), starten nicht, wenn Empik die Bestellung nicht angenommen hat.

Manueller Kanal

Der Kanal Manuell fragt keine Daten ab. Er dient zum Erfassen von Bestellungen außerhalb der Integrationen, damit sie den normalen Lagerablauf durchlaufen.