Connecting Qoyod with ZATCA - Phase Two (Fatoora Portal)

Phase 2 of Electronic Invoicing (Fatoora Portal)

This guide explains the complete steps for connecting Qoyod software with the General Authority of Zakat and Tax (ZATCA) in Phase 2 of electronic invoicing, starting from preparation, through obtaining the verification code from Fatoora Portal, and ending with confirming the successful connection and resolving common errors.

Before You Start (Very Important)

Before attempting to connect, make sure of the following points:

Add the tax identification number correctly
From:
Settings → General Settings
Business name in English
- Written in the business name field
- Must be:
  - In English
  - One word
  - Short
The name can be edited later after successful connection
Invoice designer is complete
- Must contain all required fields
- You can verify this through the guidance menu located next to the invoice designer
Phase 1 is activated
- Phase 2 cannot be connected if Phase 1 is not activated

Video and Supporting Materials (Sent to Customer)

The following materials should be sent to the customer before or during the explanation:

(These materials help reduce errors during implementation)

Steps to Connect Qoyod with the Tax Authority (Phase 2)

First: Go to the Connection Page in Qoyod from the Website

Go to Settings
Select Electronic Connection
Select Fatoora Portal
Click Start Connection
You will be asked for a verification code

Note:
The verification code does not arrive via SMS or email
You must obtain it manually from the Fatoora Portal

Second: How to Get the Verification Code from Fatoora Portal

Logging into Fatoora Portal

Fatoora Portal link:
https://fatoora.zatca.gov.sa/

Steps to Extract the Code:

Log into your business account on the authority’s website
Go to Fatoora Portal
Click Initialize a New Unit/Device
Select the number of verification codes:
- From 1 to 100 codes per hour
Click Create Activation Code
A list of codes will appear
Select one code only

Third: Enter the Verification Code in Qoyod

Return to the connection page in Qoyod software
Enter the verification code manually
- It cannot be copied or pasted
- You must type it digit by digit
Click Save

Very Important Note

Code validity: one hour only
If the validity expires:
- Generate a new code
- Use it immediately
Entering an expired code may display the error:
Exceed Character Limit

How Do You Confirm the Connection Was Successful?

An activated icon will appear next to the authority connection
This means the connection was successful

After Successful Connection:

The connection is made only once for the business
It is automatically activated for all users
Any new invoice after connection:
- Is sent automatically to the authority
Old invoices:
- Show the status not applicable

Very Important Notes

There is no separate field for the business name in English
It is entered in the business name field
The address must be:
- In Arabic
- Country: Saudi Arabia
- Otherwise, this error may appear:
  “You do not have permission to access”
You can choose:
- Official connection
- Or simulation (testing)
  depending on the environment type selected
If the business tax identification number is changed after the connection is completed, please contact the General Authority of Zakat and Tax and Income to be informed of the procedures you must follow.

Solving Common Connection Errors

Message: “Something went wrong, please try again”

Make sure:

Business name is in English + one word
Tax identification number is correct
Retry after editing the name

Message: Exceed Character Limit

Reason:

The code has expired (more than one hour)

Solution:

Generate a new code
Enter it manually immediately

Connection Status: “Processing”

Check:

Business name (English, one word)
Tax identification number
Address in Arabic and country is Saudi Arabia
Select the correct connection type (official/testing)
Phase 1 is activated

If everything is correct:

Log out from the authority website
Log back in
Create new codes
Try again

Keywords for inquiry
- How do I connect with the tax authority?
- How do I connect with the authority?
- I want to do Phase 2 of electronic invoicing, what do I do?
- What is the way to connect with Fatoora Portal?
- Why don’t I receive the verification code from the General Authority of Zakat and Tax?
- I need to connect with the authority
- I wanted to connect with the authority
- Where do I get the verification code from the authority?
- How do I enter the connection code in Qoyod?
- I need to connect with the tax authority
- Connection with the General Authority of Zakat and Tax
- We want to connect with the tax authority
- I got the option to connect with Fatoora Portal, what are the steps?
- Why doesn’t the connection with the authority work for me?
- How to connect Qoyod software with the tax and zakat system?
- Connection with the General Authority of Zakat
- How do I know if the connection was successful?
- I need to connect with the General Authority of Zakat and Income
- I want to connect with the Zakat and Income authority, Phase 2
- Do I have to change the business name to complete the connection?
- Activate Fatoora Portal
- Enable Fatoora Portal
- Electronic connection rejected “Something went wrong, please try again”
- How do I get the verification code I received from the General Authority of Zakat and Tax?
- I’m connecting with the tax authority, where do I get the connection number
- We need to connect with the tax authority
- Enter the verification code you received from the General Authority of Zakat and Tax. How do I get it?
- I need to connect with the authority
- I need a way to connect sales invoices with the authority
- Connection with the General Authority of Zakat and Tax

Connecting Qoyod with ZATCA – Phase Two (Fatoora Portal)