> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fatorly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Link your business to Fatorly through EmaraTax, step by step, and activate e-invoicing.

Onboarding creates the link between your business and Fatorly as your Accredited
Service Provider. You start in **EmaraTax**, the FTA portal, and finish in a short
two-step wizard on our side.

<Note>
  You do **not** need a Fatorly account first. If you continue without signing in, we
  create your account from the details the Federal Tax Authority has verified, on the
  Free plan. If you already have an account, you can sign in during the wizard so the
  link attaches to it.
</Note>

## Part 1 — In EmaraTax

<Steps>
  <Step title="Open the e-Invoicing service">
    Sign in to EmaraTax, choose the taxable person you're linking, and open
    **E-INVOICING** from the left-hand menu.

    The service page explains what onboarding, reverification and offboarding do.
    Read it, then tick **I confirm that I have read the above instructions and
    guidelines** at the bottom.

    <Frame>
      <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/emaratax-service-intro.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=4d46738163f92fd222217575c7878235" alt="The EmaraTax e-Invoicing service page, with the read-confirmation checkbox at the bottom" width="1565" height="469" data-path="images/en/fta-linking/emaratax-service-intro.png" />
    </Frame>
  </Step>

  <Step title="Choose the action">
    EmaraTax shows an **e-Invoicing Action Required** popup describing the three
    actions available to you. Select **Proceed**.

    <Frame>
      <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/emaratax-action-popup.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=786e3885622dd12f033a21bdbd7d76c1" alt="The e-Invoicing Action Required popup listing Onboarding, Reverification and Offboarding" width="1565" height="524" data-path="images/en/fta-linking/emaratax-action-popup.png" />
    </Frame>
  </Step>

  <Step title="Pick Fatorly from the list of providers">
    You'll see the list of accredited service providers for your TIN. Search for
    **Hamwi Computer Software L.L.C** — that is Fatorly's registered entity, **ASP
    ID 115154** — select the radio button on its row, and choose **Proceed to ASP**.

    <Frame>
      <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/emaratax-choose-asp.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=f3f59ed4bcfa332fbff30499cea88e8c" alt="The list of ASPs filtered to Hamwi Computer Software L.L.C, ASP ID 115154, with its row selected" width="1565" height="294" data-path="images/en/fta-linking/emaratax-choose-asp.png" />
    </Frame>

    <Tip>
      Your TIN is shown just above the table, as **TIN for e-Invoicing Onboarding**.
      That's the number you'll enter on the next screen.
    </Tip>
  </Step>

  <Step title="Confirm you're leaving EmaraTax">
    A confirmation popup appears. Choose **Yes** to continue to Fatorly.

    <Frame>
      <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/emaratax-leave-popup.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=2939b72b6fc48c62b6492a3d7dfef3b0" alt="EmaraTax confirmation popup before handing over to the service provider" width="1565" height="524" data-path="images/en/fta-linking/emaratax-leave-popup.png" />
    </Frame>
  </Step>
</Steps>

## Part 2 — In the Fatorly wizard

EmaraTax hands you to us with a secure, single-use request. The wizard has two
steps, shown by the indicator across the top, and a **15-minute countdown** in the
bottom-left corner.

### Step 1 — Applicant details

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-step1-blank.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=89ebfd2149c5444cd1b5d93336a9be9b" alt="Step 1 of the linking request, with empty applicant detail fields" width="512" height="540" data-path="images/en/fta-linking/wizard-step1-blank.png" />
</Frame>

| Field                                  | Required | Notes                                      |
| -------------------------------------- | -------- | ------------------------------------------ |
| **Registered EmaraTax E-mail Address** | Yes      | Must be the address the FTA holds for you. |
| **TIN (Tax Identifier Number)**        | Yes      | Exactly 10 digits, starting with `1`.      |
| **Registered Mobile Number**           | No       | The mobile number registered with the FTA. |

**Verify Applicant Details** stays greyed out until every field passes format
validation — so if the button won't respond, a field is still invalid.

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-step1-errors.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=ab2835a9deb882bcaeb85823ec12a9fc" alt="Step 1 showing an e-mail format error and a TIN format error, with the Verify button disabled" width="512" height="540" data-path="images/en/fta-linking/wizard-step1-errors.png" />
</Frame>

<Warning>
  Format validation only checks the *shape* of what you typed. It cannot tell whether
  an e-mail address is the one the FTA holds — only the FTA can, when you select
  **Verify Applicant Details**. See
  [Troubleshooting](/en/fta-linking/troubleshooting) if verification is refused.
</Warning>

### Step 2 — Review & confirm

Once the FTA verifies you, it returns your registration details. They are filled in
for you and **cannot be edited** — they are the FTA's record, not ours.

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-step2-review.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=51f63b94fe4e851ca976d0f7478d9c08" alt="Step 2, Review and Confirm, with the FTA-returned details filled in and non-editable" width="512" height="540" data-path="images/en/fta-linking/wizard-step2-review.png" />
</Frame>

| Field                                                  | What it is                                                                                                                                                    |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Legal Type**                                         | The FTA's legal-type code for your entity.                                                                                                                    |
| **Entity Legal Name in English / Arabic**              | Your registered legal names.                                                                                                                                  |
| **Vat TRN**                                            | Your VAT Tax Registration Number — **may be empty, or may differ from your TIN's own registration**. See [Kinds of taxpayer](/en/fta-linking/taxpayer-types). |
| **Effective Date of Registration / Joining VAT group** | Date of registration, or of joining the VAT group.                                                                                                            |

Tick **I confirm that the above details are correct and I wish to proceed with the
submission**, then select **Submit**. The checkbox gates the button — Submit stays
disabled until you tick it.

### Confirmation

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-linking-confirmed.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=8539f80e73144650756b1272d1a1386b" alt="Linking Confirmed screen, showing the linked TIN" width="512" height="540" data-path="images/en/fta-linking/wizard-linking-confirmed.png" />
</Frame>

The confirmation screen carries **your TIN**, so you can keep it as a record of
which taxpayer was linked. We also e-mail an invitation to the registered address so
you can set a password and sign in.

At this point we register your business on the Peppol network as `0235:<your TIN>`,
and you can start issuing invoices. See
[Create / Edit an Invoice](/en/invoicing/create-invoice).

## Checking it worked

Back in EmaraTax, the **Linkage Status with ASP** tab shows a row for your TIN with
status **Linked**, our ASP ID, and the date.

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/emaratax-linked-row.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=5830dbacb6d8d8c3ce1b0746f005c433" alt="The EmaraTax Linkage Status table showing a Linked row" width="1565" height="294" data-path="images/en/fta-linking/emaratax-linked-row.png" />
</Frame>

<Note>
  The table holds **one row per linkage** and updates that row in place. If you have
  linked and unlinked before, you'll see the earlier rows here too, each with its own
  status and date.
</Note>
