Bevor Sie eine Verbindung zwischen Ihrem Bestell-, Lager- oder Buchhaltungssystem freigeben, fragen Sie, was passiert, wenn dasselbe Update zweimal eintrifft. Die Zustellung muss vielleicht wiederholt werden. Die Rechnung, der Versandauftrag oder die Nachricht an den Kunden kann jedoch bereits vorliegen.
Eine fehlende Antwort lässt eine Frage offen
Stellen Sie sich vor, ein System sendet ein Update und das empfangende System erledigt seine Arbeit. Die Erfolgsbestätigung geht auf dem Rückweg verloren. Der Absender wartet, sein Zeitlimit läuft ab und er versucht es erneut.
Das Zeitlimit erklärt, warum eine weitere Zustellung erfolgte. Es sagt Ihnen nicht, ob der erste Versuch abgeschlossen wurde. Wiederholungsversuche abzuschalten kann Arbeit offenlassen; jede Geschäftsaktion zu wiederholen kann zusätzliche Arbeit verursachen.
Malcolm Featonby beschreibt diese Unsicherheit im Beitrag der Amazon Builders’ Library über sichere Wiederholungen mit idempotenten APIs. Stripe und Shopify dokumentieren ebenfalls mehrfach zugestellte Webhooks. Ein Webhook ist ein automatisches Update, das von einem System an ein anderes gesendet wird. Dieses Verhalten sollten Sie besprechen, bevor die Verbindung in Betrieb geht.
Welche Aktion soll nur einmal erfolgen?
Nehmen wir einen Online-Shop, bei dem ein Update zu einer bezahlten Bestellung genau einen Fulfillment-Auftrag auslösen soll. Diese drei Situationen müssen unterschiedlich behandelt werden:
Dasselbe Update trifft erneut ein
Der Fulfillment-Auftrag kann bereits bestehen. Eine weitere Zustellung sollte innerhalb der vereinbarten Grenzen keinen zusätzlichen Auftrag für dieselbe beabsichtigte Aktion anlegen.
Ein anderes Update betrifft dieselbe Bestellung
Eine Adressänderung oder Stornierung kann andere Arbeit erfordern. Dieselbe Bestellnummer bedeutet nicht, dass jedes Update überflüssig ist.
Der Kunde gibt eine zweite Bestellung auf
Eine neue Bestellung muss weiterhin bearbeitet werden, selbst wenn Kunde, Artikel und Gesamtbetrag gleich aussehen. Ähnliche Angaben beweisen nicht, dass es sich um eine Wiederholung handelt.
Fragen Sie den Anbieter, woran die beabsichtigte Aktion erkannt wird und wie diese Identität bei einer weiteren Zustellung erhalten bleibt. Sie müssen den technischen Mechanismus nicht auswählen. Sie brauchen aber eine Erklärung, warum das System eine Wiederholung erkennt und zugleich tatsächlich neue Arbeit zulässt.
Die Details unterscheiden sich je nach Anbieter. Die Stripe-Dokumentation behandelt wiederholte Ereignisse und separate Ereignisse zum selben Objekt. Shopify unterscheidet eine einzelne Zustellung von der Händleraktion dahinter. Eine Kennung, die für einen Zweck nützlich ist, ist nicht automatisch die richtige Regel für jede Geschäftsaktion.
Beispiele finden Sie in der Stripe-Dokumentation zu Webhooks und im Shopify-Leitfaden zur Überprüfung von Zustellungen. Der Anbieter sollte das aktuelle Verhalten der Systeme prüfen, die Sie tatsächlich verbinden.
Finden Sie heraus, was geschieht, wenn nur ein Teil der Arbeit gelingt
Angenommen, der Fulfillment-Auftrag wird angelegt, aber die Verbindung bricht ab, bevor sie den Abschluss speichert. Wie findet sie beim nächsten Versuch den vorhandenen Auftrag? Was passiert, wenn zwei Kopien gleichzeitig eintreffen? Eine Liste zuvor erfasster Updates beantwortet für sich genommen keine dieser Fragen.
Bitten Sie darum, drei Dinge getrennt zu zeigen: den Nachweis, dass das Update eingegangen ist, den Verarbeitungsstatus der Verbindung und den Nachweis der daraus entstandenen Aktion im empfangenden System. Eine Zustellbestätigung allein belegt möglicherweise nicht, dass der Versandauftrag oder die Rechnung existiert.
Wenn das Ergebnis ungewiss bleibt, vereinbaren Sie, wer den Fall untersucht und was geprüft wird, bevor ein weiterer Versuch erlaubt ist. Geben Sie den Mitarbeitenden klare Grenzen: welche Aktionen sie fortsetzen dürfen, wann sie die Hilfe des Anbieters brauchen und wann sie stoppen sollen, um keine weitere Geschäftsaktion auszulösen. Manche Probleme erfordern einen Vergleich der Einträge in verschiedenen Systemen und eine Entscheidung durch einen Menschen.
„Versuchen Sie es erneut“ hilft nur, wenn klar ist, was ein weiterer Versuch auslösen darf und wer übernimmt, falls das Ergebnis unklar bleibt.
Bitten Sie um eine sichere Demonstration
Verwenden Sie eine unterstützte Testumgebung mit erfundenen Datensätzen und deaktivierten externen Geschäftsaktionen. Die Demonstration sollte dieselbe Zustellung zweimal, eine tatsächlich zweite Bestellung und einen Fehler nach dem erfolgreichen Abschluss eines Schritts abdecken. Prüfen Sie die resultierenden Einträge ebenso wie das Zustellprotokoll. Wiederholen Sie niemals eine echte Zahlung oder Bestellung, nur um herauszufinden, was passiert.
Bitten Sie um eine kurze schriftliche Beschreibung des Auslösers, der beabsichtigten Aktion, der Erkennung einer Wiederholung und des Ortes, an dem Mitarbeitende das Ergebnis sehen. Halten Sie fest, wie lange sich die Verbindung an frühere Arbeit erinnert, was bei einer verspäteten Zustellung geschieht und wer eine ungewisse oder teilweise abgeschlossene Aktion bearbeitet.
Wenn sich ein bestimmter Fehler in den Systemen nicht sicher demonstrieren lässt, dokumentieren Sie diese Lücke und vereinbaren Sie mit dem Anbieter eine gezieltere Prüfung. Ein erfolgreicher Test belegt das Verhalten unter diesen Bedingungen. Er garantiert keine genau einmalige Ausführung über alle verbundenen Dienste hinweg und beweist nicht, dass eine ganze Abfolge als unteilbarer Vorgang abgeschlossen wird.
Wir entwickeln Integrationen und individuelle Unternehmenssoftware. Wenn Sie eine Verbindung planen, bringen Sie die beteiligten Systeme, die auszulösende Aktion und das noch ungeklärte Verhalten bei Wiederholungen mit. Wir können den Aufwand für diese Verbindung besprechen.
Fragen vor der Freigabe der Verbindung
Bedeutet ein Zeitlimit, dass der erste Versuch fehlgeschlagen ist?
Nein. Die Arbeit kann abgeschlossen worden sein, während die Antwort verloren ging. Prüfen Sie das Verarbeitungsergebnis und das empfangende System, bevor Sie entscheiden, was ein weiterer Versuch auslösen soll.
Können zwei gleich aussehende Bestellungen beide gültig sein?
Ja. Ein Kunde kann bewusst eine zweite Bestellung mit denselben Artikeln und demselben Gesamtbetrag aufgeben. Die Verbindung muss eine neue Absicht von einer wiederholten Zustellung unterscheiden; gleiche Angaben allein reichen dafür nicht.
Wie können wir das Verhalten bei Wiederholungen sicher testen?
Bitten Sie um eine unterstützte Testumgebung mit erfundenen Datensätzen und deaktivierten externen Geschäftsaktionen. Berücksichtigen Sie eine Wiederholung, eine tatsächlich neue Aktion und einen Fehler, nachdem ein Teil der Arbeit abgeschlossen ist. Dokumentieren Sie Testlücken, statt mit echten Bestellungen oder Zahlungen zu experimentieren.
Wer sollte eine teilweise abgeschlossene Aktion klären?
Legen Sie vor dem Start eine konkrete Person oder ein verantwortliches Team fest. Mitarbeitende müssen wissen, was sie selbst prüfen oder fortsetzen dürfen und wann der Anbieter den Fall untersuchen muss, bevor eine weitere Aktion erlaubt wird.
