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.
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.
Add the branch
Enter the primary branch’s name, identifier and address in Branch Details. Continue to Source Details.
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.
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 for the full request and response contract. Next, prepare a UAE sandbox request.
Last updated