Wer Bestellungen aus einem ERP, einem Warenwirtschaftssystem oder einem externen Shop über die Admin-API nach Shopify importiert, kennt das Problem: Passt eine Bestellung nicht in ein Paket, fehlte bisher eine saubere Möglichkeit, alle Sendungsnummern direkt mitzuliefern. Die orderCreate-Mutation akzeptierte pro Fulfillment nur eine Tracking-Nummer. Für jede weitere musste ein zweiter API-Call hinterhergeschoben werden, um das Fulfillment nachträglich zu aktualisieren.
Dieser Umweg ist jetzt überflüssig. Shopify hat das Feld trackingNumbers zu OrderCreateFulfillmentInput hinzugefügt. Damit lassen sich beim Anlegen der Bestellung mehrere Tracking-Nummern auf einmal an ein Fulfillment hängen – direkt im selben Request, in dem die Order erzeugt wird.
Was genau hat sich an der orderCreate-Mutation geändert?
Die Antwort ist technisch unspektakulär, im Betrieb aber spürbar: Statt nur eines einzelnen Tracking-Werts nimmt das Fulfillment-Input-Objekt nun eine Liste von Sendungsnummern entgegen. Wer eine Bestellung importiert, die in drei Paketen rausgeht, übergibt alle drei Nummern beim Erstellen. Der bisherige zweistufige Prozess – Order anlegen, Fulfillment per fulfillmentUpdate oder entsprechendem Call nachbearbeiten – entfällt.
Für Integrationen zwischen Warenwirtschaft und Shopify bedeutet das weniger API-Aufrufe pro Mehrpaket-Bestellung, weniger Fehlerquellen und vor allem: korrekte Sendungsverfolgung ab dem ersten Moment. Bisher hing die Datenqualität davon ab, ob der Folge-Call zuverlässig durchlief. Lief er nicht, stand in der Bestellung nur eine Nummer – und der Kunde bekam für Teillieferungen keine oder falsche Tracking-Informationen.
orderCreate jetzt mit allen Tracking-Nummern in einem einzigen API-Call importieren – der nachträgliche Update-Schritt entfällt.Warum betrifft das vor allem Händler mit ERP-Anbindung?
Shopbetreiber, die ihre Bestellungen direkt in Shopify anlegen und aus dem Shop-Backend heraus versenden, merken von der Änderung wenig. Relevant wird sie dort, wo Shopify als Verkaufs- und Fulfillment-Drehscheibe dient, die Orders aber aus einem Drittsystem stammen: JTL-Wawi, plentymarkets, Xentral, Billbee oder selbstgebaute Middleware. Gerade diese Setups produzieren regelmäßig Mehrpaket-Sendungen – Möbelhändler, Ersatzteil-Shops, B2B-Händler mit Sperrgut-Anteil.
Ein Beispiel aus dem Alltag: Ein Händler für Gartenmöbel importiert täglich Bestellungen aus seiner Warenwirtschaft nach Shopify, damit Kunden dort ihren Status sehen und die automatisierten Versandmails von Shopify greifen. Ein Set aus Tisch und vier Stühlen geht in drei Paketen raus. Bisher musste seine Middleware nach dem Order-Import das Fulfillment erneut anfassen, um Nummer zwei und drei nachzutragen. Fiel dieser Job aus – etwa bei API-Limits in der Orderflut nach einer Kampagne –, fehlten die Daten. Mit trackingNumbers wandert alles in den Initial-Call.
Was Händler und Entwickler jetzt prüfen sollten
Wer eine eigene Integration oder ein Connector-Plugin für den Order-Import betreibt, sollte die Mutation auf das neue Feld prüfen und die Logik für Folge-Updates bei Mehrpaket-Sendungen entsprechend vereinfachen. Das spart Request-Volumen – relevant, weil die Admin-API nach dem Leaky-Bucket-Verfahren gedrosselt wird und jeder eingesparte Call die Rate-Limit-Reserve erhöht.
Händler ohne eigene Entwicklung, die über fertige Connectoren arbeiten, müssen nichts aktiv tun – profitieren aber, sobald der jeweilige Anbieter das Feld nutzt. Es lohnt sich, beim Connector-Anbieter nachzufragen, ob der Import bereits auf trackingNumbers umgestellt ist, insbesondere wenn in der Vergangenheit Teillieferungen ohne vollständiges Tracking im Shop auftauchten.
Ein Feld mehr im Input-Objekt, ein API-Call weniger pro Sendung – und Kunden sehen ab Import alle Paketnummern ihrer Bestellung.
Shopify arbeitet die Admin-API seit Monaten konsequent in Richtung vollständiger Import-Pfade ab: Von Metafeldern über Steuerzeilen bis zu Fulfillment-Details soll alles beim Anlegen der Order mitgegeben werden können. Die Tracking-Erweiterung ist ein kleiner, aber typischer Schritt in dieser Richtung. Wer komplexe Import-Strecken betreibt, sollte den Changelog der Admin-API ohnehin auf dem Schirm haben – die nächste Vereinfachung dürfte nicht lange auf sich warten lassen.