Aufträge an ein ERP anbinden: manuelle Prüfung, idempotente Übertragung und Sync-Log

KURZ GESAGT: Der häufigste Fehler bei ERP-Anbindungen: „Das ERP hat den Auftrag angenommen“ wird mit „Der Auftrag ist erledigt“ gleichgesetzt. Viele ERP-Systeme prüfen Aufträge danach noch manuell und buchen erst dann die Warenbewegung, und die Plattform kann nur warten. Wir geben jeder Übertragung einen stabilen Geschäftsschlüssel, damit sie gefahrlos wiederholt werden kann, ermitteln den Status per Abfrage statt aus einer einzelnen Antwort, schreiben jede Synchronisierungsaktion in ein Sync-Log und finden mit einem täglichen Abgleich Belege, die auf beiden Seiten nicht mehr übereinstimmen.

Diagramm der Auftragssynchronisierung zwischen Plattform und ERP. Auf der Plattformseite: Auftrag bezahlt, Kunde anlegen, Auftrag mit Idempotenzschlüssel senden, Status abfragen. Auf der ERP-Seite: Kundenstamm, manuelle Prüfung sowie Versand und Rechnung. Die manuelle Prüfung ist gestrichelt mit dem Hinweis, dass sie auf Menschen wartet und Wiederholen nicht hilft. Jeder Aufruf schreibt in ein Sync-Log, ein täglicher Abgleich listet Abweichungen.
Abbildung 1. Der Weg eines Auftrags. Manuelle Schritte im ERP sind der Grund, warum der Status abgefragt und nicht abgewartet wird.

1.0 Zuerst den Geschäftsablauf aufzeichnen

Bevor die erste Zeile Integrationscode entsteht, setzen Sie sich mit dem ERP-Dienstleister und der Fachseite zusammen und schreiben jeden Schritt von der Bestellung bis zur Rechnung auf. Markieren Sie, auf welcher Seite er stattfindet und ob er automatisch oder manuell ist. Eine typische Kette: Kunde anlegen, Auftrag senden, Prüfung im ERP, Warenbewegung buchen, Versand mit Sendungsnummer, Zahlungseingang bestätigen, Rechnung abholen.

Die manuellen Schritte zu markieren ist entscheidend. Ein Auftrag, den die Plattform als „in Bearbeitung“ zeigt, liegt womöglich in der Aufgabenliste einer Person im ERP, und kein Wiederholen bewegt ihn. Oberfläche und Alarme müssen „wir warten auf das ERP“ von „die Übertragung ist fehlgeschlagen“ unterscheiden, sonst landen beide Problemarten bei den Entwicklern.

2.0 Übertragungen müssen wiederholbar sein

Timeouts sind der schwierige Fall: Die Anfrage kann angekommen sein oder auch nicht. Legt das ERP beim erneuten Senden einen zweiten Beleg an, haben Sie einen doppelten Auftrag.

  • Jeder Beleg trägt einen stabilen Geschäftsschlüssel, meist die Auftragsnummer der Plattform, und das ERP dedupliziert danach. Kann das ERP nicht deduplizieren, wird vor dem Senden abgefragt, ob der Beleg schon existiert.
  • Abhängige Stammdaten zuerst übertragen: Ein neuer Kunde wird angelegt, bevor sein Auftrag kommt. Ist eine Abhängigkeit nicht bereit, wartet der Beleg in einer lokalen Warteschlange, statt durchgedrückt zu werden.
  • Nicht passende Codes sind der Normalfall, nicht die Ausnahme. Schriftlich festlegen, was gesendet wird, wenn ein Artikel oder Kunde im ERP noch fehlt, und welche Seite die Lücke schließt.
  • ERP-Fehler verstecken sich oft im Body einer HTTP-200-Antwort. Ein zentraler Client erkennt diese Fehlersemantik, damit nicht jede Aufrufstelle sie anders auslegt.

3.0 Der Status kommt aus der Abfrage

Die Antwort auf eine Übertragung sagt nur, dass das ERP den Beleg erhalten hat. Spätere Zustände liefert ein geplanter Abfragejob:

GestaltungspunktUnsere Wahl
DurchlaufKeyset-Pagination über den Primärschlüssel statt OFFSET; stabil bei wachsender Menge, ohne Lücken zwischen Seiten
ReihenfolgeEin Cursor, der im Kreis weiterläuft und dort fortsetzt, wo der letzte Lauf aufhörte, damit nicht immer dieselben Fehlschläge drankommen
BackoffDauerhaft fehlschlagende Belege werden seltener abgefragt, bis zu einer Obergrenze; darüber hinaus geht es an einen Menschen
NebenläufigkeitEin Beleg wird immer nur von einem Worker bearbeitet, gesichert per Zeilensperre oder Lease

