Mesurer les délais de paiement fournisseurs

# Délais de paiement fournisseurs

## But

Mesurer en combien de jours les factures fournisseurs sont réellement payées, et si elles le sont avant ou après leur échéance. Repérer les fournisseurs payés systématiquement en retard, et ceux payés bien avant l'échéance.

## D'où vient la date de paiement

Une dépense ne porte **pas** de date de paiement. La date réelle est sur le **règlement** : `clearedAt`. La date d'export comptable n'est pas une date de paiement et ne doit pas servir de substitut.

Le lien se fait dans ce sens : règlement → `allocations[].payableId` → dépense.

## Étape 1 — Lister les paiements de la période

Annoncer la période exacte (par exemple les 3 derniers mois).

```json
{
  "tool": "get_settlements",
  "params": {
    "clearedFrom": "2026-07-01T00:00:00.000Z", "clearedTo": "2026-09-30T23:59:59.999Z",
    "types": ["payment"], "pageSize": 1000
  }
}
```

`types: ["payment"]` garde les paiements aux fournisseurs et écarte remboursements de collaborateurs, avances et avoirs. Paginer avec `page` tant que `hasNextPage` est `true`.

Relever pour chaque règlement : `clearedAt`, `billingAmount`, et les `payableId` de ses `allocations`. Un règlement sans allocation ne peut pas être rattaché à une facture : le compter à part.

## Étape 2 — Lire la facture payée

```json
{ "tool": "get_payable_by_id", "params": { "id": "<payableId>" } }
```

Lire `payableDate` (date de la facture), `invoiceDueDate` (échéance, peut être absente), `payableType` et `counterparty.name`. Ne garder que les `invoicePurchase`.

Un appel par facture : borner la période pour rester sur un volume raisonnable, et dire combien de paiements ont été analysés.

## Étape 3 — Calculer

Pour chaque paiement :

- **délai de paiement** = `clearedAt` − `payableDate`, en jours ;
- **écart à l'échéance** = `clearedAt` − `invoiceDueDate` : positif = payé en retard, négatif = payé en avance. Non calculable sans échéance.

Une facture payée en plusieurs fois a plusieurs règlements : retenir la date du dernier pour le délai, et le dire.

Puis, sur l'ensemble :

- délai moyen, et délai moyen pondéré par les montants ;
- part des factures payées après l'échéance ;
- par fournisseur : délai moyen, nombre de factures, écart moyen à l'échéance.

## Rapport

```
Délais de paiement — règlements du <date> au <date> (N paiements analysés)

Délai moyen : X jours (pondéré par montant : Y jours)
Payées après l'échéance : N sur M (Z %)

| Fournisseur | Factures | Délai moyen | Écart moyen à l'échéance |

🔴 Payés en retard de façon répétée : …
💡 Payés bien avant l'échéance sur de gros montants : …
```

## Limites à dire

- Ce délai mesure facture → paiement. Ce n'est pas le DPO au sens comptable (dettes fournisseurs rapportées aux achats) : ne pas l'appeler ainsi sans le préciser.
- Les conditions de paiement contractuelles ne sont pas dans Spendesk : seule l'échéance saisie sur la facture sert de référence.
- Les paiements faits hors Spendesk n'apparaissent pas.

## Résultat observé (compte démo, 5 octobre 2026)

Deux paiements en septembre 2026 pour EUR 10 613,50. L'un réglait le 16 septembre une facture datée du 12 septembre et due le 12 octobre : payée 4 jours après son émission, soit 26 jours avant l'échéance.

## Exemples de prompts
- "En combien de jours payons-nous nos fournisseurs en moyenne ?"
- "Quels fournisseurs payons-nous systématiquement après l'échéance ?"
- "Payons-nous certains fournisseurs bien avant l'échéance ?"