Invoices
Resource 'Invoices' operations.
List your invoices
Returns the flat list of your invoices, sorted by most recent first.
Send an invoice (UBL, CII or Factur-X)
Uploads an invoice file to A-Cube. Accepts UBL 2.1 or UN/CEFACT CII XML documents; the syntax is detected automatically or upload a Factur-X PDF as a `multipart/form-data` request with the file in the `file` field, A Factur-X PDF is validated as a whole (PDF/A-3 container and embedded XML). The document is validated and transmitted to the network within the request: on success it answers 201 with the invoice already `SUBMITTED`, and a transmission failure is reported as an error, with nothing stored. Send the `X-Send-Async` header to queue the transmission instead: the response is then 202 with the invoice `ACQUIRED`, and it becomes `SUBMITTED` once the network confirms it has been sent, which is reported via the `invoice.outbound` webhook. Returns 409 when the legal entity the document is addressed from is not onboarded yet.
Get one of your invoices by uuid
Returns the invoice matching `uuid`. Responds 404 if the uuid is unknown or belongs to another tenant.
Get the current lifecycle status for an invoice
Returns the current lifecycle status of an invoice.
Download the Flux 1 legal data of an invoice
Returns the Flux 1 legal data XML of the invoice identified by `uuid`, byte for byte as it was transmitted to the PPF. Answers 404 while it has not been transmitted yet.
List the PPF returns (CDAR) on the Flux 1 of an invoice
Returns, oldest first, every return the PPF sent on the Flux 1 legal data of the invoice identified by `uuid`: the file receipt (CFE) and the business check (FFE), with the rejection detail when the PPF refused it. Download each CDAR XML from `/invoices/{uuid}/flow-1/receipts/{receiptUuid}/source`.
Get a PPF return (CDAR) on the Flux 1 of an invoice
Returns one PPF return (CFE or FFE) on the Flux 1 of the document identified by `uuid`, with the rejection detail when the PPF refused it. Download its CDAR XML from `/invoices/{uuid}/flow-1/receipts/{receiptUuid}/source`.
Download a PPF return (CDAR) on the Flux 1 of an invoice
Returns the CDAR XML of one PPF return (CFE or FFE) on the Flux 1 of the invoice, byte for byte as received from the PPF.
Get the chronological lifecycle event history for an invoice
Returns the full sequence of lifecycle events recorded upstream for the invoice. Owner-scoped.
Send a lifecycle event for an invoice
Submits a status transition for the invoice (e.g. REFUSED, APPROVED, PAYMENT_RECEIVED). The optional intermediate statuses may be skipped: a mandatory end status (REFUSED, PAYMENT_RECEIVED) can be sent directly from any earlier status. The upstream provider processes the event asynchronously and emits follow-up status callbacks. Returns 202 on success. Returns 422 if `invoiceStatus` is not a known InvoiceStatus value. Owner-scoped.
Download a human-readable PDF rendering of the invoice
Streams a PDF rendering of the invoice.
Download the original invoice payload
Streams the original invoice payload (UBL XML / Factur-X PDF / CII XML) for the invoice identified by `uuid`.