4.0 Das Sync-Log ist der Einstieg in jede Fehlersuche

Jeder Aufruf schreibt eine Zeile: Belegnummer, Aktion, Anfrage-Digest, Ergebniscode, Meldung des ERP, Dauer und Versuchsnummer. Passwörter, Tokens und vollständige personenbezogene Daten bleiben draußen.

Mit dieser Tabelle beginnt „Warum ist dieser Auftrag noch nicht versandt?“ mit einer Abfrage statt mit dem Durchwühlen von Anwendungslogs oder der Bitte um Screenshots aus dem ERP-Team. Zusätzlich führen wir ein Runbook: Jedes neu gelöste Problem bekommt Symptom, Ursache, Lösung und die Diagnoseabfragen, der neueste Eintrag steht oben. ERP-Probleme kehren gern in anderer Gestalt wieder, und dieses Runbook ist am Ende nützlicher als jedes Dashboard.

5.0 Abgleich

Selbst wenn jeder Schritt stimmt, laufen beide Seiten auseinander: Jemand ändert oder storniert einen Auftrag direkt im ERP, oder ein Abfrageergebnis wurde nie gespeichert. Ein täglicher Abgleich vergleicht Status, Beträge und Rechnungen und setzt die Abweichungen auf eine Liste für einen Menschen. Er „korrigiert“ keine Seite automatisch; sein Ergebnis ist eine Arbeitsliste.

6.0 Entwicklung und Test

  • Der ERP-Adapter ist eine Schnittstelle mit simulierter Implementierung für lokale Arbeit und CI, sodass der gesamte Auftragslebenszyklus einschließlich Rechnung offline durchläuft.
  • ERP-Testumgebungen weichen oft von der Produktion ab oder fehlen ganz. Während der Integrationstests die echten Anfragen und Antworten jedes Endpunkts geschwärzt speichern und als Regressionsfälle nutzen.
  • In den ersten Wochen nach dem Go-live häufiger abgleichen, um Fälle aufzudecken, die die Testumgebung nie gezeigt hat.

Wenn Sie ein Bestellsystem an ein ERP anbinden oder eine bestehende Anbindung immer wieder bricht, siehe Web, Cloud und Geräteverwaltung, oder Projekt besprechen.

Quellen

Häufige Fragen

Das ERP bietet nur Datenbank-Views, keine API. Ist eine Anbindung trotzdem möglich?

Lesende Views reichen, um Artikel und Bestände abzuholen. Belege direkt in die ERP-Datenbank zu schreiben ist riskant: Es umgeht die Prüfungen des ERP und macht unklar, wer verantwortlich ist, wenn etwas schiefgeht. Schreibzugriffe sollten über die API oder Importfunktion des ERP laufen, und die Lese-/Schreibgrenze ist vorher mit dem ERP-Dienstleister abzustimmen.

Wie oft sollten Bestände synchronisiert werden?

Das hängt davon ab, was ein Überverkauf kostet und wie viel Last das ERP verträgt. Den Bestand beim Bestellabschluss noch einmal in Echtzeit zu prüfen, ist meist zuverlässiger, als die geplante Synchronisierung sehr häufig laufen zu lassen, und schont das ERP.

Die Prüfung im ERP dauert, und Kunden sehen dauerhaft „in Bearbeitung“. Was tun?

Zeigen Sie ehrlich, wo der Auftrag wartet, etwa „wartet auf ERP-Prüfung“, zusammen mit der vereinbarten Bearbeitungszeit. Die Prüfung kann die Plattform dem ERP-Team nicht abnehmen, aber sie kann das Warten sichtbar machen und den Verantwortlichen bei Überschreitung automatisch erinnern.

Müssen wir die Plattform neu schreiben, wenn wir später das ERP wechseln?

Liegt der Integrationscode in einem Adapter, heißt ein ERP-Wechsel vor allem: Adapter neu schreiben, Code-Zuordnungen neu anlegen und durchgängig testen. Ruft Geschäftscode die ERP-API an vielen Stellen direkt auf, wird die Änderung deutlich größer; deshalb bauen wir die Adapterschicht von Anfang an.