← Knowledge library

Finance & ZATCA

Explain remittance variance, reversals and returned payments

Keep fees, deductions and compensating entries visible instead of disguising them as denials.

Current source · source reviewed · 6 min read

Before you begin

1. Read both ledger identities

Compare reported advice and actual bank cash without netting away either ledger. Inspect the per-claim identity and each conservation check.

2. Decompose the variance

Record the supported component and sign for fees, deductions, reversals, returns, overpayment or errors. Any unexplained residue remains explicitly unexplained.

3. Reverse through a compensating entry

When an allocation is wrong, select its advice or cash ledger and post a supported reversal. Preserve the original allocation; a repeated reversal reports already_reversed.

4. Handle returned cash explicitly

For a returned bank credit, use returned-payment so dependent settlement is reversed under the canonical service. Recheck the claim, suspense and notification position afterward.

Avoid misleading denial analytics

A platform fee or early-payment fee is a financial component rather than a clinical denial. Misclassifying it creates incorrect work and incorrect denial metrics.

Append-only evidence

Reversals are new compensating records. They are not an edit or deletion of the original financial event.

Troubleshooting

The ledgers do not balance

Inspect unresolved amounts and named variance components first. Keep the item in the relevant suspense/review queue until the evidence supports the full allocation.

Source evidence

References are pinned to the private MANSOQ source repository. Repository access is required to open these links.