Softwarecheck
Alle Blog-Themen

ERP PRAXISWISSEN

ERP-Schnittstellen: Doppelte Buchungen bei Wiederholungen vermeiden

Wenn eine ERP-Schnittstelle nicht rechtzeitig antwortet, ist der Auftrag nicht automatisch gescheitert. Eine unkontrollierte Wiederholung kann denselben Vorgang erneut buchen. Entscheidend sind eindeutige Vorgangskennungen, verlässliche Statusabfragen und klare Regeln für den Wiederanlauf.

ERP6 Min. LesezeitVeröffentlicht am 10. November 2026Softwarecheck Redaktion

Ein Timeout ist kein Beleg für eine fehlgeschlagene Buchung

Ein vorgelagertes Abrechnungssystem übermittelt einen Buchungsauftrag an das ERP. Das ERP verarbeitet ihn und schreibt den Beleg fest, doch die Antwort erreicht das sendende System nicht mehr. Dort erscheint ein Timeout. Wird der Auftrag nun ohne weitere Prüfung erneut gesendet, kann eine zweite Buchung entstehen. Für die Integration ist das Ergebnis zunächst unklar: Fehlende Rückmeldung und fehlende Verarbeitung sind unterschiedliche Zustände.

Die Absicherung darf deshalb nicht allein auf zuverlässige Übertragung setzen. Auch Warteschlangen, geplante Wiederanläufe oder manuelle Neustarts können bereits zugestellte Nachrichten erneut liefern. Benötigt wird eine idempotente Verarbeitung: Derselbe Auftrag darf bei Wiederholung keinen zusätzlichen fachlichen Effekt auslösen. Das muss für den gesamten relevanten Verarbeitungsweg gelten, nicht nur für die Annahme an einem vorgeschalteten Integrationsdienst.

Vor der technischen Umsetzung ist festzulegen, was genau einmal geschehen darf. Bei einem Buchungsauftrag kann dies die Erzeugung eines bestimmten ERP-Belegs sein. Bei einem komplexeren Ablauf können mehrere eigenständige Schritte entstehen, etwa Belegerzeugung und anschließende Freigabe. Jeder Schritt braucht einen klaren Status und eine definierte Wiederholungsregel. Ein pauschales Merkmal wie „Nachricht empfangen“ belegt noch nicht, dass der fachliche Vorgang vollständig abgeschlossen wurde.

Die Vorgangskennung muss den Auftrag identifizieren

Eine stabile Vorgangskennung, häufig Idempotenzschlüssel genannt, verbindet den ursprünglichen Auftrag mit seinen Wiederholungen. Sie wird vor dem ersten Versand erzeugt, dauerhaft gespeichert und bei jedem erneuten Versuch unverändert verwendet. Eine bei jedem HTTP-Aufruf neu vergebene Anfragekennung eignet sich dafür nicht. Auch eine Belegnummer allein ist häufig zu unspezifisch: Ihr Gültigkeitsbereich kann vom Quellsystem, Mandanten oder Geschäftsjahr abhängen.

Der Schlüssel muss die fachliche Operation unterscheiden, nicht bloß das übergeordnete Geschäftsobjekt. Eine Rechnung und ihre spätere Stornierung sind beispielsweise verschiedene Aufträge. Ebenso dürfen zulässige Teilvorgänge nicht versehentlich als Dubletten unterdrückt werden. Im Schnittstellenvertrag sollten deshalb Schlüsselbildung, Gültigkeitsbereich und die Behandlung fachlicher Korrekturen ausdrücklich beschrieben sein.

Zusätzlich muss das Zielsystem erkennen können, wenn derselbe Schlüssel mit verändertem Inhalt erneut eingeht. Dafür lässt sich der gespeicherte Originalauftrag oder eine Prüfsumme seiner fachlich relevanten Felder heranziehen. Ein abweichender Betrag unter derselben Kennung sollte nicht stillschweigend übernommen werden. Der Konflikt gehört in eine nachvollziehbare Fehlerbehandlung; eine tatsächliche Korrektur benötigt einen definierten Änderungs- oder Stornoprozess.

  • Die Kennung bleibt über automatische und manuelle Wiederholungen hinweg unverändert.
  • Quellsystem, Mandant und fachliche Operation bilden einen eindeutig abgegrenzten Gültigkeitsbereich.
  • Gleicher Schlüssel mit verändertem Inhalt führt zu einem sichtbaren Konflikt statt zu einer stillen Überschreibung.
  • Korrekturen und Stornierungen werden als eigene, mit dem Ursprung verknüpfte Vorgänge behandelt.

Dublettenprüfung und Buchung dürfen nicht auseinanderfallen

Eine einfache Vorabfrage nach dem Muster „Existiert die Kennung bereits?“ reicht nicht aus. Zwei gleichzeitig eintreffende Wiederholungen könnten beide feststellen, dass noch kein Eintrag vorhanden ist, und anschließend beide buchen. Die Verarbeitung benötigt eine technische Absicherung gegen diesen Wettlauf, etwa eine eindeutige Datenbankbedingung in Verbindung mit geeigneter Transaktionssteuerung. Entscheidend ist, dass nur eine Verarbeitung den fachlichen Auftrag wirksam ausführen kann.

Besonders kritisch ist die Lücke zwischen gespeicherter Vorgangskennung und tatsächlicher ERP-Buchung. Wird die Kennung bereits als erledigt markiert, obwohl die Buchung später scheitert, kann ein Auftrag verloren gehen. Erfolgt die Buchung zuerst und scheitert danach das Speichern ihres Status, droht eine Dublette beim Wiederanlauf. Innerhalb eines Systems sollten Buchung und zugehöriger Abschlussstatus daher möglichst in derselben Transaktion festgeschrieben werden.

