Récupérez un webhook manqué dans l'intégration de démarrage
Rétablir le statut obsolète d'une facture suite à un webhook manqué. Gérez la livraison en double, l'absence d'événement et l'échec de la lecture actuelle.
Par Lars Holdgaard, fondateur et dirigeant de Debitura

Si une demande de recouvrement Debitura semble obsolète, lisez la demande actuelle à partir de votre serveur en utilisant son identifiant de demande enregistré. Mettez à jour la ligne de facture correspondante à partir de ce résultat. Conservez le dernier état confirmé visible avec un avertissement en cas d'échec de la lecture et masquez tout ancien lien Continuer jusqu'à ce que vous obteniez une nouvelle réponse.
Rapprochez les lignes de factures existantes
- Répertoriez les demandes existantes affectées par la mise à jour manquée. Conservez ensemble le compte partenaire, votre correspondance client, la ligne de facture et l'identifiant de demande Debitura. Un identifiant de demande de recouvrement identifie la demande. L'identifiant de dossier identifie le dossier qui en résulte.
- Exécutez un traitement côté serveur
GET /collection-requests/{id}après un retour de configuration hébergée, après un webhook vérifié ou lors d'une nouvelle vérification manuelle. Lisez toutes les demandes connues concernées si une étape de configuration partagée a pu en modifier plusieurs. Utilisez le même environnement que la demande initiale. - Remplacez l'affichage par le statut actuel et le résultat de la réponse. Affichez Continuer uniquement lorsque le statut présent nécessite une action du client et que la réponse actuelle fournit son lien. Si la lecture échoue, étiquetez le dernier résultat vérifié avec son heure et une erreur d'actualisation. Gardez les liens obsolètes hors de vue et réessayez la lecture en utilisant votre politique de nouvelle tentative.
Trois décisions de recouvrement fictives
| Demande existante | Ce qui s'est produit | Lecture actuelle ou erreur | Affichage et prochain responsable |
|---|---|---|---|
| Demande A · INV-41 | Le même événement vérifié est arrivé deux fois. | 10:03 UTC · soumis, identifiant du dossier présent, statut du dossier toujours en cours de vérification. | Afficher le dossier et son statut actuel. Dédupliquer l'événement répété dans le gestionnaire et enregistrer le recouvrement sur la ligne de facture existante. |
| Requête B · INV-42 | L'utilisateur est revenu de la configuration hébergée et aucun événement n'a été observé. | 10:06 UTC · en_attente_de_signature, lien d'action actuel présent. | Afficher Continuer à partir de cette lecture. L'utilisateur peut ouvrir l'action liée et l'intégration revérifie la requête au retour. |
| Requête C · INV-43 | L'utilisateur a sélectionné Actualiser et la lecture actuelle a expiré. | 10:08 UTC · Aucun nouvel état. Le dernier résultat confirmé à 09:58 UTC était à_corriger. | Conservez le statut précédent étiqueté comme dernière vérification, affichez l'erreur d'actualisation et masquez Continuer. Le responsable de l'intégration vérifie le mappage des requêtes et les journaux si les nouvelles tentatives continuent d'échouer. |
Transmettre avec les justificatifs
Transmettez au responsable de l'intégration l'identifiant de la demande, la référence de la facture, l'environnement, l'heure de la dernière lecture réussie, l'heure de la tentative échouée et la catégorie d'erreur. Ne consignez pas les clés, les secrets de signature, les données client brutes et les URL d'action hébergées dans le journal de récupération. Une redirection, un événement manqué et un délai d'attente laissent chacun l'état actuel incertain jusqu'à une lecture réussie. Utilisez la demande existante pour la récupération. Une nouvelle soumission a un objectif différent et doit suivre le parcours de soumission documenté.
Copier le journal de récupération
Collez les lignes séparées par des tabulations dans un tableur. Conservez le fuseau horaire sur chaque horodatage et indiquez le responsable de chaque vérification en cours.
| Ligne de facture | Référence de la demande | Déclencheur | Heure de la tentative UTC | Dernier statut confirmé | Résultat de lecture actuel | Lien de continuation | Prochain responsable |
|---|---|---|---|---|---|---|---|
| INV-41 | Demande A | Événement répété | 10:03 | soumis | Dossier en cours de vérification | Masqué | Intégration |
| INV-42 | Demande B | Retour hébergé | 10:06 | en_attente_de_signature | Lien actuel renvoyé | Affiché | Utilisateur |
| FACTURE-43 | Demande C | Actualisation manuelle | 10:08 | needs_fixing à 09:58 UTC | Délai dépassé | Masqué | Responsable de l'intégration |
Lire les guides d'intégration
Utilisez le modèle d'intégration de démarrage et la référence de demande de recouvrement pour formater la requête, vérifier la signature et dédupliquer les événements. Le guide de recouvrement intégré explique comment cette étape s'intègre dans votre produit.
Découvrez comment intégrer le recouvrement de créances
Références
-min.webp)
Inscrivez-vous à notre newsletter
Recevez des actualités sur les meilleures pratiques, des conseils et des astuces concernant le recouvrement international de créances et la gestion des comptes clients.

.webp)