Guide for Activating ZATCA Phase 2 (E-Invoice)

This guide will help to activate ZATCA Phase 2

Adding Business/Branch Details

From the Console, add the following details:

1. Business/Branch Commercial Registration Number
2. Business/Branch Tax Registration Name
3. Business/Branch Tax Number
4. Branch Street Name
5. Branch Building Number
6. Branch Additional Number
7. Branch City
8. Branch District
9. Branch Postal Code

To Edit Branch Details:

1. Navigate to: Console > Manage > Branches
2. Click on the desired branch.
3. Select Edit Branch and fill in the details as mentioned above.

To Edit Business Details:

1. Navigate to: Console > Profile Icon > My Account > Business Details
2. Fill in the details as mentioned above.

Requirements for Invoice Sync

To ensure that invoices sync without issues, the following conditions must be met:

1. The account must have a single tax rate of 15% as per ZATCA requirements.
2. This tax rate must be assigned to all tax-related entities (branches, products, modifier options, and charges), even if the product/option price is 0. A tax group must be assigned for proper integration.
3. The cashier app must be updated to version 5.0.81 or above. For the Foodics One app, ensure it is updated to version 5.8.2 or above.

Potential Issues if Requirements Are Not Met

If any of the above requirements are not met, the following issues may occur:

1. Invoice fails to sync with the ZATCA system.
2. The invoice syncs with ZATCA but with incorrect numbers (e.g., the tax amount in Foodics is 3 but syncs with ZATCA as 4.5 due to incorrect tax configuration).
3. The QR code data scanned with the ZATCA app may differ from the Foodics receipt (e.g., the receipt shows a total price of 200, but the ZATCA app shows 186.96 due to incorrect tax configuration).

Synchronizing Data

After entering all the required details in the console, sync data from the cashier to reflect the changes.

Generating OTP from Fatoora Portal and Activating E-Invoice

1. Log in to Fatoora Portal.
2. Click on "Onboard New Solution Unit/Device." make sure you are not using the test environment 
3. Enter the number of OTP codes to be generated.
4. The generated codes will be displayed. Note: The OTP is valid for 1 hour and for one use only. If the client fails to use the code for any reason, it cannot be used again.
5. From the cashier: Home > E-Invoice (Zatca) > Enter the OTP and click on Activate.
   The status should change to active.