Settlements: comment les maths se calculent seules
Six pricing models, chargeback engines, et pourquoi le settlement doit arriver en finance queue avec le travail déjà fait.
Un settlement est la clôture financière d’une transaction : le contrat X doit un payout au vendeur Y pour l’activité de la période, chargebacks déduits, platform fees déduits, net payable enregistré. Dans la plupart des opérations ITAD, ce calcul vit dans un tableur maintenu par une personne finance. Le settlements engine de la plateforme remplace ce tableur.
Auto-généré depuis les contrats
Chaque contrat définit un pricing model (per-unit, per-kilo, fixed-purchase, revenue-share, lease-return, hybrid — voir l’article contracts-pricing-models). À l’événement déclencheur (receiving complete pour inbound, sale closed pour outbound, period-end pour settlements périodiques), le moteur lit les termes du contrat, les données asset/order, et calcule le settlement. Le résultat est une settlement row dans la queue, avec le calcul détaillé ligne par ligne.
Chargeback engine
Pour les contrats lease-return, les règles de chargeback dans le contrat définissent les pénalités : € par appareil manquant par rapport au manifest, € par defect code contre la damage matrix, residual-value floor pour les appareils sous un grade acceptable. Le moteur lit la reconciliation de la receiving session, le testing audit, le grading record, et calcule le chargeback set. Chaque chargeback est une line item avec son déclencheur documenté.
Review avant posting
Le settlement auto-calculé arrive dans /core/settlements avec un statut “draft”. Finance le revoit — les line items sont visibles, le calcul est éditable (avec raisons journalisées), les chargebacks peuvent être waived ligne par ligne. Quand finance est satisfait, le posting déplace le settlement vers l’état invoiced et déclenche l’invoice generation.
Snapshot multi-currency
Les settlements enregistrent à la fois la deal currency et la platform reporting currency, avec l’exchange rate au moment du posting. Six mois plus tard, quand quelqu’un lance un rapport annuel, le taux historique est conservé — le rapport ne retraduit pas silencieusement.
Settlement reports
/core/settlements/[id]/report est le document imprimable par settlement avec le détail complet : contract reference, période, line items, chargebacks, fees, net payable, currency translation. Envoyé au client comme avis formel de settlement.