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