Skip to main content

Send credit note

warning

Documentation is released in preview, is not final, and may be subject to changes. Sandbox and Production environments will be available soon.

The outbound invoicing module allows your system to transmit credit notes to the Slovak customers while simultaneously fulfilling state tax reporting 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 & Transmission Flow.

Submission and Detail Retrieval​

To send a credit note, you must forward the structured file content 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 layout, details, and historic processing state.

Sample Submission Response (202 Accepted)​

{
  "uuid": "01a037ec-1962-7cdf-9776-35683193663f",
  "creditNoteNumber": "3e1808c9-8e5e-4217-98f4-5603ccf35d8e",
  "creditNoteDate": "2026-08-24",
  "dueDate": null,
  "currency": "EUR",
  "totalAmount": "1656.25",
  "netAmount": "1325.00",
  "direction": "outgoing",
  "sender": {
    "name": "SupplierOfficialName Ltd",
    "address": "0245:5554444445",
    "country": "SK"
  },
  "recipient": {
    "name": "Buyer Official Name",
    "address": "0245:5555444444",
    "country": "SK"
  },
  "status": "credit_note.processing",
  "downloaded": false,
  "downloadedAt": null,
  "createdAt": "2026-08-25T07:56:55+00:00",
  "updatedAt": "2026-08-25T07:56:55+00:00"
}

Validation​

When you submit a credit note, A-Cube performs synchronous validation against both the XML schema and the Schematron ruleset defined for the Slovakia mandate. The schema check verifies the structural correctness of the document, while the Schematron rules enforce the business and fiscal 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 from the tax authority.

Sample Lifecycle Webhook Payload​

{
  "eventId": "dd3411eb-b492-4b90-9c22-14c3cf4e1d7b",
  "event": "credit_note.outbound",
  "delivery": "webhook",
  "target": "https://example.com/webhook?param=xxx",
  "authType": "header",
  "authKey": "Authorization",
  "authToken": "xxxxxxxxxxxxxxxxx",
  "createdAt": "2026-06-17T07:40:15+00:00",
  "updatedAt": "2026-06-17T07:40:15+00:00"
}

Configure your your webhook handlers to catch these states automatically. This ensures your application's user interface can display when a credit note is accepted by the state, currently in dispute, or successfully settled without requiring manual calls.

Downloading credit notes​

Listing your credit notes​

Returns the flat list of your credit notes (both directions), sorted by the most recent first.

Last updated on