Introduction
Documentation is released in preview, is not final, and may be subject to changes. Sandbox and Production environments will be available soon.
A Legal Entity is a Slovak taxpayer company that wants to send and / or receive e-invoices and tax compliance documents through the A-Cube Platform. Each customer with an account on the A-Cube Platform can manage many legal entities.
Every Legal Entity has unique, individual authorization token provided by Finančná správa. Without this token, the Legal Entity will be inactive in the Peppol network, and it won't be possible to send/receive invoices through it.
A Legal Entity can be a company with or without a registered IČ DPH.
Companies without a valid IČ DPH and a valid IČO can still be onboarded to the A-Cube Platform, but they will only be able to receive invoices.
The Legal Entity must initiate the onboarding process in A-Cube, and confirm to select us as Service Provider in the Finančná Správa's Aplikácia pre výber certifikovaného poskytovateľa doručovacej služby (VPDS) portal.
Consumers don't need to handle e-invoices; therefore, they cannot be registered as a Legal Entity.
The flow in a nutshell
Register a Legal Entity in A-Cube by using the POST /legal-entities endpoint.
In the sandbox environment, the status of the Legal Entity will be set automatically to active if the taxId (DIČ) provided is not already registered in the Peppol network.
In the production environment, a Legal Entity needs to continue the onboarding process by following the next steps:
- Opening in a browser the /initiate-onboarding URL provided in response when registering the Legal Entity.
- Confirming to use A-Cube as the Legal Entity digital provider by logging in the Finančná Správa's VPDS portal.
- When the onboarding is completed successfully, the Legal Entity will be set to
activestatus in A-Cube.
In A-Cube, only active Legal Entities can send and receive documents.
Receiving capabilities
Receiving capabilities define which Peppol document types the entity accepts.
When a Legal Entity completes the onboarding, it will be automatically enabled to receive Billing and Self-Billing invoices and credit notes.
Legal Entity Status
Every Legal Entity has a marking property that describes its onboarding status and whether it can operate in the system.
| Status | Description |
|---|---|
pending | A Legal Entity has been added to the A-Cube Platform, but still needs to be validated. |
waiting_user_interaction | A Legal Entity started the connection process with A-Cube on the Finančná správa portal but hasn't completed it yet. |
waiting_user_interaction_after_fail | A Legal Entity failed the connection process with A-Cube on the Finančná správa portal, but can try again. |
active | Legal Entity has been successfully onboarded. |
blocked | Legal Entity has been blocked due to an incorrect onboarding process or set manually by the administrator. |