How do I read a ZATCA validation response?

Errors in errorMessages mean the invoice was rejected; warningMessages mean it was accepted with warnings; infoMessages are passes. Paste the response into Matheel's free reader to see each code explained with its fix.

What does NOT_REPORTED mean in ZATCA's response?

The simplified invoice was rejected because of at least one error in errorMessages. Fix them and resend the invoice with the same counter (ICV) and UUID.

ZATCA response reader

Paste the answer ZATCA sent back for your invoice and see what every code means and how to fix it. Works with the raw validationResults JSON, a Matheel response, or a copied log line. Nothing is uploaded.

{
  "validationResults": {
    "infoMessages": [
      {
        "type": "INFO",
        "code": "XSD_ZATCA_VALID",
        "category": "XSD validation",
        "message": "Complied with UBL 2.1 standards in line with ZATCA specifications",
        "status": "PASS"
      }
    ],
    "warningMessages": [
      {
        "type": "WARNING",
        "code": "BR-KSA-29",
        "category": "KSA",
        "message": "If the cryptographic stamp (KSA-15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact \"urn:oasis:names:specification:ubl:signature:Invoice\" value for referenced signature ID and signature ID.",
        "status": "WARNING"
      }
    ],
    "errorMessages": [
      {
        "type": "ERROR",
        "code": "BR-KSA-28",
        "category": "KSA",
        "message": "If the cryptographic stamp (KSA-15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact \"urn:oasis:names:specification:ubl:signature:1\" value for signature information ID.",
        "status": "ERROR"
      }
    ],
    "status": "ERROR"
  },
  "reportingStatus": "NOT_REPORTED"
}

What it reads

ZATCA answers each clearance, reporting or compliance request with validationResults: infoMessages, warningMessages and errorMessages. Errors mean the invoice was rejected (clearance NOT_CLEARED, reporting NOT_REPORTED); warnings mean it was accepted but should be fixed. Every BR-KSA and EN 16931 code links to its explanation page, including the condition ZATCA's SDK actually runs.

To find the problems before you submit, run the invoice XML through the validator.