Skip to main content

Onboard a Legal Entity

To register a new Legal Entity, you need to send properly formatted JSON, as defined in this endpoint.

note

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​

note

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.

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).

  1. Click the view (eye) icon in the Akcija column of A-Cube's row, and check the details.
  2. Click Potvrdi (confirm), then Potvrdi again on the second screen.

The status of the row becomes Potvrđen (confirmed).

warning

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:

  1. Enter A-Cube's OIB 39909640664 in OIB pristupne točke.
  2. Click Dohvati (fetch): A-Cube's name appears in Naziv pristupne točke.
  3. 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 checkWhat to do
not_confirmedThe 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) failedTemporary: check again later.
Error The Tax Authority's fiscalisation system (CIS) could not be reached or …could not be readTemporary: check again later.
Error The legal entity is not registered in A-Cube's metadata service (SMP) yetA-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: