FATOORA Simulation portal is an additional optional tool for end-to-end functional testing for taxpayers. It is not intended for load testing.
A. Taxpayer accessing and logging into the FATOORA simulation portal
The user can access FATOORA simulation portal through this link https://fatoora.zatca.gov.sa/ or through ZATCA’s website by clicking on Fatoora’s icon to redirect to FATOORA simulation portal in both language Arabic or English.
Please note, these credentials are different from credentials used for Developer Portal.
The user can access the portal using his ERAD Credentials:
● TIN or email registered with ZATCA
● Password
B. Fatoora Portal Landing Page
To switch to the FATOORA Simulation Portal, click on the “FATOORA Portal Simulation” on the top right corner.
C. Introduction
Before continuing to the Fatoora Simulation Portal, please read and understand the full terms and conditions. After checking the box of acknowledgment, you may click on “Next” to continue
D. Fatoora Simulation portal Page
After accessing Fatoora Simulation portal, click on “onboard new solution unit/device”. To switch to the FATOORA Portal, click on “FATOORA Portal” on the top right corner
The Taxpayer choses to generate OTP code(s) for single or multiple EGS Unit(s) by entering the number of OTP codes they would like to be generated.
Please note, user may be required to complete a reCaptcha authentication step before they are able to proceed to the next step.
E. Generation of OTP
The FATOORA Simulation Portal generates the OTP code(s) (valid for 1 hour), which will be dis- played on the Portal and can be copied or downloaded in a file.
The Taxpayer enters the OTP code(s) on their own EGS Unit(s) within 1 hour of the OTP code’s generation.
F. Renewing Existing Cryptographic Stamp Identifier (CSID)
After accessing Fatoora Simulation portal, click on “Renewing Existing Cryptographic Stamp Identifier (CSID)”.
The Taxpayer choses to generate OTP code(s) for single or multiple EGS Unit(s) which require renewed Existing Cryptographic Stamp Identifiers (CSIDs) by entering the number of OTP codes they would like to be generated.
The Fatoora Simulation portal generates the OTP code(s) (valid for 1 hour), which will be displayed on the Portal and can be copied or downloaded in a file.
The Taxpayer enters the OTP code(s) on their own EGS Unit(s) which requires renewed Existing Cryptographic Stamp Identifier (CSID) within 1 hour of the OTP code’s generation.
G. View list of onboarded solutions and devices and revocation process.
After accessing Fatoora simulation portal, click on “View list of solutions and devices” Similarly as in Fatoora portal, taxpayer can view list of onboarded devices to the Fatoora simulation portal. Note, Fatoora portal and Fatoora Simulation portal are 2 independent environments and devices are onboarded to each independently.
The user will be able to view a list that includes a summary of all EGS Unit(s) that have been onboarded by the user. In addition, the user can filter, sort and search based on specific inputs available in the list of Solutions and Devices. Also, the user can revoke any of the listed devices by clicking on the device and then clicking “revoke”.
The user is prompted to click on a confirmation message before proceeding with the revocation.
Once the user confirms, the CSID(s) is/are revoked and the EGS Unit(s) is/are longer active. Please note, once user clicks confirmed, the action is no longer reversible. Nevertheless, taxpayer can onboard the device again as a new device.
H. E-invoicing statistics
After accessing Fatoora Simulation portal, click on “E-invoicing statistics”:
The user will be able to view summarized statistics of all documents submitted in the past 12 months for Reporting and Clearance, split in terms of “Accepted documents”,
“Accepted documents with warnings” and “Rejected documents”. For the latter two, the Taxpayer can request the detailed CSV files of the errors and warnings.
I. API Documentation
After accessing Fatoora Simulation portal, click on “API Documentation”.
The Taxpayer will be redirected to the Developer Portal. For instructions on how to use the Developer Portal, please review the Developer Portal User Manual.
Please note, these credentials are different from credentials used for Fatoora Portal.
