Provider Settlements

Provider Settlements reconcile the money relationship with an external courier provider. They group eligible provider-collected COD settlements and/or confirmed provider fees into one branch- and currency-scoped financial batch.

Use this workflow only after the applicable source records have been reviewed. It preserves a frozen source snapshot and prevents a source from appearing in more than one active provider settlement.

Settlement Types

Type	Purpose	Required source
Net Remittance	Records the net amount the provider must remit after provider fees and approved offsets.	At least one reconciled provider COD settlement
Fee Payment	Records a payment to the provider for confirmed delivery fees.	At least one delivered order with an unsettled confirmed provider fee

Value	Meaning
Fee Offset	Total provider-fee amount selected from delivery sources.
Fee Waiver	Provider fee waived for the selected period.
Provider Credit	Credit granted by the provider.
Fee Payment Amount	Amount paid to the provider for a Fee Payment batch.
Net Amount	System-calculated amount to be remitted; it cannot be negative.

Lifecycle

Draft → Posted → Reversed
  └──→ Cancelled

Status	Meaning
Draft	Sources are reserved and may be reviewed or removed. No financial posting has occurred.
Posted	The settlement is approved, posted, and its source values are final. Provider COD sources are finalized.
Cancelled	A Draft was cancelled. Its sources are released for use in another settlement.
Reversed	A Posted settlement was reversed through a linked reversal record. The original sources return to a reconciled state.

Create a Draft

1. Open Delivery → Financials → Provider Settlements and select Create.
2. Select the active courier Provider and the settlement type.
3. Select eligible provider COD sources for a Net Remittance, or eligible provider-fee sources for a Fee Payment.
4. Enter any approved fee waiver, provider credit, or fee payment amount.
5. Select Cash, Card, Bank Transfer, or Mobile Wallet; select a financial account when accounting is enabled.
6. Enter the economic date and an optional note, review the server-calculated preview, then save.

Eligible provider COD sources must be provider-collected, reconciled, delivered, and unsettled. Eligible fee sources must be delivered records with a confirmed, unsettled provider fee. Every selected source must use one branch, currency, and frozen currency rate.

The preview is authoritative: it calculates source totals, offsets, net amount, branch, currency, and rate. A Net Remittance requires COD sources and cannot include a separate fee payment. A Fee Payment requires provider-fee sources and an exact fee-payment amount.

Review and Post

While Draft, the detail page shows each frozen source line, calculated total, provider, financial account, and audit information.

• Remove Source is limited to COD and provider-fee lines in a Draft. The batch must retain its required source type.
• Cancel requires a reason and releases all reserved sources.
• Approve rechecks every source against the frozen snapshot, then posts the settlement. The application supplies an idempotency key so a retry cannot duplicate the posting.

Once Posted, the batch cannot be edited, cancelled, or have lines removed.

Reverse a Posted Settlement

Use Reverse only for a controlled correction. Enter an economic date, an idempotency key, and a required reason. The system creates a linked reversal batch, marks the original as Reversed, and returns its provider COD sources to Reconciled for review and possible inclusion in a new settlement. Never correct a posted settlement by editing or deleting it.

Best Practices

• Reconcile COD settlements and match the provider statement before approval.
• Use cutoff dates and clear notes for each settlement period.
• Resolve a source discrepancy before using a waiver or credit.
• If a Draft source changes, cancel the Draft and create a new settlement; approval intentionally blocks a stale source snapshot.