Zatca PhII Error

[Asimirza]

While posting the invoice for clearance after the compliance check was successful, I am getting an error (pop up window) -

" Update Zatca Reference Error: Network Response was not ok".

Can you please guide me to resolve this issue. Thanks in advance

[Asimirza]

Attached is the screenshot of error message.

[Mabaega]

I cannot confirm the cause yet.
But this error relates to access rights for data recording through the managers API.

I did not encounter problems like this from my test today.

If you receive an error like this, it is advisable not to attempt to submit another invoice, because your invoice will not be approved by Zatca due to the previous invoice reference error.

You must manually record Zatca Reference by following the guidelines here.
https://forum.manager.io/t/issue-with-zatca-integration-in-manager-io/63429/17?u=mabaega

Once completed, you can then attempt to send the next invoice. Make sure you log in to the manager using an Administrator Account to report the invoice.

[Asimirza]

@Mabaega

https://forum.manager.io/t/issue-with-zatca-integration-in-manager-io/63429/17?u=mabaega

Dear @Mabaega,
Thank you for your swift response.

Unfortunately, I’m unable to access the page you shared. Additionally, I’m still facing an issue where my previously cleared invoices are displaying the QR code for Phase I instead of Phase II.

Could you please guide me on how to rectify this and ensure that the QR codes on earlier invoices are updated to comply with Phase II requirements?

Attach is the screenshot which shows I am unable to open the link( https://forum.manager.io/t/issue-with-zatca-integration-in-manager-io/63429/17?u=mabaega)

provided by your good self.

[Tut]

No. I know nothing about this. Questions like this belong on the public forum.

[Mabaega]

For everyone who experiences something similar

ZATCA Invoice Fix Guide - Manual Form Modification

Overview

This guide helps you manually modify invoice forms when automatic processing fails, by temporarily disabling form validation scripts and updating ZATCA-related fields.

Step 1: Disable Form Validation Scripts

Modify CustomField Descriptions

You need to modify the following CustomFields:

• Approval Status
• Base64 QRCode
• Zatca UUID
• Zatca Certificate Info

For each CustomField:

1. Go to Settings → Custom Fields
2. Find and Edit the CustomField
3. Locate the Description field
4. Find the script tag that starts with:

   <script> document.addEventListener('DOMContentLoaded', () =>
   

5. Add “xxx” at the beginning to disable it:

   <script>xxx document.addEventListener('DOMContentLoaded', () =>
   

6. Save the changes

Purpose: This prevents the form locking script from running, allowing you to modify and save the form manually.

Step 2: Extract Values from Success Report

1. Download the ZIP file generated after successful reporting/clearance
2. Open the TXT file inside the ZIP archive
3. Copy the following values from the TXT file:
   • ApprovalStatus
   • ZatcaUUID
   • Base64QrCode
   • ICV value (for Last ICV)
   • InvoiceHash value (for Last PIH)

Step 3: Update Business Details

1. Go to Settings → Business Details
2. Edit the business details
3. Update the following fields:
   • Last ICV: Enter the ICV: value from the TXT file
   • Last PIH: Enter the InvoiceHash: value from the TXT file
4. Save the changes

Step 4: Update Failed Invoice

1. Open/Edit the invoice that failed processing
2. Manually fill the following fields with values from the TXT file:
   • Approval Status: Enter the ApprovalStatus value
   • Zatca UUID: Enter the ZatcaUUID value
   • Base64 QRCode: Enter the Base64QrCode value
3. Save the invoice

Step 5: Re-enable Form Validation Scripts

Restore CustomField Descriptions

1. Go back to Settings → Custom Fields
2. Edit each of the four CustomFields again:
   • Approval Status
   • Base64 QRCode
   • Zatca UUID
   • Zatca Certificate Info
3. Remove the “xxx” from the script tags:

   <script>xxx document.addEventListener('DOMContentLoaded', () =>
   

   Should become:

   <script> document.addEventListener('DOMContentLoaded', () =>
   

4. Save all changes

Important Notes

• This process temporarily disables form validation to allow manual data entry
• Always re-enable the scripts after completing the manual updates
• Keep the TXT file from successful reports as reference for future manual fixes
• This method should only be used when automatic ZATCA processing fails

Troubleshooting

• If you can’t save the form, ensure all validation scripts are properly disabled (step 1)
• Double-check that values copied from TXT file are complete and accurate
• Verify that Last ICV and Last PIH are updated in Business Details before processing new invoices

[Asimirza]

For Step 2: Extract Values from Success Report

Shall I use the ICV & Invoice hash of the failed invoice or the previous cleared invoiced.
As presently the previous cleared invoice data is already mentioned in the Business details.

[Mabaega]

Yes, that’s correct

[Asimirza]

Thanks.

Can you please answer my another query related to the QR code. M

y previously cleared invoices are displaying the QR code for Phase I instead of Phase II .

[Asimirza]

I am using cloud version 25.6.26.2445.