Skip to main content

Send credit note

The outbound invoicing module allows your system to send credit notes to Croatian customers while simultaneously fulfilling the fiscalisation requirements. The communication workflow is split into two distinct operational parts: an initial asynchronous submission followed by continuous status monitoring.

For more details on supported formats, see Formats.

Submission and Detail Retrieval​

To send a credit note, send its UBL 2.1 XML to A-Cube. The platform validates the payload synchronously and responds immediately with a unique identifier (uuid). This ID is a critical piece of data; it must be stored in your database to fetch the current credit note details and processing state.

Sample Submission Response (202 Accepted)​

{
"uuid": "0199e8b2-3c4d-7e5f-9a01-b2c3d4e5f6a7",
"legalEntityUuid": "018f4a2e-7b3c-7f1a-b2c3-4d5e6f789abc",
"creditNoteNumber": "2026-CreditNote-0002",
"creditNoteDate": "2026-11-02",
"currency": "EUR",
"totalAmount": "125.00",
"netAmount": "100.00",
"direction": "outgoing",
"typeCode": "381",
"businessProcess": "P10",
"sender": {
"name": "Example Supplier d.o.o.",
"taxId": "48780941616"
},
"recipient": {
"name": "Example Buyer d.o.o.",
"taxId": "75608754333"
},
"status": "sent",
"downloaded": false,
"downloadedAt": null,
"createdAt": "2026-11-02T10:00:00+00:00",
"updatedAt": "2026-11-02T10:00:00+00:00"
}

Validation​

When you submit a credit note, A-Cube performs synchronous validation against both the UBL 2.1 schema and the business rules of HR CIUS 2025. The schema check verifies the structural correctness of the document, while the business rules enforce the constraints required for acceptance. If either check fails, the POST /credit-notes response returns the validation errors immediately, allowing you to correct and resubmit the document without waiting for a status update.

The error responses, with examples, are in the POST /credit-notes reference.


Delivery​

A-Cube delivers the credit note to the recipient's accredited service provider (ASP). The credit note then becomes delivered, undeliverable or delivery_failed: see Documents lifecycle for what each means and Tax Data Documents for what A-Cube files.

An undeliverable credit note must be delivered another way, for example as a PDF; don't send it again.

Sample Lifecycle Webhook Payload​

{
"eventId": "019a5c1e-5a6b-7c8d-9e0f-2a3b4c5d6e7f",
"eventType": "credit_note.outgoing",
"documentUuid": "0199e8b2-3c4d-7e5f-9a01-b2c3d4e5f6a7",
"documentNumber": "2026-CreditNote-0002",
"status": "delivered"
}

The event tells you that the status changed; read the credit note with GET /credit-notes/{uuid} for the details.

Configure your webhook handlers to catch these states automatically. This ensures your application's user interface can display when a credit note is delivered or can't be delivered without requiring manual calls.

Downloading credit notes​

Listing your credit notes​

Returns the paginated list of your credit notes (both directions), sorted by the most recent first. See Search documents for the filters and pagination.