Wer Bestellungen aus einer externen Warenwirtschaft oder einem ERP nach Shopify importiert, kennt das Problem: Ein Kunde bestellt drei Artikel, die in zwei Paketen rausgehen – aber die orderCreate-Mutation ließ bisher nur eine Tracking-Nummer pro Fulfillment zu. Die zweite Sendungsnummer musste in einem separaten Schritt per Fulfillment-Update nachgeschoben werden. Damit ist jetzt Schluss.
Shopify hat das Feld trackingNumbers in OrderCreateFulfillmentInput ergänzt. Entwickler können beim Anlegen der Bestellung sämtliche Sendungsnummern eines Fulfillments in einem einzigen API-Call übergeben. Der Umweg über ein nachträgliches Update der Fulfillment-Ressource entfällt komplett.
Was ändert sich konkret in der Admin-API?
Die Neuerung betrifft die GraphQL Admin API von Shopify und damit alle Shops, die Bestellungen programmatisch anlegen – typischerweise Händler mit eigener Middleware, ERP-Anbindung oder einem OMS wie Billbee, plentymarkets oder JTL-Wawi. Bisher hieß der Workflow: Order anlegen, Fulfillment-ID aus der Antwort lesen, dann mit fulfillmentCreate oder einem Update die restlichen Tracking-Nummern hinterherschicken. Bei Mehrpaket-Sendungen – im Möbelhandel, bei Ersatzteilen oder Sperrgut der Normalfall – bedeutete das zwei bis drei zusätzliche Requests pro Bestellung.
Mit trackingNumbers nimmt das Fulfillment-Input-Objekt jetzt ein Array von Sendungsnummern entgegen. Alle Pakete einer Bestellung sind damit von Anfang an vollständig im System hinterlegt – inklusive der Sendungsverfolgung, die Shopify den Kunden in der Versandbestätigung und im Bestellstatus anzeigt.
Warum ist das mehr als ein Komfort-Feature?
Die Antwort ist kurz: weniger API-Calls, weniger Fehlerquellen, schnellere Kundenkommunikation. Ausführlicher: Jeder zusätzliche Request kostet nicht nur Rate-Limit-Budget – Shopify begrenzt die Admin-API über ein Leaky-Bucket-Verfahren –, sondern erzeugt auch ein Zeitfenster, in dem die Bestellung unvollständig im System steht. Läuft zwischen Order-Import und Tracking-Update die automatische Versandmail raus, erhält der Kunde eine Benachrichtigung ohne vollständige Sendungsverfolgung. Genau solche Mails produzieren Support-Tickets.
Dazu kommt die Fehleranfälligkeit verteilter Schritte: Schlägt der zweite Call fehl – Timeout, Rate-Limit, Netzwerkproblem –, bleibt die zweite Tracking-Nummer im Nirvana, wenn die eigene Integration kein sauberes Retry-Handling mitbringt. Ein atomarer Call eliminiert diese Klasse von Problemen vollständig.
Was sollten Shopbetreiber jetzt tun?
Händler, die eine Standardanbindung über Apps wie Billbee, plentymarkets oder Xentral nutzen, müssen nichts unternehmen – hier liegt die Umsetzung beim jeweiligen Anbieter. Ein Blick ins Changelog oder eine kurze Nachfrage beim Support schadet trotzdem nicht, denn erst wenn der Connector das neue Feld nutzt, kommt der Vorteil im Shop an.
Anders sieht es bei Eigenentwicklungen aus. Wer eine eigene Import-Integration betreibt, sollte den bestehenden Zweischritt – Order anlegen, Fulfillment patchen – auf den neuen Einzelschritt umstellen. Der Umbau ist überschaubar: Das bisherige Feld für eine einzelne Sendungsnummer wird durch das Array ersetzt, die Logik für den Folge-Request fliegt raus. Shopify stellt neue Felder der Admin-API versioniert bereit; welche API-Version die eigene App ansteuert, lässt sich in den App-Einstellungen prüfen.
Für Händler ab einer Million Euro Jahresumsatz, bei denen täglich dreistellige Bestellzahlen über die Schnittstelle laufen, ist das kein Kosmetik-Patch. Weniger Requests bedeuten stabilere Imports in Lastspitzen – etwa im Q4-Geschäft, wenn Rate-Limits real werden. Und vollständige Tracking-Daten ab Sekunde eins sind die Voraussetzung dafür, dass After-Sales-Kommunikation und WISMO-Anfragen („Where is my order?“) nicht zum Kostenfaktor werden.