Onboard a Legal Entity
To register a new Legal Entity, you need to send properly formatted JSON, as defined in this endpoint.
Every Legal Entity must have a unique OIB (Tax identifier) in A-Cube. The same Legal Entity cannot be registered twice in two different accounts.
Every Legal Entity has a confirmation status for each service, document exchange and fiscalisation, that describes whether the company has confirmed A-Cube for it. See Legal Entity Status for the values.
A-Cube platform will help you to start your onboarding process, but your interaction is needed to confirm A-Cube in FiskAplikacija, the Tax Authority's application in the ePorezna portal: you can do that at any time after the Legal Entity is registered.
Onboarding steps
The following steps refer to the onboarding process for the production environment. If you want to try our API, you can register a Legal Entity for testing purposes in the Sandbox environment. Please refer to the Quick Start for Sandbox page.
1. Register a Legal Entity in A-Cube
Register a Legal Entity in A-Cube by using the POST /legal-entities endpoint, with the services it uses.
{
"taxId": "48780941616",
"name": "Example Company d.o.o.",
"email": "example@company.com",
"phoneNumber": "+38514567890",
"country": "HR",
"address": "Ilica 1",
"city": "Zagreb",
"county": "Grad Zagreb",
"zipCode": "10000",
"documentExchangeEnabled": true,
"fiscalisationEnabled": true
}
A-Cube will check that the provided taxId (OIB) has 11 digits and is unique in A-Cube.
If all the checks are successful, the Legal Entity will be registered in A-Cube with both confirmations not_checked. With document exchange enabled, A-Cube also registers it in its metadata service (SMP), to receive invoices and credit notes.
{
"uuid": "018f4a2e-7b3c-7f1a-b2c3-4d5e6f789abc",
"taxId": "48780941616",
"name": "Example Company d.o.o.",
"email": "example@company.com",
"phoneNumber": "+38514567890",
"country": "HR",
"address": "Ilica 1",
"city": "Zagreb",
"county": "Grad Zagreb",
"zipCode": "10000",
"createdAt": "2026-11-01T10:00:00+00:00",
"updatedAt": null,
"documentExchangeEnabled": true,
"fiscalisationEnabled": true,
"documentExchangeConfirmationStatus": "not_checked",
"documentExchangeConfirmationError": null,
"fiscalisationConfirmationStatus": "not_checked",
"fiscalisationConfirmationError": null
}
The services are not confirmed yet because a representative of the company must confirm A-Cube in FiskAplikacija.
2. Confirm A-Cube in FiskAplikacija
The company's side of the onboarding is done entirely in the Tax Authority's ePorezna portal. There, a representative of the company confirms A-Cube in FiskAplikacija for each service enabled on the Legal Entity:
- Document exchange: confirm A-Cube's receiving address, so that senders deliver the company's documents to A-Cube.
- Fiscalisation: authorise A-Cube to fiscalise for the company.
See Tax Authority (Porezna uprava) for what each confirmation does.
Sign in to ePorezna and open FiskAplikacija
The representative signs in to ePorezna and opens FiskAplikacija. At the top of the page, select the company to onboard: its name and OIB are shown next to the representative's name.
Open the administration page
In the menu, open Fiskalizacija 2.0 → Administracija. The page Administracija adresa i ovlaštenja has two tabs:
- Adrese za zaprimanje eRačuna (receiving addresses), for document exchange;
- Ovlaštenja za fiskalizaciju (fiscalisation authorisations), for fiscalisation.
Confirm A-Cube's receiving address (document exchange)
On the Adrese za zaprimanje eRačuna tab, A-Cube's row shows the company's identifier (9934: followed by its OIB), A-Cube's OIB 39909640664 as OIB pristupne točke, and the status Čeka potvrdu (waiting for confirmation).
- Click the view (eye) icon in the Akcija column of A-Cube's row, and check the details.
- Click Potvrdi (confirm), then Potvrdi again on the second screen.
The status of the row becomes Potvrđen (confirmed).
Don't click Odbij (reject): the address is rejected, and A-Cube has to publish it again. If it happens, contact A-Cube support.
Authorise A-Cube to fiscalise (fiscalisation)
On the Ovlaštenja za fiskalizaciju tab, click Novo ovlaštenje (new authorisation). In the dialog Dodavanje ovlaštenja za fiskalizaciju:
- Enter A-Cube's OIB
39909640664in OIB pristupne točke. - Click Dohvati (fetch): A-Cube's name appears in Naziv pristupne točke.
- Click Spremi (save).
A-Cube then appears in the list of authorisations.
A Legal Entity that uses only fiscalisation does this part only: A-Cube isn't listed among its receiving addresses.
3. Check the onboarding
A-Cube checks the confirmations automatically, at regular intervals. To check at once, for example right after the company confirms, use the POST /legal-entities/{uuid}/onboarding-check endpoint.
{
"documentExchangeConfirmationStatus": "confirmed",
"documentExchangeConfirmationError": null,
"fiscalisationConfirmationStatus": "confirmed",
"fiscalisationConfirmationError": null
}
4. After onboarding
Read the entity with GET /legal-entities/{uuid} and confirm that each service it uses is confirmed.
Until document exchange is confirmed, the Legal Entity can't exchange documents: sending is refused with 409 and the blocker legal_entity_not_onboarded. Until fiscalisation is confirmed, filing a report or the Tax Data Document of an external document is refused with 409 and the blocker report.fiscalisation_not_confirmed or tax_data_document.fiscalisation_not_confirmed, and the Tax Authority refuses the Tax Data Documents of the documents exchanged through A-Cube.
Errors and retries
| Result of the check | What to do |
|---|---|
not_confirmed | The company hasn't confirmed A-Cube in FiskAplikacija yet, or has chosen another provider. Confirm A-Cube (step 2), then check again (step 3). |
| Error The lookup in the Tax Authority's address directory (AMS) failed | Temporary: check again later. |
| Error The Tax Authority's fiscalisation system (CIS) could not be reached or …could not be read | Temporary: check again later. |
| Error The legal entity is not registered in A-Cube's metadata service (SMP) yet | A-Cube couldn't register the Legal Entity to receive documents. Contact A-Cube support. |
The errors are returned in documentExchangeConfirmationError and fiscalisationConfirmationError. A failed check keeps the last confirmed or not_confirmed status.
Environments
To read more about specific features and limitations in particular environments, please read: