Gestion du crédit acheteur
Combinez plusieurs sources de limite, calculez la capacité réellement disponible pour une vente, puis tracez chaque octroi, consommation, extourne, libération ou règlement dans l’exposition de crédit du tiers.
Objectif métier
La gestion du crédit ne se réduit pas à un nombre « limite ». Ormuz sépare la politique de limite, la limite effective calculée à un instant donné, l’exposition déjà engagée et ladécision de capacité prise pour une opération précise.
credit_exposure enregistre ensuite les mouvements réels de capacité accordée, consommée, libérée ou réglée afin que l’historique reste explicite.Quatre notions à ne pas confondre
| Notion | Question | Objet / sortie |
|---|---|---|
| Limite de crédit | Quelles limites sont déclarées pour ce tiers, cette devise et cette base fiscale ? | credit_limit |
| Limite effective | Comment combiner aujourd’hui les limites encore applicables ? | credit_limit_effective |
| Exposition | Quelle capacité a déjà été accordée, consommée, libérée ou réglée ? | credit_exposure |
| Capacity check | La demande courante tient-elle dans la capacité disponible ? | credit_capacity_check |
Parcours de crédit
La décision de capacité précède le grant. Les mouvements ultérieurs font évoluer l’exposition sans réécrire l’historique des mouvements antérieurs.
Pour un parcours simple, credit.evaluate_credit_capacitycombine la résolution de la limite effective, la lecture de l’exposition et la décision approved/rejected. Les nodes séparés restent utiles lorsque votre processus doit inspecter ou modifier chaque étape.
1. Définir et résoudre les limites
Créez les politiques applicables avec credit.add_credit_limit. Une limite porte une devise, une base excluding_tax ou including_tax, une période de validité et une source — par exemple le marchand, un assureur-crédit ou un provider BNPL.
credit.fetch_effective_credit_limit filtre d’abord les limites actives et valides à la date demandée, puis applique la stratégie choisie :
| Stratégie | Effet | Usage typique |
|---|---|---|
maximum | Retient la plus haute limite applicable. | Plusieurs sources alternatives, une seule capacité retenue. |
minimum | Retient la plus prudente. | Politique où la source la plus restrictive l’emporte. |
cumulative | Somme les limites applicables. | Capacités complémentaires explicitement cumulables. |
2. Évaluer la capacité disponible
credit.check_credit_capacity compare une limite effective, l’exposition courante et le montant demandé. Il route vers approved ou rejected et produit un objet de contrôle explicite que vous pouvez conserver dans le contexte du processus.
Si le résultat est favorable et que votre politique métier autorise réellement l’opération, utilisez credit.grant_credit. Le grant crée un mouvement credit_grantedet renvoie son identifiant de mouvement, qui peut ensuite être relié aux consommations, libérations ou règlements pour améliorer la traçabilité.
3. Faire vivre l’exposition
| Fait métier | Node | Mouvement |
|---|---|---|
| Une vente consomme du crédit | credit.consume_credit_exposure | credit_consumed |
| Une consommation doit être extournée | credit.reverse_credit_consumption | credit_consumption_reversed |
| Une autorisation inutilisée est libérée | credit.release_credit_exposure | credit_released |
| Une créance couverte est réglée | credit.settle_credit_exposure | credit_settled |
| Une exposition restante est annulée | credit.cancel_credit_exposure | credit_cancelled |
Les mouvements sont ajoutés ; ils ne réécrivent pas les faits précédents. Une extourne référence précisément un mouvement credit_consumed et peut être partielle, mais le cumul de ses extournes ne peut pas dépasser la consommation d’origine.
Surconsommation : constater avant de corriger
Une consommation issue d’un fait métier fiable peut dépasser l’autorisation antérieure. Ormuz enregistre alors le mouvement au lieu de rejeter le fait, puis rend l’anomalie observable avec credit_exposure.overconsumed lorsque le seuil est franchi.
Checklist
- Définir la base HT/TTC et la devise de façon cohérente entre limites, capacité et exposition.
- Choisir explicitement la stratégie de combinaison des limites.
- Recalculer la capacité au moment de la décision importante.
- Créer un mouvement
credit_granteduniquement après décision métier favorable. - Consommer le crédit depuis le fait métier qui matérialise réellement l’engagement.
- Référencer le mouvement d’autorisation lorsque cette traçabilité transactionnelle est connue.
- Utiliser une extourne plutôt que modifier une consommation passée.
- Traiter
credit_exposure.overconsumedcomme un incident métier observable.