Relances et suivi
Quand Wajub relance votre client d'une facture impayée, et comment assurer le suivi depuis votre propre code.
Wajub relance par e-mail votre client d'une facture impayée, avant et après son échéance, que vous ayez envoyé la facture par l'API ou depuis le Dashboard. Les relances sont actives tant que vous ne les désactivez pas.
Quand partent les relances
Chaque relance tombe un jour compté à partir du due_date de la facture. Tant que vous n'en
choisissez pas d'autres, ce sont :
| Relance | Jour |
|---|---|
| Une semaine avant | due_date − 7 |
| Trois jours avant | due_date − 3 |
| La veille | due_date − 1 |
| Un jour de retard | due_date + 1 |
| Une semaine de retard | due_date + 7 |
Paramètres → Facture → Rappels automatiques dans le Dashboard choisit d'autres jours, 1, 3, 7 ou 14 jours avant ou après l'échéance, ou désactive les relances. Le choix vaut pour toutes les factures du compte : aucune facture ne les désactive à elle seule, ni par l'API ni ailleurs.
Une relance dont le jour tombe le jour de l'envoi de la facture ou avant est sautée : une facture envoyée après son échéance n'est relancée que les jours encore à venir. Une relance ne tombe jamais un jour où le client a déjà été relancé. Quand plusieurs relances sont dues en même temps, seule la plus récente part, et aucune ne part plus d'une semaine après son jour.
Qui reçoit quoi
Une facture est relancée quand elle a un due_date, qu'elle a été envoyée (sent, viewed,
partial ou overdue) et qu'il reste quelque chose à payer. L'e-mail part au client que désigne
customer_id, sinon à customer_email ; une facture sans l'un ni l'autre n'est pas relancée. Les
brouillons, les devis et les estimations ne le sont jamais.
La relance est rédigée dans la language de la facture, avec le PDF en pièce jointe. Elle indique
le numéro de la facture, le montant restant dû et l'échéance, avec un bouton vers la page de la
facture. Une facture partiellement payée est relancée pour ce qu'il reste.
Une relance n'envoie aucun webhook et ne change rien à la facture.
Ce qui arrête les relances
Le paiement, l'annulation ou le remboursement de la facture, ou plus rien à payer. Une relance sur le point de partir quand la facture a été payée n'est pas envoyée.
Effectuer le suivi depuis votre propre code
Pour assurer le suivi sur un autre canal, comme le SMS ou WhatsApp, ou selon votre propre calendrier, vous disposez de deux signaux qui fonctionnent différemment.
Le premier est la liste, filtrée sur les montants encore dus.
curl "https://api.wajub.com/invoices?status=overdue&payment_status=unpaid" \
-H "Authorization: sk.xxxxxxxxxxxxxxxx…"payment_status accepte unpaid, partially_paid ou fully_paid. Il filtre selon ce qui a
réellement été reçu, pas selon le libellé du statut. due_date_from et due_date_to délimitent la
période lorsque vous cherchez les factures échues cette semaine plutôt que leur totalité.
Le statut overdue peut avoir un jour de retard
Rien ne fait passer une facture à overdue à minuit. Ce passage a lieu pendant la nuit une fois
due_date passée. Une facture arrivée à échéance ce matin reste donc au statut sent jusqu'au lendemain.
Pour faire la distinction le jour même, comparez vous-même due_date à la date actuelle au lieu
de filtrer sur le statut.
Le second signal est le webhook. Il présente une lacune dont vous devez tenir compte.
invoice.updatedévénementCette lacune concerne le statut overdue. Les factures passent à overdue pendant la nuit, et ce
changement n'envoie aucun webhook.
Vous devez rechercher cette situation, elle ne vous est pas signalée.
Le modèle qui fonctionne consiste à conserver votre propre liste de factures ouvertes, à la contrôler selon votre propre calendrier et à envoyer vous-même une relance sur le canal que le client consulte vraiment. Le message doit contenir l'URL de paiement, que vous reconstruisez à partir de l'identifiant de la facture.
https://invoice.wajub.com/inv_LRQqYvlhrgUOE225KMKUPages associées
- FacturesLe document, sa page de paiement et son cycle de vie complet.
- Démarrage rapideÉmettre une facture et obtenir son paiement, du début à la fin.
- Factures récurrentesCe que configure l'indicateur de récurrence, et ce qu'il ne fait pas.
- WebhooksLa place d'invoice.updated aux côtés de payment.succeeded.
- Référence API des facturesTous les filtres de l'endpoint de liste.