An invoice write-off is used when a business intends not to collect additional payment from a customer for an invoice.

This is most commonly used to account for bad debt or other uncollectible A/R, but can also be used to account for other adjustments to an invoice or indicate the business is providing a specified portion as a charitable donation.

Write-offs can be partial, if less than the outstanding balance of the invoice is specified as the write-off amount, or full, if the entire outstanding balance is written off.

Write-offs default to a bad debt expense, indicating the value is not expected to be collected. If the write-off is for a different reason, such as a charitable donation, a different ledger expense account can be specified with the destination_ledger_account field.

Attributes

id
string
required

Unique identifier for the write-off.

external_id
string

Unique ID of the write-off in your system for linking and idempotency.

amount
long
required

The amount written off. This amount counts towards the invoice total and decreases the outstanding balance of the invoice.

memo
integer

User-specifiable memo indicating the reason for the write-off. Recommended but not required.

destination_ledger_account
Ledger Accuont

Expense account where write off amount is recorded.

write_off_at
ISO8601 timestamp
required

Timestamp when the write off should be recognized in the general ledger. This may be the same time as the invoice was created if it is an intentional charitable contribution or it could be months after the invoice is issued when that invoice is deemed uncollectible.