#Zustellung und Wiederholungen

#Wann wiederholt wird

Zugestellt ist eine Nachricht, wenn Ihr Endpunkt innerhalb von 10 Sekunden mit einem Status 2xx antwortet. Weiterleitungen (3xx) werden nicht verfolgt und zählen als Fehlschlag. Nach 7 Versuchen ist die Zustellung endgültig gescheitert (DEAD_LETTER); im Echtbetrieb bekommt Ihr technischer Ansprechpartner dann eine E-Mail. Im Portal lässt sich jede Zustellung erneut senden.

Ein endgültig gescheiterter Webhook hält den Auftrag nicht auf — die Überführung läuft weiter, nur Ihr System erfährt es nicht. Deshalb die Meldung an Ihren technischen Ansprechpartner, und deshalb der Stand jederzeit über GET /api/v1/extern/orders/{id}/status.

#So antwortet Ihr Endpunkt richtig

• Schnell bestätigen, dann verarbeiten. Antworten Sie mit 200 oder 204, sobald die Signatur stimmt und die Nachricht gespeichert ist. Lange Verarbeitung (ERP-Buchung, Folgeaufrufe) gehört in eine Warteschlange. Nach zehn Sekunden gilt der Versuch als gescheitert — auch wenn Ihr System danach erfolgreich war.
• Doppelt ist normal. Ist Ihre Bestätigung unterwegs verloren gegangen, kommt dieselbe Nachricht noch einmal. Merken Sie sich die id aus dem Umschlag und verarbeiten Sie jedes Ereignis nur einmal — sie ist bei jedem Versuch und an jedem Ihrer Endpunkte dieselbe. X-LogiCar-Delivery kennzeichnet dagegen die Zustellung an genau diesen Endpunkt.
• Reihenfolge nicht voraussetzen. Nach einer Störung kommen Wiederholungen später als jüngere Nachrichten. Maßgeblich sind createdAt und data.status, nicht die Ankunft. Im bisherigen Format: timestamp und newStatus.
• Fehler ehrlich melden. Antwortet Ihr Endpunkt mit 2xx, obwohl er nichts gespeichert hat, gibt es keine Wiederholung. Mit 5xx sagen Sie: bitte später noch einmal.
• Keine Weiterleitung. Eine 3xx-Antwort zählt als Fehlschlag.

#Erneut senden

Im Portal unter Einstellungen → Webhooks zeigt das Protokoll jedes Endpunkts die Zustellungen mit Stand:

Jede Zustellung lässt sich erneut senden — mit derselben id und derselben X-LogiCar-Delivery, damit Ihr System sie als Wiederholung erkennt. Ein Klick bricht einen laufenden Plan nicht ab, und eine schon zugestellte Nachricht bleibt zugestellt, auch wenn der Nachversand scheitert.