Shop & WarenwirtschaftRedaktion Die Netzhandwerker · 19. November 2026 · 19 Min. Lesezeit

Shopify mit Warenwirtschaft verbinden: Welche Felder zusammengehören und wo der Abgleich scheitert

Lagermitarbeiter mit Tablet zwischen zwei Regalreihen mit Versandkartons

Eine Anbindung von Shopify an die Warenwirtschaft gelingt, wenn drei Dinge vorab feststehen: welches Shopify-Objekt welchem Wawi-Feld entspricht, welches System je Datenbereich führt und über welchen Schlüssel beide Seiten einen Datensatz wiederfinden. Die SKU der Variante eignet sich für die Erstzuordnung nur, wenn sie auf beiden Seiten vorhanden und eindeutig ist. Für den laufenden Abgleich speichern Sie die Shopify-IDs. Typische Fehlerquellen sind überschriebene Bestände, doppelt verarbeitete Bestellungen, verpasste Webhooks und unklare Schreibzuständigkeiten. Die Tabellen und die Checkliste unten bündeln diese Punkte.

1.000 Punktemaximale Kosten einer einzelnen GraphQL-Abfrage, unabhängig vom Plan
5 SekundenGesamt-Timeout, innerhalb dessen Ihr Webhook-Empfänger antworten muss
8 in 4 Std.bis zu acht Wiederholungen von Shopify innerhalb von vier Stunden bei ausbleibender oder fehlerhafter Antwort
2.048Varianten je Produkt als Standardgrenze eines Shops

Stand 18.11.2026. Grundlage: Shopify-Entwicklerdokumentation (Admin-GraphQL-API-Referenz, Bestandsverwaltung, Webhooks, Rate Limits), am 18.11.2026 abgerufen. Die genannten GraphQL-Felder und Mutationen beziehen sich auf API-Version 2026-10, sofern keine andere Version genannt ist.

Erst klären: Brauchen Sie überhaupt eine eigene Anbindung?

Bietet Ihre Warenwirtschaft einen fertigen Shopify-Anschluss und decken Ihre Fälle sich mit dessen Umfang, ist ein Eigenbau meist nicht nötig. Ob das zutrifft, lässt sich anhand der Zuordnungstabelle weiter unten prüfen: Geht der Anschluss mit mehreren Lagerorten, Varianten, Teilerstattungen und Ihrer Preislogik um, wie Sie es brauchen? Fehlt einer dieser Punkte, lohnt sich eine individuelle Schnittstelle.

Abnahmeprüfung für einen Standardanschluss: Wählen Sie den Anschluss aus, konfigurieren Sie die Datenrichtungen und ordnen Sie Varianten und Lagerorte zu. Bevor Sie produktiv schalten, lösen Sie im Testshop über den Checkout einen Auftrag über drei Stück einer bestandsgeführten, am Teststandort aktiven Variante aus. Sorgen Sie für genügend Bestand und eine Zuordnung aller drei Einheiten zum selben Standort. Prüfen Sie anschließend folgende Werte (angenommene Zahlen):

  1. Artikelzuordnung: Die Position erscheint in der Wawi beim erwarteten Artikel, und LineItem.id sowie Variant-ID sind gespeichert. Landet die Position in der Fehlerliste oder bei einem falschen Artikel, ist die Zuordnung nicht abgenommen.
  2. Lagerort: Prüfen Sie nach abgeschlossenem Routing je Versandauftrag (FulfillmentOrder) den zugewiesenen Standort (assignedLocation.location.id) und die zugewiesene Stückzahl. Die drei Testeinheiten müssen am erwarteten Wawi-Lager landen.
  3. Bestandsänderung: Am Standort sinkt available um 3 und committed steigt um 3, während on_hand unverändert bleibt. Sobald die Auslieferung in Shopify erfasst ist, sinken committed und on_hand um je 3 (siehe Rechenbeispiel weiter unten).
  4. Auftragsimport: In der Wawi liegt genau ein Kundenauftrag zur Shopify-Bestellung. Bestellnummer, Menge, Einzelpreise, Rabatte, Versandkosten und Gesamtsumme entsprechen den Werten in Shopify.
  5. Teilerstattung: Erstatten Sie eine der drei Einheiten. In Shopify bleibt quantity bei 3, currentQuantity ist 2. Prüfen Sie in der Warenwirtschaft, ob die erstattete Einheit eindeutig dem ursprünglichen Auftrag zugeordnet ist und der Erstattungsbetrag stimmt. Je nach Belegablauf kann die ursprüngliche Position mit drei Einheiten bestehen bleiben und die Korrektur auf einem eigenen Beleg stehen.

Wenn Sie den Testauftrag per orderCreate statt über den Checkout erzeugen, setzen Sie das gewünschte Bestandsverhalten ausdrücklich. Der Standardwert BYPASS ist für diesen Test ungeeignet, weil er den Bestand nicht beansprucht.

Das Shopify-Datenmodell: eine Kette aus fünf Objekten

