Dette fournisseur (payable)
Projection calculée de ce que le marchand doit encore à un fournisseur : factures ouvertes moins avoirs et allocations de décaissements réellement exécutés, avec une lecture séparée des montants échus et contestés.
Rôle
payable est le pendant Accounts Payable du receivable côté client. Il n’est pas une ressource métier autonome avec son propre ID : il est identifié fonctionnellement par le fournisseur et le marchand, puis recalculé à partir des documents et des allocations de paiement actuels.
supplier_payment répond à « quel décaissement avons-nous demandé ou exécuté ? ». Les deux concepts sont liés par les allocations, mais ne sont pas interchangeables.Comment le payable est calculé
Le payable agrège les documents fournisseur non annulés et non soldés, soustrait les avoirs et les allocations rattachées à des supplier_payment exécutés, puis expose la projection courante et ses événements.
Le calcul prend en compte :
- les factures fournisseurs non annulées et non entièrement réglées ;
- les avoirs fournisseurs comme montants négatifs dans le solde ;
- les
payment_allocationdont la source est unsupplier_paymentau statutexecuted; - la date d’échéance et l’état de litige des documents pour calculer les sous-soldes dus et contestés.
executed réduisent la dette projetée. Une instruction pending ou scheduled ne constitue pas encore un mouvement de cash réalisé.Soldes disponibles
| Champ | Question |
|---|---|
balance_excluding_tax / balance_including_tax | Quel est le solde total restant dû au fournisseur ? |
balance_due_* | Quelle part de ce solde est déjà échue à la date de calcul ? |
balance_disputed_* | Quelle part du solde total appartient à des documents en litige ? |
balance_due_disputed_* | Quelle part est à la fois échue et contestée ? |
balance_due_undisputed_* | Quelle dette échue peut être traitée hors litige ? |
oldest_due_date / latest_due_date | Quelle est l’étendue temporelle des documents encore ouverts ? |
computed_at | À quel instant cette projection a-t-elle été calculée ? |
Les montants utilisent common.amount : entiers dans l’unité mineure de la devise.
Avoirs fournisseurs
Une supplier_invoice de type=credit_note réduit le payable. Lorsqu’elle référence une facture source, le calcul reprend la date d’échéance et l’état de litige de cette facture pour déterminer correctement les sous-soldes dus et contestés.
Cette logique permet à un avoir de corriger la dette sans créer un faux paiement fournisseur. Le document comptable et le mouvement de cash restent deux faits séparés.
Décaissements et allocations
Un supplier_payment exécuté n’indique pas à lui seul quelles factures il règle. Le lien comptable est porté par unepayment_allocation dont source_type=supplier_payment et dont les targets peuvent être une facture fournisseur, un avoir fournisseur, un bon de commande ou une part non allouée.
Le payable soustrait les montants effectivement alloués aux factures et avoirs concernés. Cette séparation rend possible un décaissement couvrant plusieurs documents, un paiement partiel ou une allocation corrigée ultérieurement.
Échéances et litiges
Un document est considéré échu lorsque sa date d’échéance est antérieure à l’instant de calcul et qu’un solde résiduel subsiste. Les montants contestés restent inclus dans la dette totale mais sont isolés dans les champs balance_disputed_* afin que votre processus puisse distinguer recouvrement fournisseur normal et traitement de litige.
La projection refuse de mélanger plusieurs devises dans un même payable fournisseur : si des documents ouverts utilisent des devises différentes, le calcul échoue plutôt que de sommer des montants incomparables.
Événements
payable.updated— le solde total de la projection évolue.payable.overdue— le fournisseur possède un solde échu positif pour un nouvel épisode d’éligibilité.payable.zero— le solde total passe d’une valeur positive à zéro.
Les événements temporels sont réarmés lorsque la condition cesse d’être vraie : un fournisseur redevenu à jour pourra donc produire un nouvel épisode payable.overdue si une dette échue réapparaît plus tard.
Utilisation
La projection est accessible depuis le fournisseur via GET /v1/companies/:id/payable. Elle sert particulièrement aux processus de planification de paiement, relance interne, contrôle des litiges et rapprochement Accounts Payable.
- Utilisez
balance_due_undisputed_*pour prioriser les dettes échues non contestées. - Utilisez
oldest_due_datepour ordonner les fournisseurs par ancienneté de dette. - Conservez la facture fournisseur comme source du détail documentaire ; le payable est une synthèse.
- Créez et exécutez des
supplier_paymentdistincts lorsque vous passez de la projection à l’action de décaissement.