One row. Every adjustment. Every reason.
Adjustment is the unit of reconciliation truth — a typed row carrying amount, reason, source payout, source order, and a recoverable flag. Manual or auto-generated, every Adjustment is a first-class durable record in your tenant.
- Every reconciliation delta becomes an Adjustment with a typed reason and a recoverable flag.
- Adjustment types: deduction, fee, tax, chargeback, dispute, recovery, manual.
- Won claims write a recovery Adjustment back to the same MarketplacePayout — closing the loop.
What you get.
Typed and traceable
Adjustment.type is a constrained enum. Every row knows whether it's a deduction, a recovery, a chargeback, or a manual correction. Filter the ledger by type in one query.
Reason taxonomy
deduction_reason maps to the deduction taxonomy: SLA-miss, quality, mis-pick, late ack, RTO leak, slip mismatch, customer return, weight discrepancy. New reasons are added through the catalog, not the schema.
Recoverable flag
Each Adjustment carries is_recoverable. Recoverable rows queue for the Claims surface. Accept-loss rows close out cleanly without polluting your dispute pipeline.
What every Adjustment row carries.
- id, seller_id, marketplace_account_id — tenant + scope.
- type — deduction | fee | tax | chargeback | dispute | recovery | manual.
- amount (Decimal 14,4), currency.
- reason_code — from the deduction taxonomy catalog.
- is_recoverable (boolean), is_disputed (boolean).
- marketplace_payout_id, payout_line_item_id, order_id, return_id — source links.
- claim_id — set when a claim is filed; recovery adjustments back-link.
- audit fields — created_by_user_id or created_by_job_run_id.
Practical answers.
Yes. From the reconciliation page, add a manual Adjustment with a type=manual, an amount, a reason note, and an order link. The audit log captures the user who created it.
When a Claim is resolved-won, the claim service writes a new Adjustment of type=recovery linked to the original MarketplacePayout. Reconciliation re-runs and the payout flips back to RECONCILED.
Yes. CSV export from the reconciliation page includes every Adjustment with its source links. The export carries presigned URLs to the source documents in S3 (settlement file, invoice, manifest).
Try it inside your own dashboard.
Free during early access. No card. Forever free under 25 orders/day.