Shopify trennt, was viele Warenwirtschaften in einem Artikelsatz führen. Die Kette lautet: Ein Shopify-Produkt (Product) hat eine oder mehrere Varianten (ProductVariant). Jede Variante hat genau einen InventoryItem (Bestandsartikel). Dessen Menge liegt je Standort in einem InventoryLevel, und der Standort selbst ist eine Location.

  • Kunden bestellen Varianten, nicht Produkte. Der Wawi-Artikel entspricht deshalb in der Regel der Variante, nicht dem Produkt.
  • Die SKU steht an der Variante und am Bestandsartikel. Die Dokumentation weist darauf hin, dass sie Groß- und Kleinschreibung unterscheidet.
  • Bestand ist ein Paar aus Bestandsartikel und Standort. Ohne Standort-Zuordnung lässt sich keine Menge schreiben.
  • Ein Shop darf standardmäßig bis zu 2.048 Varianten je Produkt haben. Wawi-Artikelfamilien mit sehr vielen Ausprägungen können diese Grenze erreichen.

Wie sich Varianten- und Set-Artikel ungünstig auswirken, beschreibt Bestandsabgleich bei Sets und Varianten.

Zuordnungstabelle: Shopify-Feld, Wawi-Feld, Richtung, Schlüssel, Stolperstein

Die Tabelle fasst zusammen, was in der Doku verteilt steht. Die Spalte „Wawi-Feld“ nennt die übliche Entsprechung und kann bei Ihrem System anders heißen. „Führt“ ist eine Empfehlung, keine Vorgabe von Shopify.

ShopifyTypisches Wawi-FeldFührtSchlüsselStolperstein
Product (Titel, Beschreibung)Artikelstamm, Bezeichnung, LangtextWawi oder ProduktdatenpflegeProduct-ID (GID) in der Wawi speichernTypischer Fall: Eine Wawi-Artikelfamilie wird in Shopify ein Produkt mit mehreren Varianten. Legen Sie die Gruppierung für Shopify fest und speichern Sie die Zuordnung der Wawi-Artikel zu den Shopify-Varianten.
ProductVariant.skuArtikelnummerWawiSKU für die Erstzuordnung, Variant-ID für den laufenden AbgleichDie SKU taugt für die Erstzuordnung nur, wenn sie auf beiden Seiten vorhanden und eindeutig ist. Shopify kann mehrere Bestandsartikel mit derselben SKU führen (Feld duplicateSkuCount). Mehrdeutige Treffer geben Sie zur Klärung aus. Groß-/Kleinschreibung zählt. Führende Nullen oder Leerzeichen gehen bei Tabellen-Exporten leicht verloren.
ProductVariant.barcodesEAN/GTINWawiBarcode als Zweitschlüssel, ebenfalls auf Eindeutigkeit prüfenDas ältere Feld barcode ist als veraltet markiert. Seit API-Version 2026-10 liefert ProductVariant.barcodes eine Connection für bis zu 20 Barcodes. Beim Schreiben ersetzt die Eingabeliste barcodes den gesamten bisherigen Satz.
ProductVariant.price, compareAtPriceVerkaufspreis, StreichpreisWawi, Aktionen ggf. ShopVariant-IDDer Preis gilt in der Standardwährung des Shops. Staffel- oder Kundengruppenpreise der Wawi passen nicht in dieses eine Feld. Netto/Brutto vorab festlegen.
InventoryItem.tracked, unitCostLagerführung ja/nein, EinstandspreisWawiInventoryItem-IDPrüfen Sie, ob tracked den Wert true hat. Bei false verfolgt Shopify die Bestandsmengen des Artikels nicht. Vor dem Schreiben prüfen.
InventoryLevel, Menge availableVerkaufbarer Bestand je StandortWawi, mit PrüfwertInventoryItem-ID und Location-IDAus on_hand ergibt sich available nach Abzug von committed, reserved, damaged, safety_stock und quality_control. Beschädigte Ware, Sicherheitsbestand und Ware in der Qualitätskontrolle zählen zum physischen Bestand, stehen aber nicht zum Verkauf. Shop-Verkäufe verändern available laufend. Ein blindes Überschreiben kann diese Verkäufe wieder aus dem Bestand löschen. Ein aktiver Standort garantiert keinen aktiven Bestandsdatensatz je Artikel: Seit 2026-04 kann eine Mengenmutation einen inaktiven InventoryLevel mit gespeicherter Menge erzeugen. Der Schreibaufruf gelingt dann, der Artikel ist dort aber weder verkäuflich noch von dort auslieferbar. Prüfen Sie deshalb InventoryLevel.isActive je Bestandsartikel.
InventoryLevel, Menge on_handPhysischer LagerbestandWawiwie obenon_hand ist die Summe aus available, committed, reserved, damaged, safety_stock und quality_control.
InventoryLevel, Menge committedVon Shopify gebundene MengeShopifywie obenÜber die Admin-API nicht änderbar. Änderungen daran lösen keinen Webhook aus. Zu committed zählen neben offenen Bestellungen auch Entwurfsbestellungen mit reserviertem Bestand sowie als versandbereit markierte Umlagerungen oder Sendungen. Die Menge entspricht daher nicht allein den Kundenaufträgen.
LocationLager, LagerortEinmalige ZuordnungLocation-IDPflegen Sie eine feste Liste Wawi-Lager gleich Location-ID. Prüfen Sie isActive, fulfillsOnlineOrders und isFulfillmentService.
OrderKundenauftragShop (entsteht dort)Order-ID, daneben die Bestellnummer nameStandardmäßig sind nur Bestellungen der letzten 60 Tage abrufbar. Für ältere gibt es den Scope read_all_orders, den Sie zusätzlich zu read_orders oder write_orders deklarieren. Ob dafür eine Shopify-Freigabe nötig ist, hängt vom App-Typ ab (siehe FAQ).
LineItemAuftragspositionShopLineItem.id für die Position, Variant-ID für die ArtikelzuordnungSKU und Variant-ID identifizieren einen Artikel, aber keine einzelne Auftragsposition. variant kann leer sein. Dann nutzen Sie eine bereits gespeicherte Zuordnung oder eine eindeutig zuordenbare SKU und geben ungelöste Fälle zur Klärung aus. quantity enthält erstattete und entfernte Einheiten, currentQuantity nicht.
LineItem.originalUnitPriceSet, discountAllocationsUrsprünglicher Einzelpreis, RabattanteileShop–Rabattanteile können auch erstattete oder entfernte Einheiten enthalten. Bewahren Sie sie beim Ursprungsbeleg auf und gleichen Sie Erstattungen getrennt ab. Für den aktuellen Positionswert nach allen Rabatten und vor Steuern verwenden Sie priceAfterAllDiscountsBeforeTaxesSet.
FulfillmentOrder, FulfillmentLieferschein, Sendung, TrackingWawi meldet zurückFulfillmentOrder.id für den Versandauftrag, Fulfillment.id für die einzelne Sendung mit TrackingEine Bestellung kann mehrere Fulfillment Orders haben, auch mehrere am selben Standort. Shopify datiert die Abkündigung des alten Ablaufs zur Versandabwicklung über Order und Fulfillment auf API-Version 2022-07. Bis 2023-07 sollten alle Apps den neuen Ablauf mit FulfillmentOrder nutzen.

