Zwangsvollstreckung
-
3
 Min. Lesezeit

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

Verpassten Webhook bei der Starter-Integration wiederherstellen

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

  1. 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.
  2. 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.
  3. 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

Drei aktuelle Einziehungsentscheidungen
Vorhandene AnfrageWas ist passiert?Aktueller Lesevorgang oder FehlerAnzeige und nächster Bearbeiter
Anfrage A · INV-41Dasselbe 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-42Der 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-43Der 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.

RechnungszeileAnforderungsreferenzAuslöserVersuchszeitpunkt UTCZuletzt bestätigter StatusAktuelles LeseergebnisLink fortsetzenNächster Verantwortlicher
INV-41Anfrage AWiederkehrendes Ereignis10:03eingereichtFall in der PrüfungAusgeblendetIntegration
INV-42Anfrage BGespielte Rückkehr10:06awaiting_signatureAktueller Link zurückgegebenAngezeigtBenutzer
INV-43Anfrage CManuelle Aktualisierung10:08Muss korrigiert werden um 09:58 UTCZeitüberschreitungAusgeblendetVerantwortlicher 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

Abonnement

Für unseren Newsletter anmelden

Erhalten Sie aktuelle Informationen über bewährte Methoden, Tipps und Tricks zum Thema Auslandsinkasso und Debitorenbuchhaltung.

Vielen Dank! Ihre Anfrage wurde empfangen!
Hoppla! Beim Absenden des Formulars ist etwas schiefgelaufen.