ZATCA e-Invoice Phase II Extension for Manager.io

@Mawali

we give the access as you mentioned and it’s worked and he can send the invoice to ZATCA but there is issue to update QR in invoice.

It worked :+1:

This process is too complex, as eInvoicing requires interconnected data processing. It would be better if only users with the Administrator role, or restricted users with full access permissions, are allowed to submit eInvoices.

i need solution pls

Please try again, it should be fixed now.

Hi @Mabaega , we have successfully integrated to ZATCA phase 2 and everything is working fine as long as the items with standard rate 15% VAT, however all other tax codes (0%, Exempt) doesn’t work and we get the below error from ZATCA when trying to submit an invoice,

errorMessages": [
{
“status”: “ERROR”,
“type”: “ERROR”,
“code”: “BR-CL-18”,
“category”: “EN_16931”,
“Message”: “Invoice tax categories MUST be coded using UNCL5305 code list”
}

can you please support to resolve the issue?

Hello @Mabaega,

I got this error today trying to validate an invoice with ZATCA:

MANAGER DATA
------------

{
  "issueDate": "2025-12-30T00:00:00",
  "dueDate": 0,
  "dueDateDays": 30,
  "dueDateDate": null,
  "reference": "100051050006137",
  "exchangeRate": 1.0,
  "exchangeRateIsInverse": false,
  "customer": {
    "name": "Space Travel & Tourism",
    "currency": {
      "code": "SAR",
      "name": "Saudi Riyals",
      "symbol": null
    },
    "customFields2": {
      "strings": {
        "a1b2c3d4-e5f6-4abc-8def-abcdef000012": "Space Travel & Tourism",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000010": "311197392300003",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000004": "Prince Faisal Bin Fahad Road",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000005": "4839",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000011": "VAT",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000007": "Al Khobar",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000006": "Madinat Al Ummal Dist",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000009": "",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000008": "3441",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000021": "TIN",
        "a1b2c3d4-e5f6-4abc-8def-abcdef000022": "311197392300003"
      },
      "decimals": {},
      "dates": {},
      "booleans": {},
      "images": {}
    }
  },
  "description": "1. Mr ISLAM MUSHEER KHAN (ADT)",
  "lines": [
    {
      "item": null,
      "qty": 1.0,
      "salesUnitPrice": 370.0,
      "taxCode": {
        "name": "0%",
        "label": null,
        "type": 0,
        "taxRate": 0.0,
        "rate": 0.0,
        "account": null,
        "components": [
          {
            "componentRate": 0.0
          }
        ],
        "customFields2": null
      },
      "discountAmount": 0.0,
      "discountPercentage": 0.0,
      "customFields2": {
        "strings": {},
        "decimals": {},
        "dates": {},
        "booleans": {},
        "images": {}
      }
    }
  ],
  "discount": false,
  "discountType": 0,
  "withholdingTax": false,
  "withholdingTaxType": 0,
  "withholdingTaxPercentage": 0.0,
  "withholdingTaxAmount": 0.0,
  "customFields2": {
    "strings": {
      "a1b2c3d4-e5f6-4abc-8def-abcdef000020": "2025-12-30 19:53:27",
      "a1b2c3d4-e5f6-4abc-8def-abcdef000014": "30 | Credit",
      "a1b2c3d4-e5f6-4abc-8def-abcdef000013": "01"
    },
    "decimals": {},
    "dates": {},
    "booleans": {},
    "images": {}
  },
  "amountsIncludeTax": true,
  "salesInvoice": null
}


SERVER RESPONSE
---------------

{
  "serverResult": {
    "requestUri": "https://gw-fatoora.zatca.gov.sa/e-invoicing/developer-portal/compliance/invoices",
    "requestType": "Invoice Compliant Check",
    "statusCode": "400-BadRequest",
    "clearanceStatus": "NOT_CLEARED",
    "validationResults": {
      "status": "ERROR",
      "infoMessages": [],
      "warningMessages": [
        {
          "status": "WARNING",
          "type": "WARNING",
          "code": "BR-CO-16",
          "category": "EN_16931",
          "Message": "Amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) -Pre-Paid amount (BT-113) + Rounding amount (BT-114)."
        },
        {
          "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-10",
          "category": "KSA",
          "Message": "BR-KSA-10 - Where the Buyer Country Code (BT-55) is other than 'SA' Buyer address must contain a street (BT-50), city (BT-52), country code (BT-55). This rule does not apply on the simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02)."
        },
        {
          "status": "WARNING",
          "type": "WARNING",
          "code": "BR-KSA-EN16931-08",
          "category": "KSA",
          "Message": "[BR-KSA-EN16931-08]-Only one tax total (BG-22) with tax subtotals must be provided.Refer to Calculation of VAT ."
        },
        {
          "status": "WARNING",
          "type": "WARNING",
          "code": "BR-KSA-EN16931-09",
          "category": "KSA",
          "Message": "[BR-KSA-EN16931-09]-Only one tax total (BG-22) without tax subtotals (BG-23) must be provided when tax currency code is provided."
        }
      ],
      "errorMessages": [
        {
          "status": "ERROR",
          "type": "ERROR",
          "code": "XSD_ZATCA_INVALID",
          "category": "XSD validation",
          "Message": "Schema validation failed; XML does not comply with UBL 2.1 standards in line with ZATCA specifications. ERROR: org.xml.sax.SAXParseException; lineNumber: 90; columnNumber: 11; cvc-complex-type.2.4.b: The content of element 'Invoice' is not complete. One of '{\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\":InvoiceLine}' is expected."
        },
        {
          "status": "ERROR",
          "type": "ERROR",
          "code": "BR-16",
          "category": "EN_16931",
          "Message": "An Invoice shall have at least one Invoice line (BG-25)"
        },
        {
          "status": "ERROR",
          "type": "ERROR",
          "code": "BR-CO-18",
          "category": "EN_16931",
          "Message": "An Invoice shall at least have one VAT breakdown group (BG-23)."
        }
      ]
    }
  },
  "approvalStatus": "REJECTED",
  "success": false,
  "base64QrCode": "",
  "decodedBase64QrCode": ""
}

The Invoice has a Line-Account field set but in the Manager Data section it shows null.

1 Like

It appears that regarding the Manager-io update, the Extension failed to retrieve data from the manager. I shall investigate it further.

1 Like

@Mabaega @lubos Dear Gentlemen, kindly your support

I did not encounter a similar issue in Desktop Edition v26.1.5.3159 and Cloud Edition v26.1.7.3167.

@Mabaega @lubos i am facing this issue when integrating with ZATCA e-Invoice phase ll

done