Entscheidungshilfe: Wer ist Master für Bestand, Preis, Artikelstamm und Bestellung?

Legen Sie je Datenbereich ein führendes System fest und je Vorgang, welche Änderungen erlaubt sind. Shopify-Verkäufe sollen regulär auf den Bestand wirken. Vermeiden Sie konkurrierende absolute Abgleiche aus mehreren Systemen, denn sie erzeugen Änderungen, die sich gegenseitig überholen. Die folgende Übersicht ist eine Empfehlung für den üblichen Fall.

DatenbereichMasterBegründungWann Sie abweichen
Artikelstamm (SKU, EAN, Gruppierung)WawiDort entsteht die Artikelnummer, auf die Einkauf, Lager und Buchhaltung zugreifen.Ihre Texte und Bilder pflegen Sie im Shop oder in einer Produktdatenpflege. Dann bleibt dort nur der Stamm aus der Wawi.
Bestand physisch (on_hand)WawiWareneingang, Inventur und Umlagerung finden dort statt.Verkaufen Sie auf mehreren Kanälen, braucht es eine zentrale Stelle, die Kanalverkäufe zusammenführt.
Gebundene Menge (committed)ShopifyShopify verwaltet diese Menge selbst, die API erlaubt keine Änderung.Keine. Sie lesen den Wert. Die Kundenauftragsreservierung gleichen Sie anhand der Auftragsdaten ab und berücksichtigen andere Bindungsgründe, etwa Entwurfsbestellungen oder Umlagerungen, getrennt.
PreisWawiEine Preisquelle verhindert, dass Shop und Rechnung auseinanderlaufen.Reine Shop-Aktionen: Dann führt der Shop für einen begrenzten Zeitraum, und die Wawi darf diese Artikel nicht überschreiben.
BestellungShop, für im Shopify-Shop entstandene BestellungenDie Wawi übernimmt sie als Kundenauftrag.Für in der Wawi erfasste Aufträge, etwa Telefon- oder Außendienstaufträge, legen Sie separat fest, ob sie dort bleiben oder nach Shopify übertragen werden.
Versandstatus, TrackingWawiDort wird gepackt und versendet. Der Shop erfährt es per Rückmeldung.Versendet ein externer Lagerdienstleister, kann dessen Standort in Shopify als Fulfillment-Service geführt werden.
Warum der Prüfwert beim Bestand zählt

Beim Setzen einer Menge können Sie den erwarteten aktuellen Wert der konkret geschriebenen Menge mitgeben (changeFromQuantity). Stimmt er nicht mehr, weil sich diese Menge inzwischen geändert hat, lehnt Shopify die Änderung mit CHANGE_FROM_QUANTITY_STALE ab. Der Prüfwert schützt also gegen eine zwischenzeitliche Änderung genau dieser Menge. Eine Bestellung kann available von 10 auf 9 senken und committed von 0 auf 1 erhöhen, während on_hand bei 10 bleibt. Eine Prüfung auf on_hand fällt dann nicht auf. Auch ein frisch gelesener Prüfwert schützt nicht vor einem veralteten Wawi-Zielwert: Vor einem absoluten available-Abgleich müssen die Shop-Verkäufe bereits im Wawi-Zielwert berücksichtigt sein. Bei CHANGE_FROM_QUANTITY_STALE lesen Sie den aktuellen Zustand und berechnen den Zielwert neu.

Bestand schreiben: absolut, relativ und mit Wiederholungsschutz

