Write off a balance

A write-off is an accounting and loan-balance action. It removes the loan’s eligible outstanding balance from the receivable under accounting policy, with the principal, interest, fee, and penalty split recorded on the resulting transaction. It is not a generic “close bad loan” command.

Execute

The write-off is the governed native command writeoff. A human call carries LendEasy-Case naming an open case when case management is enabled; without it the call is rejected before execution.

curl -X POST "$BASE/v1/loans/7204/transactions?command=writeoff" \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: demo-lender" \
  -H "LendEasy-Case: case_HBR_LOSS_18" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: hbr-writeoff-2028-01-31" \
  -d '{
    "transactionDate": "2028-01-31",
    "note": "Loss review approved; uncollectible balance.",
    "dateFormat": "yyyy-MM-dd",
    "locale": "en"
  }'

{
  "officeId": 1,
  "clientId": 412,
  "loanId": 7204,
  "resourceId": 30461,
  "changes": {
    "transactionDate": "2028-01-31"
  }
}

Read the posted transaction—GET /v1/loans/7204/transactions/30461—for the written-off principal, interest, fee, and penalty portions, and the loan for its resulting status. The ledger accounts come from the product’s accounting mapping; the caller never chooses them in the request.

Write-off versus charge-off

• Charge-off changes accounting classification at a defined point and can preserve a recoverable obligation.
• Write-off removes the outstanding amounts from the receivable under accounting policy.

A tenant may use them in sequence or separately, but LendEasy records each economic event. One command never silently implies the other.

Approval and period controls

Write-off is a standard maker-checker target: the flagged command parks, and a different user holding the checker permission decides through GET /v1/makercheckers and POST /v1/makercheckers/{auditId}?command=approve|reject. Backdating into a closed accounting period is blocked or routed through an approved period-correction workflow. Every execution—parked or direct—writes a governance record readable at GET /v1/loans/7204/governance-records.

Recovery after write-off

Whether future money is accepted and how it is classified comes from recovery policy. Never post a later recovery as if the write-off did not occur—use recovery payment when applicable.

Undo

POST /v1/loans/7204/transactions?command=undowriteoff is the dedicated compensating command. It restores the written-off component amounts and accounting entries, then replays later activity. It requires an open accounting period or an approved correction path and is rejected when dependent transactions make replay unsafe. History retains both commands, their governance records, and their reasons.