# Onboard a UAE company

Register a UAE company and its first invoice source so you can send sandbox documents. Have the company's 10-digit TIN, administrator email, branch details and source name/version ready.

> **Before you start**
>
> Choose **United Arab Emirates** and **Sandbox** in the Invoice Portal. Get the company’s actual 10-digit tax identification number (TIN), not its 15-digit VAT registration number (TRN). Confirm the company’s authorization to use its accredited service provider (ASP), the provider that exchanges its e-invoices. Have the account administrator’s email, primary branch address, and a source name and version for the sending system ready. A sandbox registration does not establish production readiness.

## Step 1: Verify the company identity

Open **Onboard** and choose **Add Company**. Enter the **Tax Identification Number (TIN)** and **Account Admin Email** on **Identity Verification**. **Mobile Number** is optional. Choose **Verify with EmaraTax**. You should advance to **Branch Details** when verification succeeds.

## Step 2: Add the branch

Enter the primary branch’s name, identifier and address in **Branch Details**. Continue to **Source Details**.

## Step 3: Add the invoice source

Enter **Source Name** and **Source Version** for the system that sends invoices from this branch. Keep these values: the Unify API uses them together as `name:version` in its `source` field.

## Step 4: Review and finish

Check the company identity, branch and source on **Review & Complete**, then complete onboarding. The company appears under **Onboard** with its branches, source details and registration status. Check its status before sending an invoice; a pending registration is not ready.

## If something goes wrong

- **Identity verification fails:** compare the TIN and administrator email with the company’s registered details. Do not substitute the 15-digit TRN for the TIN.
- **`ASP_LINKAGE_NOT_FOUND`:** ask the company’s authorized administrator to check its ASP authorization for the selected environment before trying again.
- **The company stays `Pending`:** use **Refresh status** if offered, then check again later. If it does not change, contact support with the company and request identifier.
- **The company is already onboarded:** find its existing record rather than creating a duplicate.

If you onboard through an API instead of the Invoice Portal, use [Create a company](https://docs.complyance.io/api/?operation=createCompany) for the full request and response contract. Next, [prepare a UAE sandbox request](https://docs.complyance.io/countries/ae/examples/).

Source: https://docs.complyance.io/countries/ae/onboarding/