Skip to main content
Download OpenAPI

Onboarding Legal Entity

Onboarding process​

As a strict regulatory safeguard to protect access to the central registry, the UAE requires a formal verification of the taxpayer's identity before an Accredited Service Provider can act on its behalf.

For this reason, the taxpayer starts the verification of its legal entity, called onboarding, from EmaraTax, the digital tax platform of the Federal Tax Authority.

Before the taxpayer starts, you reserve its TIN from the dashboard or with POST /legal-entities: this is what ties the legal entity to your account. See Legal entities.

The whole onboarding then happens in two places:

  1. In EmaraTax, the taxpayer selects A-Cube as its Accredited Service Provider.
  2. On the A-Cube onboarding page, the taxpayer confirms its details. A-Cube then creates the legal entity, registers it on the Peppol network and synchronizes it with the central registry.

When the flow is complete, the legal entity is ready to send and receive documents. You do not need to call the API: the A-Cube onboarding page runs the onboarding calls for you.

There are three lifecycle operations. Each one starts in EmaraTax and continues on the A-Cube onboarding page:

ActionStarts when the taxpayerDocumented in
LINKselects A-Cube as its Accredited Service Provider.this page
REVERIFYconfirms the association again, to refresh its legal data.Updating Legal Entity
DELINKremoves A-Cube as its Accredited Service Provider.Updating Legal Entity

LINK onboards a new taxpayer, from EmaraTax to an active legal entity.

info

The EmaraTax and landing page steps follow the FTA guide UAE E-invoicing End-User Process for Onboarding, Reverify and Offboarding.

In EmaraTax​

These are the steps the taxpayer follows in the EmaraTax portal before reaching the A-Cube onboarding page.

Sign in​

The taxpayer signs in to EmaraTax, with UAE PASS or with the EmaraTax credentials for non-UAE PASS users. After a successful login, EmaraTax lists the taxable persons associated with the account.

EmaraTax sign-in page

Select the taxable person​

In the Taxable Person List, the taxpayer finds the entity to onboard and clicks View on its card.

Taxable Person List in EmaraTax

When the account manages many entities, the taxpayer can type the entity name or its TRN in the search bar.

Searching for a taxable person in EmaraTax

Open the e-invoicing section​

On the entity dashboard, the taxpayer clicks E-Invoicing in the left menu, or the TIN link under Your TIN for e-invoicing Onboarding.

Entity dashboard with the E-Invoicing menu and the TIN link highlighted

EmaraTax shows an e-Invoicing Action Required notice that summarizes onboarding, reverification and offboarding. The taxpayer clicks Proceed.

e-Invoicing Action Required notice

Choose A-Cube and leave EmaraTax​

The List of ASPs for onboarding tab lists the accredited providers. The taxpayer selects A-Cube, listed as PLATFORM ACUBE TECHNOLOGIES L.L.C, and clicks Proceed to ASP.

List of ASPs for onboarding

EmaraTax asks for confirmation before leaving the portal. The taxpayer clicks Yes, and EmaraTax redirects them to the A-Cube onboarding page.

Confirmation before leaving EmaraTax

On the A-Cube onboarding page​

The A-Cube onboarding page, Connect your EmaraTax account, completes the onboarding in four screens. The taxpayer has five minutes from the EmaraTax redirect to complete them.

Verify the taxpayer details​

The taxpayer enters the TIN, the email registered for the EmaraTax account administrator and, optionally, the mobile number, then clicks Verify. A-Cube checks these details against EmaraTax.

A-Cube onboarding page asking for the TIN, the EmaraTax email and the mobile number

Confirm the entity details​

A-Cube shows the company data registered in EmaraTax: TIN, legal names in English and Arabic, legal type, VAT TRN, effective date and contact details. The data comes from EmaraTax and cannot be edited here. The legal entity ID is still empty, because the legal entity does not exist yet.

The taxpayer ticks I confirm that the details above are correct and clicks Confirm and continue.

A-Cube onboarding page showing the company data from EmaraTax, with the confirmation checkbox

Wait for the synchronization​

A-Cube creates the legal entity, registers it on the Peppol SMP and synchronizes it with the central registry. The page shows the progress of each step. Each step starts only when the previous one succeeds, so the taxpayer must keep the page open until the end.

A-Cube onboarding page showing the progress of initialization, Peppol SMP synchronization and Central Registry synchronization

Onboarding completed​

The page confirms that the legal entity is connected and shows its legal entity ID in A-Cube.

A-Cube onboarding page confirming that the onboarding is complete

After onboarding​

Once the onboarding is complete, you can see the result both in EmaraTax and in A-Cube.

In EmaraTax, the Linkage Status with ASP tab, in the e-invoicing section of the entity, shows A-Cube with status Linked and the date of the change.

Linkage Status with ASP showing the Linked status

In A-Cube, GET /legal-entities/{legalEntityId} returns the legal entity with status set to Active. The response also lists enabledCapabilities, the Peppol document types the entity can receive.

Example response
{
  "legalEntityId": "002c5be6-e04f-4c9f-ac3f-9a7d116b1bf5",
  "tin": "{{tin_legal_entity_a}}",
  "status": "Active",
  "legalType": "L3",
  "nameEn": "Emirates Digital Technologies LLC",
  "nameAr": "الإمارات الرقمية للتقنيات ش.ذ.م.م",
  "effectiveDate": "2022-01-15T00:00:00+00:00",
  "vatTrn": "130176721701903",
  "contact": {
    "email": "admin@example.com",
    "mobile": null
  },
  "isEnabled": true,
  "enabledCapabilities": [
    {
      "key": "billing.invoice",
      "domain": "billing",
      "type": "invoice",
      "docScheme": "peppol-doctype-wildcard",
      "docValue": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:peppol:pint:billing-1@ae-1*::2.1",
      "processScheme": "cenbii-procid-ubl",
      "processValue": "urn:peppol:bis:billing"
    }
  ],
  "createdAt": "2026-08-13T10:52:47+00:00",
  "updatedAt": "2026-08-13T10:52:55+00:00",
  "smpSyncAt": "2026-08-13T10:52:52+00:00",
  "registrySyncAt": "2026-08-13T10:52:55+00:00"
}

The example shows only one capability. See the Quick Start for the full list.

To refresh the data of a linked taxpayer, or to remove the link, see Updating Legal Entity.

Errors and retries​

The A-Cube onboarding page shows the taxpayer what went wrong and what to do next. Each EmaraTax redirect can be used only once, so in most cases the taxpayer starts again from EmaraTax:

  • The TIN is not reserved. Nobody reserved the TIN, or the reservation was released. Reserve it, then the taxpayer starts again from EmaraTax.
  • The reservation has expired. Reserve the TIN again, which refreshes the reservation, then the taxpayer starts again from EmaraTax.
  • Verification is rejected. The email, the TIN or the mobile number do not match the details registered in EmaraTax. The taxpayer starts again from EmaraTax with the correct details.
  • A step cannot be completed. If the Peppol SMP or the central registry is temporarily unavailable, the page offers Try again, which repeats only the failed step without starting over.

When the taxpayer completes a link, re-verification or unlink, A-Cube sends the legal_entity.synchronized webhook to your account. See Event Types to follow the onboarding from your application.

Last updated on