Für Mengen stehen zwei Mutationen bereit. inventorySetQuantities setzt einen absoluten Wert für available oder on_hand. inventoryAdjustQuantities ändert eine Menge um eine Differenz (delta), etwa von 100 auf 102 mit dem Wert 2. Eine dritte, inventoryMoveQuantities, verschiebt Mengen zwischen Status, zum Beispiel von reserved nach available.

  • Absolut setzen eignet sich für Inventur und Nachtabgleich. Es heilt Abweichungen, kann aber Verkäufe überschreiben. Geben Sie darum den erwarteten Ausgangswert mit. Shopify führte changeFromQuantity in 2026-01 ein. Mit 2026-04 wurde das Feld zur Pflicht, ein ausdrückliches null schaltet die Prüfung ab. Gleichzeitig entfielen compareQuantity und ignoreCompareQuantity.
  • Relativ ändern eignet sich für einzelne Buchungen wie Wareneingang oder Korrektur. Seit 2026-04 gehört changeFromQuantity bei inventoryAdjustQuantities zu jedem Eintrag in changes. Übergeben Sie den erwarteten Ausgangswert oder ausdrücklich null, wenn Sie die Prüfung bewusst abschalten. Für available lassen Sie ledgerDocumentUri weg. Bei anderen zulässigen Bestandsstatus, etwa damaged, geben Sie in jedem Eintrag dieselbe gültige Nicht-Shopify-URI für den einzelnen Buchungsbeleg an. referenceDocumentUri ist der optionale Verweis auf den übergeordneten Vorgang. Eine nach einem unklaren Fehler ungeprüft erneut gesendete Delta-Buchung kann doppelt zählen.
  • Status verschieben: Bei inventoryMoveQuantities gehört changeFromQuantity in from und in to, jeweils mit dem erwarteten Ausgangswert oder ausdrücklich null. Für den Wechsel von reserved nach available geben Sie in from zusätzlich eine gültige externe ledgerDocumentUri an, die nicht das Format gid://shopify/… haben darf. Lassen Sie ledgerDocumentUri in to für available weg. Shopify lehnt das Feld dort ab.
  • Idempotenzschlüssel: Die Direktive @idempotent(key: $idempotencyKey) macht identische Wiederholungen sicher. Seit 2026-01 ist sie optional, ab 2026-04 Pflicht. Vergeben und speichern Sie einen eindeutigen Schlüssel pro API-Operation oder Teilpaket. Eine Buchungsnummer der Wawi allein reicht nicht, wenn der Beleg mehrere API-Aufrufe auslöst oder nach einer Neuberechnung andere Parameter gesendet werden. Verwenden Sie den Schlüssel bei identischen Wiederholungen erneut. Shopify erkennt ihn 24 Stunden lang. Danach gilt eine Wiederholung als neue Operation, und ein erneut gesendetes Delta kann doppelt gebucht werden. Prüfen Sie deshalb nach Ablauf der 24 Stunden den Buchungsstand, bevor Sie erneut senden. Für eine nachweislich abgelehnte und mit geänderten Parametern neu berechnete Operation verwenden Sie einen neuen Schlüssel, denn Shopify kann denselben Schlüssel mit geänderten Parametern mit IDEMPOTENCY_KEY_PARAMETER_MISMATCH zurückweisen.
  • Beleg: Mit referenceDocumentUri hängen Sie einen Verweis auf den Wawi-Beleg an die Änderung. Bei inventoryMoveQuantities nimmt es die übergeordnete Belegreferenz auf, während ledgerDocumentUri die einzelne Buchung bezeichnet. Das erleichtert später die Fehlersuche.

Die Eingabefelder stehen in der Referenz für 2026-10: InventoryChangeInput und InventoryMoveQuantityTerminalInput.

Zum Zurücklesen gibt es die Webhooks inventory_levels/update, inventory_levels/connect und inventory_levels/disconnect. Änderungen an committed, reserved, damaged, safety_stock und quality_control lösen jedoch keinen Webhook aus. Wer diese Mengen braucht, liest sie regelmäßig je Bestandsartikel und Standort direkt und vergleicht sie mit dem gespeicherten Stand. InventoryLevel.updatedAt ist an Änderungen von available gekoppelt, andere Status können sich ändern, ohne dass dieser Zeitstempel mitzieht. Bei Bedarf werten Sie den Zeitstempel des einzelnen InventoryQuantity aus. Zu Überverkäufen über mehrere Kanäle lesen Sie Überverkauf bei Shop und Marktplatz.

Rechenbeispiel: eine Variante an zwei Standorten

Angenommene Zahlen, jeweils available / committed / on_hand. Shopify weist die Bestellung in diesem Beispiel Standort A zu.

SchrittStandort AStandort B
Ausgangslage10 / 0 / 105 / 0 / 5
Bestellung über 1 Stück9 / 1 / 105 / 0 / 5
Auslieferung von Standort A in Shopify erfasst9 / 0 / 95 / 0 / 5

Die Wawi liest in der Ausgangslage available 10 an Standort A und will nach einem Wareneingang von 2 Stück auf 12 setzen, mit changeFromQuantity 10. Geht die Bestellung vorher ein, steht available bei 9. Shopify lehnt den Schreibvorgang mit CHANGE_FROM_QUANTITY_STALE ab, weil 9 nicht 10 ist. Die Wawi liest den aktuellen Zustand (9 / 1 / 10) und berechnet den Zielwert neu: 9 plus 2 ergibt 11. Eine Prüfung auf on_hand hätte nach der Bestellung nicht abgelehnt, weil on_hand bei 10 bleibt. Sie greift erst nach der in Shopify erfassten Auslieferung, wenn on_hand auf 9 sinkt.