Über Systemgrenzen hinweg lässt sich diese gemeinsame Transaktion oft nicht herstellen. Dann braucht die Integration einen dauerhaften Bearbeitungsnachweis und eine Möglichkeit, den ERP-Beleg anhand einer stabilen externen Referenz wiederzufinden. Ein Integrationsdienst allein beseitigt die Unsicherheit nicht, wenn das ERP weder eine eindeutige Referenz erzwingt noch eine belastbare Ergebnisabfrage ermöglicht. Diese Grenze sollte bereits bei der Auswahl offengelegt werden, statt sie durch eine allgemeine Zusage zur „Dublettenvermeidung“ zu verdecken.

Unklare Ergebnisse brauchen einen geregelten Klärungsweg

Für den Betrieb sollten mindestens angenommene, noch laufende, erfolgreich abgeschlossene, endgültig abgelehnte und unklare Vorgänge unterscheidbar sein. Eine technische Empfangsbestätigung ist dabei kein Buchungsnachweis. Nach einem Timeout fragt das sendende System nach Möglichkeit zunächst den Status anhand der ursprünglichen Kennung ab. Ist der Auftrag abgeschlossen, benötigt es die Referenz auf das vorhandene Ergebnis, nicht die Aufforderung zu einer neuen Buchung.

Auch eine Statusabfrage kann Grenzen haben. Meldet eine verzögert aktualisierte Suche „nicht gefunden“, ist damit nicht bewiesen, dass der Auftrag nie verarbeitet wurde. Der Schnittstellenvertrag muss deshalb festlegen, welche Auskunft verbindlich ist und wie lange ein Vorgang als laufend oder unklar behandelt wird. Wiederholungen erfolgen mit derselben Kennung und kontrollierten Abständen. Fachliche Ablehnungen, etwa wegen einer gesperrten Buchungsperiode, dürfen nicht wie vorübergehende Verbindungsfehler endlos erneut versucht werden.

Für nicht automatisch auflösbare Fälle braucht es eine verantwortliche Stelle und eine Arbeitsliste mit Quellreferenz, Bearbeitungsverlauf und möglicher ERP-Belegnummer. Manuelles Eingreifen sollte protokolliert und an einen Abgleich mit dem ERP gebunden sein. Auch die Aufbewahrung der Verarbeitungsnachweise gehört zum Betriebskonzept: Werden Kennungen früher gelöscht, als Nachrichten erneut eingespielt werden können, verliert die Dublettensperre ihre Wirkung.

  • Fachbereich und IT legen gemeinsam fest, wer unklare Buchungszustände entscheidet und dokumentiert.
  • Ein manueller Neustart übernimmt die ursprüngliche Kennung und umgeht nicht die Dublettenprüfung.
  • Überwachung erfasst überalterte Bearbeitungen und ungelöste Fälle, nicht nur technische Verfügbarkeit.
  • Aufbewahrung und Wiederherstellung berücksichtigen auch spätere Neuimporte und Wiederanläufe aus Sicherungen.

Die Abnahme muss Fehlerfälle statt nur Erfolgsfälle prüfen

Bei Auswahl und Einführung sollte die sichere Wiederholung als überprüfbare Anforderung formuliert werden. Eine erfolgreiche Testbuchung sagt wenig über das Verhalten bei Antwortverlust, Parallelverarbeitung oder Neustart aus. Anbieter und Implementierungspartner sollten zeigen, wo die Vorgangskennung gespeichert wird, welche Komponente ihre Eindeutigkeit durchsetzt und wie ein vorhandenes Buchungsergebnis nachträglich ermittelt wird. Dabei zählt die konkret angebotene Schnittstelle, nicht eine allgemeine Produkteigenschaft.

Die Abnahme sollte gezielt Unterbrechungen an kritischen Stellen erzeugen: nach der Annahme, während der Verarbeitung und nach erfolgreicher Buchung vor Zustellung der Antwort. Nach jedem Versuch werden Quellauftrag, Integrationsprotokoll und ERP-Beleg miteinander abgeglichen. Erwartet wird nicht lediglich eine Fehlermeldung ohne Dublette, sondern ein fachlich vollständiger und nachvollziehbarer Abschluss. Ein unterdrückter Auftrag ohne Buchung ist ebenso ein Fehler wie eine doppelte Ausführung.

Die Ergebnisse gehören in die Betriebsdokumentation und in wiederholbare Regressionstests. Änderungen an Schnittstellen, Integrationsdiensten oder Buchungslogik können die Absicherung beeinflussen. Wenn das ERP keine ausreichende technische Garantie bietet, muss die verbleibende Lücke ausdrücklich bewertet werden. Ein manueller Abgleich kann dann eine Ersatzkontrolle sein, ist aber kein gleichwertiger Nachweis für eine automatisch wiederholungssichere Verarbeitung.

  • Denselben Auftrag nacheinander und parallel senden: Es entsteht nur der vorgesehene fachliche Effekt.
  • Die Antwort nach erfolgreicher Buchung unterbrechen: Der Wiederanlauf findet das vorhandene Ergebnis.
  • Denselben Schlüssel mit verändertem Betrag senden: Der Konflikt wird sichtbar und kontrolliert abgewiesen.
  • Die Verarbeitung zwischen Annahme und Abschluss neu starten: Kein Auftrag geht unbemerkt verloren.
  • Einen älteren Auftrag erneut einspielen: Die vereinbarte Dublettensperre greift auch nach dem regulären Tagesbetrieb.

KOSTENLOSES KI-RANKING

Passende ERP-Anbieter finden

Starten Sie den neutralen Vergleich in wenigen Minuten – kostenlos und unverbindlich.

Unverbindlich & schnell

Passend dazu weiterlesen