Verpassten Webhook bei der Starter-Integration wiederherstellen
Wiederherstellung eines veralteten Rechnungsstatus nach einem verpassten Webhook. Behandeln Sie doppelte Zustellungen, fehlende Ereignisse und fehlgeschlagene aktuelle Abrufe.
Von Lars Holdgaard, Gründer & CEO von Debitura

Wenn eine Debitura-Inkassoanfrage veraltet wirkt, rufen Sie die aktuelle Anfrage über deren gespeicherte ID von Ihrem Server ab. Aktualisieren Sie die entsprechende Rechnungszeile anhand dieses Ergebnisses. Lassen Sie den zuletzt bestätigten Status mit einer Warnung sichtbar, falls der Abruf fehlschlägt, und blenden Sie veraltete Weiter-Links aus, bis eine neue Antwort vorliegt.
Bestehende Rechnungszeilen abgleichen
- Führen Sie die bestehenden Anfragen auf, die von der verpassten Aktualisierung betroffen sind. Halten Sie Partnerkonto, Mandantenzuordnung, Rechnungszeile und Debitura-Anfrage-ID zusammen. Eine Inkassoanfrage-ID identifiziert die Anfrage. Die Fall-ID identifiziert den daraus resultierenden Fall.
- Führen Sie einen serverseitigen
GET /collection-requests/{id}aus nach der Rückkehr aus dem gehosteten Setup, nach einem verifizierten Webhook oder bei einer manuellen Überprüfung. Lesen Sie alle betroffenen bekannten Anfragen aus, falls ein gemeinsam genutzter Einrichtungsschritt mehr als eine geändert haben könnte. Verwenden Sie dieselbe Umgebung wie bei der ursprünglichen Anfrage. - Aktualisieren Sie die Anzeige mit dem aktuellen Status und dem Ergebnis aus der Antwort. Zeigen Sie „Weiter“ nur an, wenn der aktuelle Status eine Aktion des Kunden erfordert und die aktuelle Antwort den entsprechenden Link enthält. Wenn das Lesen fehlschlägt, kennzeichnen Sie das zuletzt geprüfte Ergebnis mit der Uhrzeit und einem Aktualisierungsfehler. Halten Sie veraltete Links verborgen und wiederholen Sie den Lesevorgang gemäß Ihrer Richtlinie für Wiederholungsversuche.
Drei fiktive Einziehungsentscheidungen
| Vorhandene Anfrage | Was ist passiert? | Aktueller Lesevorgang oder Fehler | Anzeige und nächster Bearbeiter |
|---|---|---|---|
| Anfrage A · INV-41 | Dasselbe verifizierte Ereignis ist zweimal eingegangen. | 10:03 UTC · eingereicht, Fall-ID vorhanden, Fallstatus wird noch verifiziert. | Zeigen Sie den Fall und dessen tatsächlichen Status an. Duplizieren Sie das wiederholte Ereignis im Handler und erfassen Sie die Realisierung für die bestehende Rechnungszeile. |
| Anfrage B · INV-42 | Der Nutzer ist vom gehosteten Setup zurückgekehrt, und es wurde kein Ereignis registriert. | 10:06 UTC · awaiting_signature, aktueller Aktionslink vorhanden. | „Weiterlesen von hier aus“ anzeigen. Der Nutzer kann die verknüpfte Aktion öffnen, und die Integration überprüft die Anfrage bei Rückkehr erneut. |
| Anfrage C · INV-43 | Der Nutzer hat „Aktualisieren“ gewählt, und das aktuelle Abrufen ist zeitlich überschritten. | 10:08 UTC · Kein neuer Status. Das letzte bestätigte Ergebnis um 09:58 UTC war needs_fixing. | Behalten Sie den vorherigen Status als zuletzt geprüft bei, zeigen Sie den Aktualisierungsfehler an und blenden Sie Weiter aus. Der Integrationseigentümer prüft das Anforderungs-Mapping und die Protokolle, wenn Wiederholungsversuche weiterhin fehlschlagen. |
Mit Nachweisen eskalieren
Teilen Sie dem Implementierungsverantwortlichen die Anforderungs-ID, die Rechnungsreferenz, die Umgebung, die Zeit des letzten erfolgreichen Abrufs, die Zeit des fehlgeschlagenen Versuchs und die Fehlerklasse mit. Halten Sie Schlüssel, Signierungsgeheimnisse, unverarbeitete Kundendaten und URLs gehosteter Aktionen aus dem Wiederherstellungsprotokoll heraus. Eine Weiterleitung, ein verpasstes Ereignis und eine Zeitüberschreitung lassen den aktuellen Status jeweils so lange unbestätigt, bis ein erfolgreicher Abruf erfolgt. Verwenden Sie für die Wiederherstellung die bestehende Anfrage. Eine neue Einreichung hat einen anderen Zweck und sollte dem dokumentierten Einreichungsprozess folgen.
Wiederherstellungsprotokoll kopieren
Fügen Sie die tabulatorgetrennten Zeilen in eine Tabellenkalkulation ein. Behalten Sie bei jedem Zeitstempel die Zeitzone bei und dokumentieren Sie, wer für welche offene Prüfung zuständig ist.
| Rechnungszeile | Anforderungsreferenz | Auslöser | Versuchszeitpunkt UTC | Zuletzt bestätigter Status | Aktuelles Leseergebnis | Link fortsetzen | Nächster Verantwortlicher |
|---|---|---|---|---|---|---|---|
| INV-41 | Anfrage A | Wiederkehrendes Ereignis | 10:03 | eingereicht | Fall in der Prüfung | Ausgeblendet | Integration |
| INV-42 | Anfrage B | Gespielte Rückkehr | 10:06 | awaiting_signature | Aktueller Link zurückgegeben | Angezeigt | Benutzer |
| INV-43 | Anfrage C | Manuelle Aktualisierung | 10:08 | Muss korrigiert werden um 09:58 UTC | Zeitüberschreitung | Ausgeblendet | Verantwortlicher für die Integration |
Lesen Sie die Integrationsleitfäden
Nutzen Sie das Starter-Integrationsrezept und die Referenz für Inkassoanfragen bezüglich der Anfragestruktur, der Signaturüberprüfung und der Ereignis-Deduplizierung. Der integrierte Leitfaden zum Inkasso erläutert, wie sich der Inkassoschritt in Ihr Produkt einfügt.
Erfahren Sie, wie Sie Inkasso integrieren
Referenzen
-min.webp)
Für unseren Newsletter anmelden
Erhalten Sie aktuelle Informationen über bewährte Methoden, Tipps und Tricks zum Thema Auslandsinkasso und Debitorenbuchhaltung.

.webp)