Bestellungen übernehmen: Webhook, Abfrage und Abgleichlauf

Shopify meldet neue Bestellungen per Webhook, wenn Sie beispielsweise das Topic orders/create abonnieren. Die vollständige Topic-Liste samt Berechtigungen steht in der Webhook-Referenz. Beachten Sie diese Regeln aus der Shopify-Dokumentation:

  • Signatur prüfen. Der Header X-Shopify-Hmac-Sha256 enthält eine Base64-Signatur des rohen Request-Bodys, berechnet mit dem Client Secret der App. Lesen Sie den Body, bevor Sie ihn parsen, und verwerfen Sie abweichende Zustellungen.
  • Schnell antworten. Das Verbindungs-Timeout liegt bei einer Sekunde, das Gesamt-Timeout bei fünf. Alles außerhalb von 2xx, auch eine Weiterleitung, zählt als Fehler. Prüfen Sie die Signatur, legen Sie Nachricht und Zustell-ID zuverlässig ab und senden Sie dann innerhalb des Zeitlimits 200 OK. Verarbeiten Sie den Auftrag anschließend asynchron, etwa über eine Warteschlange. Stürzt der Empfänger nach 200 OK vor dem Speichern ab, gilt die Zustellung als erfolgreich, und die Nachricht fehlt in der Verarbeitung.
  • Wiederholungen einplanen. Bleibt die Antwort aus oder ist sie fehlerhaft, versucht Shopify es bis zu achtmal innerhalb von vier Stunden. Ein über die Admin-API eingerichtetes Abonnement löscht Shopify nach acht aufeinanderfolgenden Fehlschlägen. Warnmails gehen an die hinterlegte Entwickler-Notfalladresse der App. Danach liefert dieses Abonnement keine Bestellungen mehr.
  • Duplikate erkennen. Verwenden Sie X-Shopify-Webhook-Id, um wiederholte Zustellungen zu erkennen. Kommt dieselbe ID erneut, überspringen Sie die Verarbeitung und antworten trotzdem erfolgreich, sobald die ursprüngliche Nachricht zuverlässig erfasst ist. Mehrere Abonnements für dasselbe Topic liefern je eine Zustellung mit eigener Webhook-ID, aber gleicher X-Shopify-Event-Id. Solche Zustellungen können parallel verarbeitet werden, und die Webhook-ID erkennt sie nicht als Duplikat. Legen Sie den Kundenauftrag deshalb anhand der Shopify-Order-ID atomar an oder aktualisieren Sie ihn, etwa mit einem eindeutigen Schlüssel in der Datenbank.
  • Reihenfolge nicht voraussetzen. Shopify garantiert sie nicht, auch nicht über Topics hinweg. Nutzen Sie X-Shopify-Triggered-At oder ein vorhandenes updated_at zur zeitlichen Einordnung. Zeitstempel stellen keine garantierte Reihenfolge her. Verhindern Sie, dass ein verspäteter älterer Stand neuere Daten überschreibt, und lesen Sie bei unklarer Reihenfolge den aktuellen Zustand per API.
  • Nicht auf Webhooks allein bauen. Shopify empfiehlt einen Abgleichlauf, der per API alles holt, was seit dem letzten Lauf geändert wurde. Für Bestellungen eignet sich dafür die Abfrage orders mit dem Filter updated_at. Wie Sie Bestandsstatus abgleichen, steht im Abschnitt zum Bestand.

Beim Einlesen einer Bestellung zählen drei Details. Erstens: Verwenden Sie currentQuantity, wenn Sie nach Erstattungen oder Entfernungen die tatsächliche Menge brauchen. Zweitens: Erhalten Sie discountAllocations am Ursprungsbeleg und gleichen Sie Erstattungen gesondert ab. Ziehen Sie die ursprünglichen Rabattanteile nicht pauschal vom Wert der reduzierten Menge ab. Nutzen Sie für den heutigen Positionswert nach Rabatten und vor Steuern priceAfterAllDiscountsBeforeTaxesSet und für Buchungen die zum Vorgang passenden Summen-, Währungs-, Steuer- und Erstattungsdaten. discountedUnitPriceSet ist nur ein Näherungswert für den rabattierten Stückpreis. Drittens: Speichern Sie LineItem.id als Schlüssel der Auftragsposition. Ordnen Sie den Wawi-Artikel über die Variant-ID zu, sofern sie vorliegt. Bei fehlender Variante nutzen Sie eine bereits gespeicherte Zuordnung oder eine eindeutig zuordenbare SKU und geben ungelöste Fälle zur Klärung aus.

Rate Limits: Wie schnell dürfen Sie abgleichen?

