[PRODUCTION] INVOICE_UUID_VALIDATION - MISSING_UUID_IN_INVOICE despite UUID present in XML

Clearance and Reporting
1

Hi team,

We are experiencing an intermittent UUID validation error in the PRODUCTION environment and would appreciate any insights from the community.

Error Response:

{
  "type": "ERROR",
  "code": "INVOICE_UUID_VALIDATION",
  "category": "MISSING_UUID_IN_INVOICE",
  "message": "UUID ERROR",
  "status": "ERROR"
}

What we observed:

  • The error indicates UUID is missing, however upon inspecting the raw XML payload sent to ZATCA, the CBC:UUID element is present and populated
  • This is not occurring for all invoices — only a few were affected
  • The failures were observed on 17th May 2026
  • The same integration has been processing other invoices successfully

Our questions:

  1. Has anyone else observed MISSING_UUID_IN_INVOICE errors on Production around 17th May despite UUID being present in the payload?
  2. Could there be any known Production environment instability or validator behaviour around that date?
  3. Are there any edge cases in UUID format or placement that could cause the validator to report missing UUID even when it is present ?

Any guidance from the community or ZATCA team would be greatly appreciated.

Thank you!