How to get the linking code (OTP) from the Fatoora portal and link it in Osos

The linking code proves to ZATCA that you own the business. You create it in the Fatoora portal in under a minute, and it is valid for one hour only, so use it right away.

Steps

1
Search for the Fatoora portal
Search for “Fatoora portal” and open the official ZATCA site: fatoora.zatca.gov.sa. Check the address before signing in.
2
Sign in to the Fatoora portal
Open fatoora.zatca.gov.sa and sign in with your unique number or email and password: the same credentials as your business account with the Zakat, Tax and Customs Authority.
Open the Fatoora portal
3
Choose “Onboard new solution unit/device”
On the Fatoora platform page, press the arrow on the “Onboard new solution unit/device” card. This is the production environment, the one Osos links to.
4
Create the activation code and copy it
Confirm you are not a robot and enter the number of codes: one for each branch you want to link. Press “Create activation code” and the six-digit code appears. Copy it with the copy button next to it, and remember it is valid for one hour only.
5
Paste the code in Osos and link
In Osos, open the ZATCA settings, paste the code into the temporary activation code field, and press “Link production”. On the first link you also enter your business details, address, and activity, as in “How to issue your first tax invoice”. Osos does the rest and only declares the link once the six test invoices pass.

Frequently asked questions

How long is the activation code valid?

One hour from the moment it is created. If it expires before you use it, create a new one from the same page.

I have more than one branch. How many codes do I need?

One per branch. You can create up to 100 codes in one request, and link each branch with its code in Osos.

What is the difference between the production portal and the simulation platform?

Simulation is a test environment where invoices are not officially cleared. Osos links your business to production, so create the code from the main portal, not the simulation platform.

The link failed even though the code is correct. Why?

Usually because the code expired, or because the VAT number or address in Osos does not match what is registered with ZATCA. Review the details and create a new code.

How to issue your first tax invoice in Osos

Step by step: link your branch with ZATCA, add your customer, pick the product from inventory, issue the invoice, and send it to your customer on WhatsApp.

See how

Also see

How to issue a credit note for an approved tax invoice in Osos

Step by step: open the approved tax invoice, issue a credit note for its full value with a return reason, send it to ZATCA, and return the quantities to inventory. Plus how the amount is handled when the invoice is paid.

4 steps

See how

How to enter supplier invoices with AI in Osos

Step by step: upload the supplier invoice and AI reads it, save it as a draft and approve it, or upload a whole folder and review each invoice beside its paper.

7 steps

See how