Takes the same body as invoice.allocatePayment and shows what it would post, writing nothing: what the invoice has open, what the payment settles (payment.settles, in the invoice's currency), the shortfall a shortfall_reason closes (shortfall: reason, amount, account), what stays open (left_open), settles_in_full, and the journal (journal.lines, signed amounts in the base currency, debit positive; journal.available is false with a reason for a line in another currency). It runs the commit's own checks, so a refusal is named here first: write_off_not_permitted, withholding_tax_account_required, withholding_tax_account_unavailable, withholding_tax_currency_mismatch, withholding_tax_nothing_withheld, withholding_tax_exceeds_limit, payment_exceeds_open, shortfall_nothing_to_close, shortfall_account_unavailable, shortfall_note_required, shortfall_reason_unavailable, shortfall_currency_mismatch, period_locked. Amounts are decimal strings. The ETag header (and meta.invoice_version) is the invoice version it read: send it as If-Match on the commit, which then refuses with 412 if the invoice changed in between. Requires the invoices:action OAuth scope with update_invoices and update_bank_accounts.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
