Settlements: hoe de wiskunde zichzelf berekent

Een settlement is de financiële afsluiting van een transactie: contract X is verkoper Y een payout verschuldigd voor de activiteit van de periode, met chargebacks afgetrokken, platform fees afgetrokken en het netto te betalen bedrag vastgelegd. In de meeste ITAD-operaties leeft die berekening in een spreadsheet die één finance-medewerker onderhoudt. De settlements engine van het platform vervangt die spreadsheet.

Automatisch gegenereerd uit contracten

Elk contract definieert een pricing model (per-unit, per-kilo, fixed-purchase, revenue-share, lease-return, hybrid — zie het artikel contracts-pricing-models). Op het trigger event (receiving complete voor inbound, sale closed voor outbound, period-end voor periodieke settlements) leest de engine de contractvoorwaarden en asset/order-data, en berekent de settlement. Het resultaat is een settlement row in de queue, met de berekening regel per regel uitgesplitst.

Chargeback engine

Voor lease-return contracts definiëren de chargebackregels in het contract de boetes: € per ontbrekend apparaat tegenover de manifest, € per defectcode tegenover de damage matrix, residual-value floor voor apparaten onder een aanvaardbare grade. De engine leest de reconciliation van de receiving session, de testing audit en het grading record, en berekent de chargeback set. Elke chargeback is een line item met gedocumenteerde trigger.

Review vóór posting

De automatisch berekende settlement landt in /core/settlements met status “draft”. Finance reviewt — line items zijn zichtbaar, de berekening is aanpasbaar (met gelogde redenen), chargebacks kunnen per regel worden kwijtgescholden. Wanneer finance akkoord is, verplaatst posting de settlement naar invoiced state en start het de invoice generation.

Multi-currency snapshot

Settlements bewaren zowel de deal currency als de platform reporting currency, met de exchange rate op posting time. Zes maanden later, wanneer iemand een jaarreport draait, blijft de historische koers behouden — het rapport hervertaalt niet stilletjes.

Settlement reports

/core/settlements/[id]/report is het printbare per-settlement document met de volledige breakdown: contract reference, periode, line items, chargebacks, fees, net payable, currency translation. Verzonden naar de klant als formele settlement notice.