Die GraphQL-Admin-API drosselt nach berechneten Abfragekosten, nicht nach Anzahl der Aufrufe. Die Dokumentation nennt für die Auffüllung des Kontingents 100 Punkte pro Sekunde im Standardplan, 200 bei Advanced, 1.000 bei Shopify Plus und 2.000 bei Shopify for enterprise. Eine einzelne Abfrage darf höchstens 1.000 Punkte kosten, geprüft wird vor der Ausführung auf Basis der angeforderten Kosten. Standardmäßig kosten Skalare und Enums 0, Objekte 1 und Mutationen 10. Die Kosten für Connections richten sich nach den Argumenten first und last.

  • Lesen Sie extensions.cost und throttleStatus, wenn sie vorhanden sind. Dort stehen die angeforderten und tatsächlichen Kosten sowie der aktuelle Füllstand. Steuern Sie Ihre Last daran und nicht an festen Pausen. Fehler, die vor der Ausführung auftreten, etwa MAX_COST_EXCEEDED, behandeln Sie gesondert: Dort gibt es keine tatsächlichen Ausführungskosten.
  • Ist das Kontingent erschöpft, meldet die API den Fehler THROTTLED. Als Wartezeit empfiehlt Shopify eine Sekunde, bevor Sie es erneut versuchen.
  • Eingabelisten sind auf 250 Einträge begrenzt. Gruppieren Sie für inventoryAdjustQuantities zuerst nach Bestandsstatus. Außerhalb von available gruppieren Sie zusätzlich nach ledgerDocumentUri. Bilden Sie erst danach Pakete mit höchstens 250 Einträgen. Unterschiedliche Beleg-URIs im gleichen Aufruf können MAX_ONE_LEDGER_DOCUMENT auslösen.
  • Für große Datenmengen sieht Shopify Bulk Operations vor. Sie unterliegen nicht den Höchstkosten und Limits einzelner Abfragen.
  • Für Neuanlagen gibt es eine Zusatzgrenze: Hat ein Shop 500.000 Varianten, sind höchstens 10.000 neue Varianten pro Tag möglich. Überschreitungen bringen eine Antwort 429. Shopify Plus ist davon ausgenommen.

Für den ersten Import eines größeren Katalogs ist ein sauberer Ablauf entscheidend. Was bei einem Tabellenimport schiefgehen kann, steht in Shopify-CSV-Import und gelöschte Varianten.

Wo Abgleiche scheitern: Symptom, Ursache, Gegenmittel

SymptomWahrscheinliche UrsacheGegenmittel
Bestand springt nach dem Abgleich zurück, ÜberverkaufAbsoluter Wert ohne Prüfwert überschreibt zwischenzeitliche Verkäufe, oder der Wawi-Zielwert berücksichtigt Shop-Verkäufe nichtchangeFromQuantity für die geschriebene Menge mitgeben, Shop-Verkäufe im Zielwert berücksichtigen, bei CHANGE_FROM_QUANTITY_STALE den aktuellen Zustand lesen und den Zielwert neu berechnen
Schreibaufruf erfolgreich, Artikel am Standort dennoch nicht verkäuflichInventoryLevel ist inaktiv und speichert nur die MengeInventoryLevel.isActive prüfen und den Bestandsartikel bei Bedarf mit inventoryActivate oder inventoryBulkToggleActivation aktivieren
Position ohne passenden Wawi-ArtikelSKU anders geschrieben, geändert oder Variante nicht mehr vorhandenVariant-ID mitführen, Zuordnung prüfen, Abweichungen in eine Fehlerliste
Bestellung doppelt in der WawiWiederholte Zustellung oder zwei Abonnements, die parallel verarbeitet werdenWebhook-ID zur Erkennung wiederholter Zustellungen verwenden und den Kundenauftrag anhand der Shopify-Order-ID atomar anlegen oder aktualisieren, etwa mit einem eindeutigen Datenbankschlüssel
Bestellung fehltAntwort nach mehr als fünf Sekunden, über die Admin-API eingerichtetes Abonnement nach acht aufeinanderfolgenden Fehlschlägen gelöschtEmpfängerablauf wie im Abschnitt zu Bestellungen, täglicher Abgleichlauf über updated_at der Bestellungen
Beim Erstimport fehlen ältere BestellungenZugriff auf die letzten 60 Tage begrenztread_all_orders zusätzlich zum Bestell-Scope deklarieren (Freigabe je nach App-Typ, siehe FAQ) oder Altbestand aus der Wawi nehmen
Bestand im falschen LagerLocation-ID falsch oder fehlend zugeordnetFeste Zuordnungsliste Wawi-Lager zu Location pflegen
Rechnungssumme weicht abRabatte auf Auftragsebene oder per Code nicht in discountedUnitPriceSet enthalten, das nur ein Näherungswert istZugewiesene Beträge aus discountAllocations übernehmen, bei Bedarf auch auf Versandzeilen, und für den Abgleich die passenden Summen-, Steuer-, Währungs- und Erstattungsdaten nutzen
Menge nach Erstattung falschquantity statt currentQuantity gelesenDas passende Feld je Zweck festlegen
Fehler THROTTLEDZu viele Einzelaufrufe, zu große AbfragenPakete bis 250, Kosten aus extensions.cost lesen, wenn vorhanden, eine Sekunde warten

Treten mehrere dieser Symptome gleichzeitig auf, lohnt es sich, zuerst die Entscheidungshilfe oben auszufüllen, denn unklare Schreibzuständigkeiten sind eine mögliche Ursache. Wenn Ihre Wawi keinen passenden Anschluss hat oder Ihre Preis- und Lagerlogik nicht in Standardfelder passt, ist eine individuelle Schnittstelle zwischen Shopify und Warenwirtschaft der saubere Weg.

Checkliste: Rate-Limit-, Webhook- und Wiederholungsregeln

Die genannten GraphQL-Felder und Mutationen beziehen sich auf API-Version 2026-10.

