Relances de recouvrement

Repérez chaque semaine les clients en retard de paiement et envoyez-leur un avis adapté à leur retard : rappel courtois, deuxième avis, puis dernier avis. Le responsable du recouvrement reçoit en plus un sommaire.


Pour qui	Comptes clients, responsable du recouvrement
Fréquence	Une fois par semaine
Clé API	Lecture seule
Appels	1 pour la liste des retards, puis 1 par client relancé

Le principe

Qui est en retard ? Un seul appel à GET /api/receivables/to-collect avec days_overdue_min=1 liste toutes les factures échues, tous clients confondus. Les crédits non appliqués de ces clients restent listés (is_credit=true, montant négatif) : ils viennent en déduction.

Quel niveau de relance ? Pour chaque client, le plus grand retard décide du ton de l'avis.

À qui écrire ? GET /api/customers/by-id/{customer_id} donne le courriel principal et la langue du client.

Envoi et sommaire. Un avis par client ; un sommaire pour le responsable du recouvrement.

Plus grand retard	Niveau	Ton
1 à 30 jours	1	Rappel courtois
31 à 60 jours	2	Deuxième avis
Plus de 60 jours	3	Dernier avis, et appel du responsable

Les seuils sont des exemples : adaptez-les à votre politique de crédit.

Pourquoi pas l'âge des comptes ?

L'âge des comptes (/api/customers/aging) donne un solde par client. La liste des comptes à recevoir donne une ligne par facture échue, avec son retard : c'est ce qu'il faut pour citer les factures dans l'avis et choisir le niveau de relance.

Le script

Python

JavaScript (Node.js)

Réponse utilisée

{
  "as_of_date": "2026-05-13",
  "summary": { "net_to_collect": 385100.0, "customers_count": 42, "invoices_due_count": 142 },
  "items": [
    {
      "customer": { "id": 211, "code": "ATEL-FIC", "name": "Atelier Fictif enr." },
      "invoice": { "id": 2214, "code": "15418", "date": "2026-02-01" },
      "due_date": "2026-03-03",
      "days_overdue": 71,
      "amount_remaining": 1500.0,
      "is_credit": false
    },
    {
      "customer": { "id": 211, "code": "ATEL-FIC", "name": "Atelier Fictif enr." },
      "invoice": { "id": 2290, "code": "15466", "date": "2026-04-20" },
      "due_date": "2026-04-20",
      "days_overdue": 0,
      "amount_remaining": -350.0,
      "is_credit": true
    }
  ],
  "metadata": { "truncated": false }
}

Bon à savoir

Montants nets. Les clients dont le solde net est nul ou créditeur ne sont pas listés. Le script saute aussi un client dont les crédits couvrent les factures échues.

Paiements reçus après la dernière lecture. La liste est gardée 4 heures en cache pour la date du jour. Si des paiements viennent d'être saisis dans Acomba, ajoutez force_refresh=true avant l'envoi.

Pas de doublon d'une semaine à l'autre ? Le niveau monte avec le retard ; un client reçoit le même niveau tant que son retard reste dans la même tranche. Pour ne relancer qu'aux changements de niveau, gardez de votre côté le dernier niveau envoyé par client.

Clients sans courriel. Ils apparaissent dans le sommaire avec la mention « SANS COURRIEL » : le responsable les appelle.

Liste tronquée. Au-delà de 5 000 lignes, le script s'arrête plutôt que d'oublier des clients : augmentez days_overdue_min ou traitez par tranche.

Premier lancement. S'il y a de vieux comptes en souffrance, le premier passage enverrait surtout des derniers avis. Commencez par le sommaire seul (sans avis aux clients) et faites le ménage des vieux comptes avant d'activer les envois.

Essai à blanc d'abord. Remplacez les envois par un affichage, comparez quelques avis avec Acomba, puis activez l'envoi.

Pour aller plus loin. Le détail d'un client (toutes ses factures ouvertes, échues ou non) : GET /api/customers/by-id/{customer_id}/unpaid-invoices.

Le principe#

Le script#

Réponse utilisée#

Bon à savoir#

Le principe

Le script

Réponse utilisée

Bon à savoir