Clarification Required on ZATCA Validation Warnings and Errors

General
1

Dear Sir,

Please review the following ZATCA validation responses received from our system. We need your clarification on a few specific issues:

1. BR-CO-17

  • The customer sells products in large quantities (e.g., 2,000 units) with very small prices (e.g., 0.75 or 1.65 SAR).

  • Since we currently use two decimal places, rounding automatically occurs.
    :right_arrow: Can we use four decimals for unit prices to avoid rounding discrepancies? Is this acceptable as per ZATCA?

Additionally, sometimes the cashier mistakenly applies Order Tax, but the total tax amount is still calculated correctly — could this situation trigger the same warning?

2. BR-CL-14

  • During onboarding, we already provided the country code “SA”.
    :right_arrow: Could this warning mean the customer address field also requires “SA” or “Saudi Arabia”?

3. BR-KSA-F-08

  • The CR Number has already been added in the proper format (CRNxxxxxx) as per ZATCA guidelines.
    :right_arrow: Why is this warning still appearing?

Please review the full validation response below and advise accordingly.

Validation Response (NOT CLEARED)

{
  "success": false,
  "response": {
    "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-CO-17",
          "category": "EN_16931",
          "message": "VAT category tax amount (BT-117) = VAT category taxable amount (BT-116) x (VAT category rate (BT-119) / 100), rounded to two decimals.",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-S-09",
          "category": "EN_16931",
          "message": "The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is 'Standard rated' shall equal the VAT category taxable amount (BT-116) multiplied by the VAT category rate (BT-119).",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-CL-14",
          "category": "EN_16931",
          "message": "Country codes in an invoice MUST be coded using ISO code list 3166-1",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-KSA-F-08",
          "category": "KSA",
          "message": "[BR-KSA-F-08] - The value provided in Other Seller ID (BT-29) or Other Buyer ID (BT-46) for the scheme ID 'CRN' appears to be incorrect. Please recheck the value to avoid non-compliance.",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-KSA-42",
          "category": "KSA",
          "message": "The buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2)",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-KSA-F-10",
          "category": "KSA",
          "message": "[BR-KSA-F-10] - The value provided in Other Buyer ID (BT-46) for the scheme ID 'NAT' appears to be incorrect. Please recheck the value to avoid non-compliance.",
          "status": "WARNING"
        },
        {
          "type": "WARNING",
          "code": "BR-KSA-F-06-C12",
          "category": "KSA",
          "message": "[BR-KSA-F-06-C12] - Field character limits for Buyer name field (BT-44) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters.",
          "status": "WARNING"
        }
      ],
      "errorMessages": [],
      "status": "WARNING"
    },
    "clearanceStatus": "CLEARED",
    "clearedInvoice": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K..."
  }
}

Thank you for your assistance. We appreciate your clarification on the above points.