Einrichtung

  1. Lagerliste Wawi-Lager zu Shopify-Location anlegen und jeden Standort auf isActive und fulfillsOnlineOrders prüfen. Für jeden vorgesehenen Verkaufsstandort zusätzlich InventoryLevel.isActive je Bestandsartikel prüfen und den Bestandsartikel bei Bedarf mit inventoryActivate oder inventoryBulkToggleActivation am Standort aktivieren.
  2. Pro Variante Variant-ID und InventoryItem-ID in der Wawi speichern. Für die SKU-Zuordnung gelten die Regeln aus der Zuordnungstabelle (Zeile ProductVariant.sku).
  3. Prüfen Sie, ob tracked den Wert true hat. Bei false verfolgt Shopify die Bestandsmengen des Artikels nicht.
  4. Pro Datenbereich ein führendes System und je Vorgang die erlaubten Änderungen festlegen (siehe Entscheidungshilfe). Shopify-Verkäufe regulär auf den Bestand wirken lassen und konkurrierende absolute Abgleiche aus mehreren Systemen vermeiden.
  5. Webhook-Empfänger nach den Regeln aus dem Abschnitt zu Bestellungen einrichten: Signatur prüfen, Nachricht und Zustell-ID zuverlässig ablegen, dann 200 OK senden und asynchron verarbeiten.
  6. Vor dem Produktivschalten die Abnahmeprüfung aus dem ersten Abschnitt mit Testauftrag und Teilerstattung durchführen.

Laufender Betrieb

  1. Bestandsschreiben mit changeFromQuantity ausführen, bei inventorySetQuantities, inventoryAdjustQuantities und inventoryMoveQuantities, wobei die Shop-Verkäufe bereits im Wawi-Zielwert berücksichtigt sind.
  2. Pro API-Operation oder Teilpaket einen eigenen @idempotent-Schlüssel vergeben und speichern. Die Wiederholungsregeln stehen im Abschnitt zum Bestand.
  3. Relative Mengenänderungen nach Status und außerhalb von available zusätzlich nach ledgerDocumentUri gruppieren. Pakete auf 250 Einträge begrenzen und extensions.cost sowie throttleStatus mitlesen, wenn vorhanden.
  4. Bei THROTTLED mindestens eine Sekunde warten und die identische Operation mit demselben Schlüssel wiederholen.
  5. Doppelte Zustellungen anhand der Webhook-ID überspringen und den Kundenauftrag anhand der Shopify-Order-ID atomar anlegen oder aktualisieren.
  6. Zeitliche Einordnung über X-Shopify-Triggered-At oder ein vorhandenes updated_at. Einen verspäteten älteren Stand nicht neuere Daten überschreiben lassen und bei unklarer Reihenfolge den aktuellen Zustand per API lesen.
  7. Täglichen Abgleichlauf einrichten: Für Bestellungen orders mit dem Filter updated_at verwenden. Für benötigte Bestandsstatus die Mengen je Bestandsartikel und Standort regelmäßig direkt lesen und mit dem gespeicherten Stand vergleichen, bei Bedarf über den Zeitstempel des einzelnen InventoryQuantity.
  8. Prüfen, ob das Webhook-Abonnement noch besteht, und bei Ausfall alarmieren.
  9. Fehlgeschlagene Vorgänge mit Beleg-Referenz in einer Liste halten, damit sie ohne Doppelbuchung wiederholbar sind.
Passend dazu

Wenn Ihre Warenwirtschaft keinen passenden Shopify-Anschluss hat oder Ihre Preis- und Lagerlogik nicht in die Standardfelder passt, entwickeln wir Software-Schnittstellen und integrieren Ihre Systeme so, dass Bestand, Preis und Bestellung nachvollziehbar zwischen Shop und Wawi laufen.

Mehr dazu: Software-Schnittstellen entwickeln und Systeme integrieren

Quellen

Alle Quellen gelesen am 19.11.2026.

Erstellt von der Redaktion Die Netzhandwerker mit KI-Unterstützung. Die Sachangaben wurden vor der Veröffentlichung automatisch gegen die genannten Quellen geprüft.

Ihr Onlineshop soll so arbeiten wie Ihr Betrieb?

Wir bauen Onlineshops als Unikat mit eigenem Quelltext und übernehmen Produkte, Kunden und Bestellungen aus Ihrem bisherigen System.

Onlineshop nach Maß ansehen →

Weiterlesen — verwandte Artikel

Shop & Warenwirtschaft

Shop an die Warenwirtschaft anbinden: welche Daten in welche Richtung fließen – Plan für WooCommerce und Shopware

Shop-Warenwirtschaft-Schnittstelle planen: welche Daten in welche Richtung fließen, wer führt und was bei Konflikten gilt. Für WooCommerce und Shopware.

Shop & Warenwirtschaft

JTL-Wawi API: Wann sich eine REST-Schnittstelle lohnt

JTL-Wawi API, Connector oder CSV? Entscheiden Sie nach Datenfluss, testen Sie den ersten Artikelabruf und planen Sie Schreibvorgänge ohne Doppelbuchung.

Shop & Warenwirtschaft

Shopware 6 und Warenwirtschaft: So prüfen Sie den Bestandsabgleich

Shopware 6 Warenwirtschaft anbinden: Welche Felder (stock, availableStock, Preis, Status) zusammengehören und wo Bestand und Preise abweichen.

