Softwareentwicklung & PHP

API überträgt Bestellungen doppelt: Ursachen und Lösungen

Ihre API erzeugt doppelte Bestellungen im ERP? Erfahren Sie, wie Sie Wiederholungen erkennen, Dubletten verhindern und bestehende Schnittstellen prüfen lassen.

3D-Illustration einer Shop-ERP-Integration mit doppelter Bestellung, API-Prüfung und kontrollierter Fehlerbehebung

Ein Kunde bestellt einmal im B2B-Onlineshop. Im ERP-System erscheinen jedoch zwei Aufträge mit denselben Artikeln und Kundendaten. Die Mitarbeiter müssen prüfen, ob bereits Ware reserviert, eine Rechnung vorbereitet oder ein Versand ausgelöst wurde. Solche Fehler entstehen unter anderem dann, wenn eine API denselben Auftrag mehrfach verarbeitet. Wenn eine Schnittstelle doppelte Bestellungen erzeugt, muss zunächst geklärt werden, an welcher Stelle die Wiederholung entsteht und warum das empfangende System sie nicht erkennt.

1. Warum entstehen doppelte Bestellungen durch eine API?

Ein Shop kann Bestellungen automatisch an ein ERP übertragen. Dazu sendet die Anwendung eine Anfrage an die Schnittstelle des Zielsystems.

Normalerweise bestätigt das ERP die Verarbeitung.

Problematisch wird es, wenn eine Antwort ausbleibt oder die beteiligten Systeme den Status einer Übertragung unterschiedlich bewerten.

Ein API-Aufruf wird wiederholt

Angenommen, das ERP legt einen Auftrag erfolgreich an, aber die Bestätigung erreicht den Shop wegen einer Verbindungsstörung nicht.

Der Shop erkennt keine erfolgreiche Antwort und versucht die Übertragung erneut.

Wenn das ERP den Auftrag bei jeder Anfrage neu anlegt, können zwei Bestellungen entstehen.

Mehrere Prozesse verarbeiten denselben Auftrag

Auch Hintergrundaufgaben können Dubletten verursachen.

Beispielsweise lesen zwei parallel laufende Prozesse denselben noch nicht abgeschlossenen Auftrag und versuchen gleichzeitig, ihn zu übertragen.

Ohne geeignete Verarbeitungskontrolle können beide Vorgänge erfolgreich ausgeführt werden.

Unklare Zuordnung im Zielsystem

Wenn Shop und ERP keine eindeutige gemeinsame Auftragskennung verwenden, kann das Zielsystem möglicherweise nicht unterscheiden, ob eine Anfrage einen neuen Auftrag oder die Wiederholung einer bereits übertragenen Bestellung betrifft.

Entscheidend ist deshalb nicht nur, wie oft eine Anfrage gesendet wird, sondern wie das empfangende System wiederholte Anfragen verarbeitet.

2. Praxisbeispiel: Eine Bestellung erscheint zweimal im ERP

Angenommen, ein technischer Großhändler betreibt einen individuell erweiterten PHP-Onlineshop.

Neue Bestellungen werden über eine REST-API an das ERP übertragen.

Ein Geschäftskunde bestellt mehrere Industriekomponenten.

Der Shop speichert die Bestellung und startet die Übertragung.

Was passiert während der Übertragung?

Das ERP nimmt den Auftrag entgegen und legt einen Datensatz an.

Aufgrund einer Zeitüberschreitung erhält die PHP-Anwendung jedoch keine verwertbare Bestätigung.

Ein Wiederholungsmechanismus sendet den Auftrag erneut.

Das ERP behandelt die zweite Anfrage als neuen Auftrag.

Nun existieren zwei ERP-Bestellungen, obwohl der Kunde nur einmal bestellt hat.

Welche Folgen sind möglich?

  • Ware wird möglicherweise doppelt reserviert.
  • Der Versand erhält zwei Aufträge.
  • Die Auftragsübersicht enthält fehlerhafte Daten.
  • Mitarbeiter müssen die Vorgänge manuell abgleichen.
  • Nachgelagerte Rechnungs- oder Lagerprozesse können betroffen sein.

Ob solche Folgen tatsächlich eingetreten sind, muss im jeweiligen System überprüft werden.

Das Beispiel ist fiktiv und beschreibt keine konkrete Kundeninstallation.

3. Wie hilft Idempotenz bei der Vermeidung doppelter Bestellungen?

