New Update: ZATCA XML Submission Handling and Debugging:

When submitting Sales Invoice or POS Invoice to ZATCA for e-invoicing, submissions can either succeed or fail. In case of success, the reported or cleared XML will be automatically attached to the respective invoice. This document explains how to handle failed submissions, including generating a debug XML to investigate and correct errors.

Failed Submission

If a submission fails due to XML validation errors:

• The failed XML is not attached automatically.
• The invoice remains in its current state without incorrect XML.
• To investigate the failure, a Debug XML must be generated.

Creating Debug XML To generate debug XML for failed submissions:

To generate debug XML for failed submissions:

• Open the Sales Invoice or POS Invoice that failed.
• Click the Options menu (three dots at the top-right corner).
• Select Create XML for Debug.
• This generates a debug XML and attaches it to the invoice.
• Use the debug XML to:
• Inspect all invoice fields.
• Identify the exact ZATCA validation errors.
• Correct the data before resubmitting.

Notes

• Debug XML is only needed for failed submissions.
• Successful submissions automatically attach the XML; no debug step is required.
• This feature is available for both Sales Invoice and POS Invoice.
• Always verify customer information, item rates, tax codes, and totals before resubmission.