finov.ioDocumentationHome

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"
  }
}