Skip to main content

Write-offs vs adjustments

Outcome

You can tell the difference between an adjustment (the platform reduces the balance per a contract or rule) and a write-off (you decide to stop collecting), pick the right one, and apply it with a clean audit trail.

Prerequisites

ScopeWhat it lets you do
billing.payment.writeApply write-offs
billing.adjustment.writeApply manual adjustments

The taxonomy

Adjustment

An adjustment reflects the true allowed amount per contract or rule. It is mechanical: the contract says $80 instead of $100, so $20 is an adjustment. The platform writes most adjustments automatically from the 835 (CARC CO-45 etc.).

Write-off

A write-off is a discretionary decision to stop collecting. It is human: "the patient can't pay; we'll write off $50." The platform requires a reason on every write-off.

Common write-off reasons (patient side)

ReasonWhen
small-balanceUnder tenant's threshold (e.g. $5).
patient-uncollectableSent to collections; returned.
charityTenant-approved hardship.
bad-debtAged past collection cycle.
dispute-resolvedPatient disputed; resolution favored them.

Common adjustment reasons

Most adjustments come from the 835 automatically. Manual adjustments are rare but valid:

ReasonWhen
contracted-rate-correctionFee schedule was wrong; correct retroactively.
dual-eligible-coverage-correctionMember had Medicaid as secondary and the primary 835 lacked it.
payer-error-correctedPayer error documented; pre-emptive correction.

Steps — patient-side write-off

  1. Open the member's AR tab. Find the line(s) to write off.

  2. Click Write off (the bulk action when several at once).

  3. Pick a reason + amount + (for other) free-text.

  4. Save. The platform writes a payment_application of type WRITEOFF against the line(s). Member AR balance reduces.

Steps — manual adjustment

  1. Open the claim or member. Click Apply adjustment.

  2. Pick category (the platform has a tenant-defined picklist) + reason + amount.

  3. Save. The adjustment writes to the claim's remittance_adjustment ledger with a synthetic CARC chosen by the tenant policy (commonly OA* for non-standard).

Reversing

Both write-offs and adjustments support reverse:

WhatHow
Reverse a write-offMember AR → write-off row → Reverse with reason.
Reverse an adjustmentSame shape on claim's adjustments list.

Reverses write paired audit rows (the original + the reversal).

Validation

CheckExpected
Write-off requires a reasonYes.
Adjustment requires a reasonYes.
Both leave audit rowsYes.
Both can be reversedYes.
Reporting tracks each separatelyYes; separate widgets.

Troubleshooting

SymptomCauseFix
Write off greyedLack of billing.payment.write or claim is in a state that blocksAsk admin or check status.
Reverse doesn't restore the prior balanceConcurrent activity changed the stateAudit log → walk it back; ping support if confused.
Adjustment posts but doesn't reduce balanceWrong category (some categories are informational)Check the picklist; pick the right category.
Bulk write-off skipped some rowsSome rows are protectedSummary tells you N/M.

Where to next