Voriger Artikel FritzBox WLAN Probleme: Kein Internet trotz Verbindung Nächster Artikel Shopware 6 und Warenwirtschaft: So prüfen Sie den Bestandsabgleich

Beschreiben Sie Ihr Anliegen

Schreiben Sie uns kurz, worum es geht. Wir prüfen die Anfrage und melden uns per E-Mail mit dem nächsten Schritt.

Häufig gestellte Fragen

Welcher Schlüssel eignet sich, um Shopify-Artikel und Wawi-Artikel zuzuordnen?

Für die Erstzuordnung die SKU der Variante, aber nur, wenn sie auf beiden Seiten vorhanden und eindeutig ist. Für den laufenden Abgleich speichern Sie die Variant-ID. Die vollständigen Regeln, auch zu mehrdeutigen Treffern, leeren Varianten an Bestellpositionen und zum Barcode als Zweitschlüssel, stehen in der Zuordnungstabelle in den Zeilen zu ProductVariant.sku, ProductVariant.barcodes und LineItem.

Warum kann ich den gebundenen Bestand (committed) nicht setzen?

Shopify verwaltet diese Menge selbst, etwa für offene Bestellungen, reservierte Entwurfsbestellungen oder versandbereite Umlagerungen und Sendungen. Die Admin-API erlaubt keine Änderung daran, und Änderungen lösen keinen Webhook aus. Sie lesen den Wert regelmäßig, gleichen die Kundenauftragsreservierung Ihrer Wawi anhand der Auftragsdaten ab und berücksichtigen andere Bindungsgründe getrennt.

Reicht es, Bestellungen nur per Webhook zu übernehmen?

Nein. Shopify nennt Webhook-Zustellung selbst nicht garantiert und empfiehlt einen Abgleichlauf, der per API geänderte Daten abholt. Zusätzlich löscht Shopify ein über die Admin-API angelegtes Abonnement nach acht aufeinanderfolgenden Fehlern. Ein täglicher Lauf über orders mit dem Filter updated_at fängt verpasste Bestellungen auf. Die Regeln zu Wiederholungen und Duplikaten stehen im Abschnitt zu Bestellungen.

Wie oft darf ich den Bestand abgleichen?

Das hängt vom Kostenkontingent ab, nicht von einer festen Aufrufzahl. Laut Dokumentation füllt sich das Kontingent im Standardplan mit 100 Punkten pro Sekunde, bei Advanced mit 200, bei Plus mit 1.000. Eine Mutation kostet standardmäßig 10 Punkte. Tatsächliche Kosten und Füllstand stehen, wenn vorhanden, in extensions.cost und throttleStatus der Antwort. Bei Fehlern vor der Ausführung gibt es keine tatsächlichen Kosten. Gruppieren Sie relative Änderungen wie im Abschnitt zu Rate Limits beschrieben und begrenzen Sie jedes Paket auf höchstens 250 Einträge.

Wie komme ich an Bestellungen, die älter als 60 Tage sind?

Standardmäßig sind nur Bestellungen der letzten 60 Tage abrufbar. Für ältere deklarieren Sie read_all_orders zusätzlich zu read_orders oder write_orders. Apps aus einer Partnerorganisation benötigen dafür eine Shopify-Freigabe. Apps, die eine Händlerorganisation im Dev Dashboard für ihre eigenen Shops erstellt, können den Scope direkt deklarieren. Für lesenden Bestellzugriff über das 60-Tage-Fenster hinaus kombinieren Sie read_orders mit read_all_orders. Benötigt der Import geschützte Kundendaten wie Name oder Adresse, prüfen Sie die zusätzlichen Anforderungen für Ihren App-Typ. Soll die App ältere Bestellungen auch bearbeiten, kombinieren Sie read_all_orders mit write_orders. Alternativ übernehmen Sie den Altbestand aus der Wawi.

Was ist der Unterschied zwischen inventorySetQuantities und inventoryAdjustQuantities?

inventorySetQuantities setzt einen absoluten Wert, inventoryAdjustQuantities ändert die Menge um eine Differenz. Absolut passt zu Inventur und Nachtabgleich, relativ zu einzelnen Buchungen. Beide verlangen ab API-Version 2026-04 changeFromQuantity und einen Idempotenzschlüssel pro API-Operation. Wann Sie den Schlüssel erneut verwenden und was nach 24 Stunden gilt, steht im Abschnitt zum Bestand.

Branchen-Fachwissen SHK, Elektro, Maler
Beispiele aus dem Haus KI-Anwendungen, die wir selbst betreiben
Alle KI-Lösungen → Alles einzeln gebaut, nichts von der Stange.
Alle Software-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Computer & Laptops PC, Mac, Kaufberatung
Mobilgeräte Smartphone, TV, Fotos
Peripherie & Netzwerk Drucker, WLAN, NAS
Alle Hardware-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Privat-Leistungen → Alles einzeln gebaut, nichts von der Stange.
Alle Unternehmens-Leistungen → Alles einzeln gebaut, nichts von der Stange.
linkx© Hub + Module QR-Code für digitale Abläufe
linkx© Module II Pflegeheim, Schule, Wache, Wahl
Alle Submarken → Alles einzeln gebaut, nichts von der Stange.
Alle Artikel im Wissensbereich → Alles einzeln gebaut, nichts von der Stange.