Introduction
When the ZATCA integration is active, all newly generated invoices and receipts are automatically submitted to the ZATCA platform. However, if the ZATCA integration was temporarily disabled for any reason, the invoices created during that period would not have been sent. To ensure compliance, these missing invoices need to be resent to ZATCA once the integration is active again.
-
This article describes how to resolve missing invoices in ZATCA within PGM integration.
-
The article will be helpful for PG Champions and Cub Owners.
Before you start
- To activate the ZATCA integration for your Perfect Gym instance, please ensure you have already contacted and worked with the Perfect Gym Support team to complete the initial setup.
Fast lane
- Generate the Report_ZATCAInvoices for the desired date range and filter for invoices with the status "Not Submitted."
- Go to PGM / Settings / Support Tools / Mass Actions.
- Locate the 'Invoices and Receipts' section.
- Enter the RowIds or, if RowIds are not available, the RelatedInvoiceRowIds obtained from the report in Step 1.
- Execute the mass action.
Instruction
All invoices/receipts created when ZATCA integration was disabled, should be re-send to ZATCA, if:
-
ZATCA API is not responsible
-
SaudiArabiaInvoicing service (connector) is not responsible
-
SaudiArabiaInvoicing database is not responsible
How to resolve missing invoices in ZATCA
STEP 1 - Generate the ZATCA Invoices Report
1. Go to PGM → Reports and open Report_ZATCAInvoices.
2. Choose the relevant date range covering the period during which the integration was inactive.
3. Filter the report to only show invoices with the "Not Submitted" status.
4. Take note of the RowIds. If those aren’t visible, use the RelatedInvoiceRowIds instead.
STEP 2 - Use the Mass Actions Tool
1. Navigate to PGM → Settings → Support Tools → Mass Actions.
2. Scroll to the section titled Invoices and Receipts.
3. In the appropriate field, paste the collected RowIds or RelatedInvoiceRowIds.
4. Click to execute the action. This will trigger the system to resend those invoices to ZATCA.
Hints
If you have any problems with re-send invoices using Support tools → Mass Actions in PGM, please contact the Perfect Gym Support team.