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.

📄️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`.