Clarification on ZATCA Phase 2 Simulation and Live Mode Integration

XML and business rules
1

Dear Sir,

We have developed the ZATCA Phase 2 integration, and it is currently working perfectly in developer mode. We are now planning to move to simulation mode. I noticed that you mentioned simulation requires a real VAT account and that we must select either live or simulation mode. I have some questions, as this is our first time integrating with ZATCA. Please provide detailed clarification:

  1. For simulation mode, do we need to use the real application, or is a copy of the testing/development application sufficient?

  2. If we use the real application in simulation mode and run it for a week without issues, can we then switch to live mode?

  3. Can I use the real business VAT account in simulation mode? Once everything works fine, can I simply switch to live mode?

  4. During simulation mode, what are the main things we should monitor or be aware of?

  5. After switching to live mode, if any issues occur (e.g., an invoice is not synced or cannot be synced on the current day), how can we sync that invoice the next day?

2

Dear @Askarali ,

Thank you for reaching out.

Please find the answers to the gives questions below:

A1- an application that still in testing/development phase Is fine, as simulation environment is only for testing purposes.

A2- There are no restrictions from ZATCA on this area, so yes you can, just make sure to comply with the enforcement date depending on your wave.

A3- Yes the real VAT account can be used in simulation, and to switch, you need to perform the full onboarding (integration) process again using Fatoora production portal & Production API endpoints.

A4- Make sure to test all of the functional scenarios that your solution will perform in production environment, and fix them if any error is being revived before going to production environment.

A5- Simplified tax document should be reported within 24 hours of issuance date, while the standard tax documents have more flexible time, passing 24 hours for simplified will nor prevent you from submission, as it will be “accepted with warning” with 202 code, just make sure that the delaying issue is resolved in future submission, if such scenario happened due to an out of hand technical issue especially if the invoices payload are large, then you should raise a failure notification to avoid any warnings/penalties specifying the challenged you faced.

I hope it’s clear now,

Regards,