CorebillFiscal Documents
Official tax documents issued through Plazma, with their status at the tax authority.
Overview
A fiscal document (fdoc_...) is the official tax document of a Corebill record, issued through Plazma (plazma.sh): an invoice or receipt from an invoice, a credit or debit note, or a dispatch guide from a stock transfer, purchase order or work order. Corebill knows nothing about the country: forms and rules come from the Plazma catalog. Documents issued with the Plazma API or CLI also appear here, with source.type = none. The API is read only; documents are issued from the dashboard or automatically when an invoice is issued.
Requires the Fiscal module. An owner or admin turns it on in Settings > Modules. While it is off, every endpoint on this page returns 403 with type permission_error and code module_disabled.
status follows Plazma: queued and submitted while the tax authority answers, then accepted, accepted_with_observations or rejected. error means Plazma did not accept the document data (see error). void shows a void request and its result.
Endpoints
| Method | Path | Permission | Description |
|---|---|---|---|
GET | /v1/fiscal-documents | read | List documents (status, type, source_type, source_id, query) |
GET | /v1/fiscal-documents/{id} | read | Retrieve a document by fdoc_..., Plazma doc_... or official number |
Documents of an Invoice
AI assistants connected through the Corebill MCP server can read them with the get_fiscal_documents tool.
Events
fiscal_document.accepted, fiscal_document.rejected and fiscal_document.voided are sent to your webhooks and can trigger automations. fiscal_connection.certificate_expiring warns before the digital certificate in Plazma expires.