finov.ioDocumentationHome

Authorise an invoice

API Documentation / Resources / Invoices

Authorise an invoice

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoices/{invoice_id}/authorise

Required OAuth scope: invoices:write

Validates and posts a draft. The request has no body.

Posting check Requirement
References Contact, accounts, tax rates, and dimensions are active.
Period Document date is after the accounting lock.
Currency A valid exchange rate exists for the document date.
Lines Calculated posting balances in document and functional currency.

Success assigns the invoice number and creates an immutable posted journal. An already-authorised document returns a state conflict.

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 draft to authorise.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoices/{invoice_id}/authorise HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Length: 0

Responses

Status Description
200 Invoice authorised and 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": "AUTHORISED",
    "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": "1725.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": null,
    "authorised_at": "2026-08-10T13:30:00Z",
    "voided_at": null,
    "created_at": "2026-08-10T13:15:00Z",
    "updated_at": "2026-08-10T13:30:00Z"
  }
}