Softwareschnittstellen für den Datenaustausch

Zwei Systeme, zwei Wahrheiten

47 Bestellungen im Onlineshop. Null Picklisten im Lager. Deine Kollegin Anja aus dem Versand schreibt dir am Donnerstagmorgen per Chat: "Hier liegt nichts zum Kommissionieren." Du prüfst das Warenwirtschaftssystem (WaWi) - keine einzige der 47 Bestellungen ist angekommen. Die letzte erfolgreiche Übertragung war gestern um 18:03 Uhr.

47 Kunden warten auf ihre Ware. Jede Stunde ohne Versand bringt Stornierungen und Bewertungseinbrüche. Erinnerst du dich an die Kategoriestruktur, die du für den Shop aufgebaut hast? Genau hier setzt das Thema Schnittstellen an: Jede Bestellung, die Kund:innen über diese Kategorien auslösen, muss automatisch ins WaWi fließen. Bricht diese Verbindung ab, ist die sorgfältigste Kategorisierung wertlos.

Was prüfst du zuerst, um die Ursache zu finden?

Drei Schnittstellentypen im E-Commerce

Zwischen Shop und WaWi gibt es drei gängige Wege für den Datenaustausch:

1. API (Application Programming Interface) - Shop und WaWi kommunizieren in Echtzeit. Jede Bestellung wird sofort übertragen. Typisch für moderne Shopsysteme wie Shopify oder Shopware.
2. EDI (Electronic Data Interchange) - standardisiertes Format für den automatisierten Austausch großer Datenmengen. Häufig im B2B-Bereich, wenn Handelspartner:innen regelmäßig Bestellungen oder Rechnungen austauschen.
3. CSV-Import - Daten werden als Tabellendatei exportiert und manuell oder zeitgesteuert importiert. Einfach einzurichten, aber fehleranfällig, weil zwischen Export und Import eine zeitliche Lücke entsteht.

🎬 Vorstellung: Stell dir deinen eigenen Arbeitsplatz vor - welchen dieser drei Schnittstellentypen nutzt dein Ausbildungsbetrieb zwischen Shop und WaWi?

Drei Angaben pro Übertragungsversuch

Jede Schnittstelle führt ein Protokoll (Log), das jeden Übertragungsversuch festhält. Pro Eintrag findest du drei Angaben:

• Zeitstempel - wann wurde der Versuch gestartet?
• Status - war die Übertragung erfolgreich ("200 OK") oder fehlgeschlagen ("500 Server Error", "Timeout")?
• Betroffene Datensätze - welche Bestellnummern waren beteiligt?

Im Fall der 47 Bestellungen zeigt das Protokoll: Ab 18:03 Uhr steht bei jedem Eintrag der Status Timeout. Die API hat versucht, Daten zu senden, aber das WaWi hat nicht mehr geantwortet. Die Ursache liegt also nicht im Shop, sondern auf der Empfängerseite.

Drei Fehlerbilder, die du im Protokoll erkennst

Nicht jeder Fehler sieht gleich aus. Drei typische Muster helfen dir bei der Einordnung:

1. Timeout - das Zielsystem antwortet nicht. Häufige Ursache: Server-Wartung, Überlastung oder Netzwerkproblem. Im Protokoll erkennbar an Statusmeldungen wie "504 Gateway Timeout".
2. Authentifizierungsfehler ("401 Unauthorized") - die Zugangsdaten der Schnittstelle sind abgelaufen oder wurden geändert. Passiert oft nach einem WaWi-Update, bei dem API-Schlüssel zurückgesetzt werden.
3. Datenformatfehler ("400 Bad Request") - die gesendeten Daten passen nicht zum erwarteten Format. Zum Beispiel: Der Shop sendet eine neue Produktkategorie, die im WaWi noch nicht angelegt ist.

Wer das Protokoll regelmäßig prüft, erkennt Ausfälle innerhalb von Minuten statt Stunden.

🤔 Frage dich: Wie würdest du in deinem Betrieb sicherstellen, dass ein Schnittstellenfehler nicht erst am nächsten Morgen auffällt, sondern sofort?

Fünf Schritte für den Notfall

Wenn die automatische Übertragung ausfällt, brauchst du einen klaren Plan. Fünf Schritte bilden das Gerüst:

1. Fehler lokalisieren - Protokoll öffnen, Zeitpunkt und Statusmeldung des ersten Fehlers notieren. Das ist die Grundlage für alle weiteren Schritte.
2. IT-Abteilung oder Dienstleister informieren - mit konkreter Fehlermeldung, nicht nur "geht nicht". Je präziser deine Meldung, desto schneller die Behebung.
3. Bestellungen manuell übertragen - offene Bestellungen als CSV aus dem Shop exportieren und ins WaWi importieren. Das überbrückt die Lücke, bis die Schnittstelle wieder läuft.
4. Kund:innen proaktiv informieren - bei Verzögerungen über eine Stunde eine kurze Statusmail senden. Das reduziert Stornierungen und schützt die Bewertungen.
5. Nach Behebung: Datenabgleich durchführen - prüfen, ob alle Bestellungen vollständig und ohne Duplikate übertragen wurden.

So hätte es bei den 47 Bestellungen laufen müssen

Hätte das Team diesen Notfallprozess gehabt, wäre der Timeout um 18:03 Uhr per automatischer Benachrichtigung sofort aufgefallen. Die IT hätte den WaWi-Server noch am Abend neu gestartet. Am Donnerstagmorgen hätte Anja ihre Picklisten gehabt - statt einer leeren Versandstation.

🧑‍🏫 Erkläre es im Kopf: Stell dir vor, du erklärst einer neuen Kollegin den Unterschied zwischen einem Timeout und einem Authentifizierungsfehler - und warum der Notfallprozess bei beiden anders startet. Wie würdest du das in zwei Sätzen formulieren?