Exécution forcée
-
3
 min de lecture

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

Récupérez un webhook manqué dans l'intégration de démarrage

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

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

Trois décisions de recouvrement à l'état actuel
Demande existanteCe qui s'est produitLecture actuelle ou erreurAffichage et prochain responsable
Demande A · INV-41Le 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-42L'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-43L'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 factureRéférence de la demandeDéclencheurHeure de la tentative UTCDernier statut confirméRésultat de lecture actuelLien de continuationProchain responsable
INV-41Demande AÉvénement répété10:03soumisDossier en cours de vérificationMasquéIntégration
INV-42Demande BRetour hébergé10:06en_attente_de_signatureLien actuel renvoyéAffichéUtilisateur
FACTURE-43Demande CActualisation manuelle10:08needs_fixing à 09:58 UTCDé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

Abonnement

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.

Merci ! Votre soumission a été reçue !
Oups ! Une erreur s'est produite lors de la soumission du formulaire.