Credit Notes

Resource 'Credit Notes' operations.

📄️List your credit notes.

Returns the flat list of your credit notes, sorted by most recent first.

📄️Send a credit note (UBL or CII)

Uploads a credit note file to A-Cube. Accepts UBL 2.1 or UN/CEFACT CII XML documents; the syntax is detected automatically from the payload. Support for Factur-X will be added in the near future. Send the `X-Referenced-Invoice-Uuid` header to link the credit note to one of your invoices.

📄️Get one of your credit notes by uuid

Returns the credit notes matching `uuid`. Responds 404 if the uuid is unknown or belongs to another tenant.

📄️Get the current lifecycle status for a credit note

Returns the current lifecycle status of a credit note.

📄️Get the chronological lifecycle event history for a credit note

Returns the full sequence of lifecycle events recorded upstream for the credit note. Owner-scoped.

📄️Send a lifecycle event for a credit note

Submits a status transition for the invoice (e.g. REFUSED, APPROVED, PAYMENT_RECEIVED). 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 credit note

Streams a PDF rendering of the credit note.

📄️Download the original credit note payload

Streams the original credit note payload (UBL XML / Factur-X PDF / CII XML) for the invoice identified by `uuid`.