Void an invoice
API Documentation / Resources / Invoices
Void an invoice
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoices/{invoice_id}/void
Required OAuth scope: invoices:write
Voids an authorised document and records the reason.
| Condition | Behavior |
|---|---|
| Open authorised document | Posts reversal entries and returns the voided document. |
| Requested date is locked | Returns 409 accounting_period_locked. |
| Active payment or credit allocation | Returns 409 invoice_has_allocations. |
| Paid or reconciled document | Correct through the settlement or credit-note workflow. |
Voiding is permanent; a voided document cannot be reopened.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary containing the documents. |
invoice_id |
path | Yes | string (uuid) | UUID of the authorised document to void. |
Request
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoices/{invoice_id}/void HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"reason": "Customer order cancelled",
"date": "2026-08-11"
}
Required body fields: reason.
Responses
| Status | Description |
|---|---|
200 |
Invoice voided and reversal posted. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
404 |
Invoice does not exist in the granted accounting context. |
409 |
Request conflicts with the invoice lifecycle or accounting state. |
422 |
Invoice data or referenced accounting configuration failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": "f54ca5ce-c915-417b-9514-818ba58a21cb",
"invoice_number": "INV-2026-0042",
"type": "SALES_INVOICE",
"status": "VOIDED",
"contact_id": "a68d68ec-5866-42e5-8864-57829d3f91b5",
"date": "2026-08-10",
"due_date": "2026-09-09",
"reference": "PO-1042",
"currency_code": "NZD",
"exchange_rate": null,
"branding_theme_id": null,
"subtotal": "1500.0000",
"tax_total": "225.0000",
"total": "1725.0000",
"amount_due": "0.0000",
"lines": [
{
"id": "13185dbb-f413-4836-85ed-6435f0286d86",
"description": "Advisory services",
"quantity": "2.0000",
"unit_amount": "750.0000",
"discount_rate": "0.0000",
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c31",
"tax_rate_id": "d98226c2-ad80-4345-b117-5630de766842",
"dimension_element_ids": [],
"subtotal": "1500.0000",
"tax_amount": "225.0000",
"total": "1725.0000"
}
],
"journal_id": "553aa91a-e8c2-4c6f-b800-07a2b92efdb1",
"reversal_journal_id": "8e136a87-44f7-4de5-954d-57084bac9912",
"authorised_at": "2026-08-10T13:30:00Z",
"voided_at": "2026-08-11T09:00:00Z",
"created_at": "2026-08-10T13:15:00Z",
"updated_at": "2026-08-11T09:00:00Z"
}
}