In der API-Entwicklung bezeichnet Idempotenz eine Eigenschaft, bei der die wiederholte Ausführung einer Operation nicht zu zusätzlichen unerwünschten Auswirkungen führt.

Bei einer Bestellübertragung bedeutet das beispielsweise: Eine bereits erfolgreich angelegte Bestellung darf durch die Wiederholung derselben Anfrage nicht unbemerkt erneut entstehen.

Eindeutige Kennungen verwenden

Ein möglicher Ansatz besteht darin, jede Bestellung mit einer eindeutigen Kennung zu versehen.

Diese Kennung bleibt bei einer Wiederholung der Übertragung gleich.

Das empfangende System kann damit prüfen, ob der betreffende Vorgang bereits verarbeitet wurde.

Voraussetzung ist, dass die gewählte API eine solche Verarbeitung unterstützt oder dass entsprechende Regeln in der Integration umgesetzt werden können.

Warum reicht eine Prüfung vor dem Senden nicht immer aus?

Wenn mehrere Prozesse parallel arbeiten, können beide zunächst feststellen, dass noch kein Auftrag vorhanden ist.

Danach versuchen beide, ihn anzulegen.

Eine einfache vorherige Abfrage verhindert diese Situation nicht zuverlässig.

Je nach Architektur können daher zusätzliche Maßnahmen notwendig sein, etwa eindeutige Datenbankbedingungen, kontrollierte Transaktionen oder eine geeignete Verarbeitungssperre.

Was ist bei externen APIs zu beachten?

Manche APIs bieten eigene Verfahren für idempotente Anfragen an.

Ein dokumentiertes Beispiel findet sich bei Stripe: Idempotent Requests.

Das dort beschriebene Verfahren lässt sich jedoch nicht unverändert auf jede ERP-Schnittstelle übertragen.

Die tatsächlich verfügbaren Funktionen und Einschränkungen müssen anhand der jeweiligen API-Dokumentation geprüft werden.

4. Was sollten Unternehmen bei bereits vorhandenen Dubletten prüfen?

Wenn doppelte Bestellungen entdeckt werden, sollte nicht sofort einer der Aufträge gelöscht werden.

Zunächst muss geklärt werden, welcher Vorgang bereits verarbeitet wurde.

Wichtige Kontrollen bei doppelten Bestellungen
Prüfung Ziel
Shop-Bestellnummer Ursprünglichen Kundenauftrag eindeutig bestimmen
ERP-Auftragsnummern Mehrfach angelegte Datensätze erkennen
Zeitpunkte der Übertragung Mögliche Wiederholungsversuche nachvollziehen
API-Protokolle Anfragen, Antworten und Fehler vergleichen
Bearbeitungsstatus Bereits erfolgte Reservierungen oder Versandvorgänge prüfen
Rechnungsstatus Ungewollte doppelte kaufmännische Verarbeitung ausschließen

Erst danach sollte entschieden werden, wie ein fehlerhaft angelegter Auftrag fachlich korrekt behandelt wird.

Abhängig vom ERP können dafür Stornierungen, Statuskorrekturen oder andere vorgesehene Geschäftsvorgänge erforderlich sein.

Das direkte Löschen von Datenbankeinträgen ist dafür nicht automatisch geeignet.

5. Wie lässt sich eine bestehende Schnittstelle gezielt korrigieren?

Wenn die Ursache in einer vorhandenen Integration liegt, ist nicht zwangsläufig eine vollständige Neuentwicklung erforderlich.

Häufig kann der betroffene Ablauf untersucht und angepasst werden.

  1. Fehler nachvollziehen: Betroffene Bestellungen, API-Aufrufe und Zeitpunkte vergleichen.
  2. Übertragungslogik untersuchen: Feststellen, wann Anfragen wiederholt werden und wie die Anwendung ihren Status speichert.
  3. API-Funktionen prüfen: Klären, ob das Zielsystem eindeutige externe Auftragskennungen oder Idempotenzmechanismen unterstützt.
  4. Verarbeitung absichern: Geeignete Prüfungen, Statusregeln und gegebenenfalls technische Sperren ergänzen.
  5. Fehlerfälle testen: Zeitüberschreitungen, wiederholte Anfragen und parallele Verarbeitung kontrolliert simulieren.
  6. Geschäftsprozess überprüfen: Sicherstellen, dass bestehende Bestellungen korrekt verarbeitet und neue Aufträge nicht unbeabsichtigt doppelt erzeugt werden.

Warum muss auch der Fehlerfall getestet werden?

