Canonical document posting

Documents And Issue Flow

Sales documents are created through invoice or credit-note endpoints, then issued through POST /v1/documents/{document_id}/issue. Issue-time validation freezes party data, tax snapshots, QR payload evidence, document numbers, archive metadata, and canonical journal posting. QR-bill validation is atomic: if settings are invalid, no number, frozen line, archive row, journal entry, or issue event is consumed.

Draft to issued

Create draft

POST /v1/invoices or /v1/credit-notes with source references, lines, dates, and tax codes.

Issue

POST /v1/documents/{document_id}/issue freezes the commercial/tax/QR snapshot and posts the canonical journal entry.

Read evidence

GET /v1/documents/{document_id} and /pdf return status, totals, journal links, archive metadata, and QR payload hashes.

Related API reference

Use the endpoint reference pages for request schemas, response bodies, status codes, and examples generated from the live OpenAPI contract.

POST /v1/credit-notesCreate Credit Note Draft GET /v1/documents/{document_id}Retrieve Document POST /v1/documents/{document_id}/issueIssue Document PUT /v1/documents/{document_id}/payment-referencesPut Document Payment References GET /v1/documents/{document_id}/pdfRetrieve Document Pdf POST /v1/documents/{document_id}/voidVoid Document POST /v1/invoicesCreate Invoice Draft