Introduction
Welcome to the official A-Cube documentation dedicated to the United Arab Emirates market.
Use the A-Cube UAE API to onboard UAE 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 EmaraTax onboarding flow. Your application then sends structured PINT AE UBL XML to A-Cube. A-Cube validates it, exchanges it through Peppol, and reports the required tax data to the Federal Tax Authority (FTA).
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 UAE domestic market (supporting PINT AE UBL XML) and for international transactions.
- Tax Reporting: The complete management of tax reporting through Tax Data Document (TDD) and Message Level Status (MLS) messages.
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
- 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://ae-sandbox.api.acubeapi.com
-
production is the environment where real document exchange happens. The base URL is https://ae.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 UAE 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.