Eine API kann bei normaler Verbindung zuverlässig funktionieren und dennoch bei einer Zeitüberschreitung unerwünschte Wiederholungen erzeugen.

Deshalb sollte die Prüfung nicht nur aus einer erfolgreichen Testbestellung bestehen.

Wichtig ist auch die Frage, was geschieht, wenn das ERP den Auftrag bereits angelegt hat, der Shop davon aber noch keine Bestätigung erhalten hat.

Diese Situation ist für die Fehlerbehebung oft aussagekräftiger als der normale Ablauf.

6. Doppelte API-Bestellungen mit Kubertino untersuchen

Kubertino unterstützt Unternehmen bei der Untersuchung und Anpassung bestehender PHP-Anwendungen und API-Schnittstellen.

Wenn eine Shop-ERP-Integration doppelte Aufträge erzeugt, kann eine konkrete technische Aufgabe darin bestehen, die vorhandene Übertragungslogik zu prüfen und den betroffenen Programmteil anzupassen.

Für eine erste Einschätzung sind folgende Informationen hilfreich:

  • Welcher Shop und welches ERP sind betroffen?
  • Seit wann entstehen doppelte Bestellungen?
  • Tritt der Fehler regelmäßig oder nur gelegentlich auf?
  • Existieren Beispiele mit Shop- und ERP-Auftragsnummern?
  • Ist der Quellcode der Integration verfügbar?
  • Gibt es technische Protokolle der API-Aufrufe?

Vertrauliche Kunden- und Zugangsdaten sollten nicht ungeschützt übermittelt werden.

Die notwendigen technischen Zugänge werden separat abgestimmt.

Weitere Informationen zur Untersuchung und Anpassung bestehender Software finden Sie auf unserer Leistungsseite PHP-Entwicklung.

Wenn eine zusätzliche Schnittstelle benötigt wird, behandelt unser Beitrag Externe API in bestehende PHP-Anwendung integrieren die technischen Voraussetzungen.

Für Unternehmen mit regelmäßigen Datentransfers kann außerdem unser Beitrag Lieferantenpreislisten automatisch ins ERP übernehmen interessant sein.

Wenn Ihre Schnittstelle doppelte Bestellungen erzeugt, beschreiben Sie uns den betroffenen Ablauf und nennen Sie die beteiligten Systeme. Damit lässt sich klären, ob eine direkte Korrektur möglich ist oder zunächst eine technische Analyse benötigt wird.

7. Häufige Fragen zu doppelten Bestellungen durch APIs

Warum erstellt meine API dieselbe Bestellung zweimal?

Mögliche Ursachen sind wiederholte API-Aufrufe, Zeitüberschreitungen, parallele Verarbeitung oder fehlende Dublettenprüfungen. Die konkrete Ursache lässt sich anhand der betroffenen Aufträge und der technischen Protokolle untersuchen.

Was bedeutet Idempotenz bei einer Bestell-API?

Idempotenz bedeutet in diesem Zusammenhang, dass eine wiederholte Verarbeitung desselben Vorgangs keine zusätzlichen unerwünschten Bestellungen erzeugt. Die technische Umsetzung hängt von den Möglichkeiten der beteiligten Systeme ab.

Kann man doppelte Bestellungen automatisch verhindern?

Geeignete Auftragskennungen, Idempotenzmechanismen und kontrollierte Verarbeitung können das Risiko deutlich reduzieren. Welche Absicherung möglich ist, hängt von der Architektur und den Funktionen der verwendeten API ab.

Sollte ich doppelte ERP-Aufträge einfach löschen?

Nicht ohne vorherige Prüfung. Zunächst muss geklärt werden, ob bereits Waren reserviert, Versandvorgänge ausgelöst oder Rechnungen erstellt wurden. Anschließend sollte der betroffene Vorgang mit den vorgesehenen Funktionen des ERP korrigiert werden.

Muss die bestehende PHP-Schnittstelle komplett neu programmiert werden?

Nicht automatisch. Häufig lässt sich der betroffene Programmteil gezielt anpassen. Ob größere Änderungen notwendig sind, ergibt sich aus der technischen Untersuchung.

Nächster Schritt

Möchten Sie prüfen, was davon für Ihr Unternehmen relevant ist?

Wir prüfen Website, Inhalte, Anfragewege und mögliche Automatisierungspunkte und geben eine klare erste Einschätzung.

KI-Potenzial prüfen Gespräch buchen