v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-0281419.4 KB

Invoices

Create a fiscal invoice

Submit an invoice for fiscal processing. The system assigns a monotonic fiscal number, computes taxes, signs the invoice via Cloud Signing Service, and appends it to the hash-chained Fiscal Ledger.

post/api/fiscal/invoices

Headers

x-tenant-idstring required

Request body

jurisdictionstring required

ISO 3166-1 alpha-2 country code

merchantTinstring required

outletIdstring required

posTerminalIdstring required

cashierIdstring required

invoiceType'STANDARD' | 'PROFORMA' | 'CREDIT_NOTE' | 'DEBIT_NOTE' | 'COPY' required

currencystring required

Example request

{
  "jurisdiction": "CD"
}

Response

Invoice created

invoiceIdstring uuid

fiscalNumberstring

Monotonic fiscal number as string

authCodestring

8-character authorization code

qrPayloadstring

Full QR verification URL

signaturestring

Cloud signing signature