Introduction
Documentation is released in preview, is not final, and may be subject to changes. Sandbox and Production environments will be available soon.
Welcome to the official A-Cube documentation dedicated to the Slovakia market.
Use the A-Cube SK API to onboard SK taxpayers, send and receive electronic invoices and credit notes, and track each document throughout its lifecycle.
Before exchanging documents, each company must be linked to A-Cube as a legal entity through the Finančná Správa portal after initiating the onboarding process in the A-Cube SK API. Your application then sends structured Peppol BIS Billing XML or a JSON to A-Cube. A-Cube validates it, exchanges it through Peppol in XML format, and reports the required tax data to the national SK Tax Authority.
Integrating with our services will allow you to govern the entire process through three fundamental macro-stages:
- Company Creation: The initial registration and configuration of Legal Entities within the A-Cube context.
- Invoice/Credit note Issuance and Reception: The complete management of outbound and inbound invoicing/credit notes, both for the SK domestic market (supporting Peppol BIS Billing XML) and for international transactions.
- Tax Reporting: The complete management of tax reporting through Tax Data Document (TDD) and Message Level Status (MLS) messages.
The TDD reports to the Slovak Tax Authority will be sent according to the SK legislation.
To get started:
- Register on A-Cube API Platform to get your username and password for the authentication
- Get a valid token, see here
- Onboard the company (
LegalEntity), see here - Prepare and send a new document, see here for invoices and here for credit notes
- Receive the
uuididentifier for the newly created document as a response and store it - Receive information about the delivery to your configured webhook, match against the previously stored identifier.
Environments
-
sandbox is the environment where you can test the entire platform without paying at any time. The base URL is https://sk-sandbox.api.acubeapi.com
-
production is the environment where real document exchange happens. The base URL is https://sk.api.acubeapi.com
Authentication
You can find all the information about the authentication here.
Choose the shortest path for what you need:
- New to the SK API? Follow the Quick Start.
- Need sandbox credentials? Go to Get sandbox environment access.
- Need to register a company? Go to Onboard a new legal entity.
- Need updates of documents statuses? Go to Webhooks.