Recently we’re facing issue with reporting an invoice that is supposed to where VAT exemption is needed, as per the doc for Export of Goods use reason code VATEX-SA-32
I tried chaning the tax percentage to be 0 as well but it is giving the error as I attach. Also attaching the payload.
This XML file does not appear to have any style information associated with it. The document tree is shown below.
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2">
<cbc:ProfileID>reporting:1.0</cbc:ProfileID>
<cbc:ID>Invo-0001238</cbc:ID>
<cbc:UUID>09a66900-c32c-437f-a849-f6d88b4fc01d</cbc:UUID>
<cbc:IssueDate>2024-10-11</cbc:IssueDate>
<cbc:IssueTime>21:16:00</cbc:IssueTime>
<cbc:InvoiceTypeCode name="0200000">388</cbc:InvoiceTypeCode>
<cbc:Note languageID="en"/>
<cbc:DocumentCurrencyCode>SAR</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>SAR</cbc:TaxCurrencyCode>
<cac:AdditionalDocumentReference>
<cbc:ID>ICV</cbc:ID>
<cbc:UUID>1238</cbc:UUID>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
<cbc:ID>PIH</cbc:ID>
<cac:Attachment>
<cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">4CI7JqZxSamDnmoEeVUMicxQAaKZctdkITuzHQKpFVQ=</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="CRN">311466958200003</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Prince Sultan</cbc:StreetName>
<cbc:AdditionalStreetName>JEKC8232 Prince Sultan 8232, 3807 Al Khaliduiyah Dist, Prince Sultan, Jeddah, Al Khaliduiyah, 23423, Saudi Arabia</cbc:AdditionalStreetName>
<cbc:BuildingNumber>JEKC8232 Prince Sultan 8232</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Al Khaliduiyah</cbc:CitySubdivisionName>
<cbc:CityName>Jeddah</cbc:CityName>
<cbc:PostalZone>12345</cbc:PostalZone>
<cbc:CountrySubentity>Saudi Arabia</cbc:CountrySubentity>
<cac:Country>
<cbc:IdentificationCode>SA</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>311466958200003</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Textile Mix Trading Company</cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PostalAddress>
<cbc:AdditionalStreetName>Al khawaneej 1, street 119, villa 4, آخر., Dubai, United Arab Emirates, Al khawaneej 1, stre</cbc:AdditionalStreetName>
<cbc:BuildingNumber>Al khawaneej 1, street 119, villa 4, آخر.</cbc:BuildingNumber>
<cbc:CitySubdivisionName>Dubai</cbc:CitySubdivisionName>
<cbc:CityName>Dubai</cbc:CityName>
<cbc:PostalZone>Al khawaneej 1, stre</cbc:PostalZone>
<cbc:CountrySubentity>United Arab Emirates</cbc:CountrySubentity>
<cac:Country>
<cbc:IdentificationCode>SA</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Niveen Bahloul</cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:Delivery>
<cbc:ActualDeliveryDate>2024-10-17</cbc:ActualDeliveryDate>
<cbc:LatestDeliveryDate>2024-10-17</cbc:LatestDeliveryDate>
</cac:Delivery>
<cac:PaymentMeans>
<cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
</cac:PaymentMeans>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="SAR">0.0</cbc:TaxAmount>
</cac:TaxTotal>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="SAR">0.0</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="SAR">303.48</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="SAR">45.52</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
<cbc:TaxExemptionReasonCode>VATEX-SA-32</cbc:TaxExemptionReasonCode>
<cbc:Percent>15.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5153">VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="SAR">303.48</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="SAR">303.48</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="SAR">303.48</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="SAR">0.0</cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="SAR">0.0</cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="SAR">303.48</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="SAR">0.0</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="PCE">1</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="SAR">303.48</cbc:LineExtensionAmount>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="SAR">0.0</cbc:TaxAmount>
<cbc:RoundingAmount currencyID="SAR">303.48</cbc:RoundingAmount>
</cac:TaxTotal>
<cac:Item>
<cbc:Name>الوسادة المتكاملة - من مجموعة د. عادل الحصرية 65x40</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>0.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="SAR">303.48</cbc:PriceAmount>
<cac:AllowanceCharge>
<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
<cbc:AllowanceChargeReason>discount</cbc:AllowanceChargeReason>
<cbc:Amount currencyID="SAR">0.0</cbc:Amount>
</cac:AllowanceCharge>
</cac:Price>
</cac:InvoiceLine>
<cac:InvoiceLine>
<cbc:ID>2</cbc:ID>
<cbc:InvoicedQuantity unitCode="PCE">0.0</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="SAR">0.0</cbc:LineExtensionAmount>
<cac:DocumentReference>
<cbc:ID>Invo-0001238</cbc:ID>
<cbc:IssueDate>2024-10-11</cbc:IssueDate>
<cbc:IssueTime>21:16:00</cbc:IssueTime>
<cbc:DocumentTypeCode>386</cbc:DocumentTypeCode>
</cac:DocumentReference>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="SAR">0.0</cbc:TaxAmount>
<cbc:RoundingAmount currencyID="SAR">0.0</cbc:RoundingAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="SAR">303.48</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="SAR">0.0</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
<cbc:Percent>15.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5153">VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:Item>
<cbc:Name>Prepayment adjustment</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="SAR">0.0</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</Invoice>
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: 19; columnNumber: 4420; cvc-complex-type.2.4.a: Invalid content was found starting with element ‘{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Percent}’. One of ‘{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":TaxExemptionReason, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":TierRange, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":TierRatePercent, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":TaxScheme}’ is expected.”,
“status”: “ERROR”
},
If anyone having any idea, please need your support.
I am encountering a validation issue when adding the tax exemption reason code and reason to an XML invoice payload in compliance with UBL 2.1 and ZATCA specifications. Without the tax exemption fields, the XML payload works as expected, but adding them triggers the following 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: 19; columnNumber: 4607; cvc-complex-type.2.4.a: Invalid content was found starting with element '{\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\":Percent}'. One of '{\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\":TaxExemptionReason, \"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\":TierRange, \"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\":TierRatePercent, \"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\":TaxScheme}' is expected.",
"status": "ERROR"
}
Could anyone provide guidance on the correct placement or structure for these fields to maintain compliance? Any specific insights into handling tax exemption fields within ZATCA-compliant XML invoices would be greatly appreciated.
This does not seem to be working, In the payload that I shared earlier I missed the tax_exemption_reason which I did change but still getting the same errors as above.
Please if you could just make the changes related to tax exemption reason code without changing the other values (assuming they are correct).
Since the provided XML contains a lot of not complying values, and tags with UBL standers, please find the below path for samples inside the SDK after ensuring to download the latest version of it, and then you can make the changes in your XML to comply with UBL standards.
Samples Path in the SDK:
zatca-einvoicing-sdk-238-R3.3.6\zatca-einvoicing-sdk-238-R3.3.6\Data\Samples\Simplified\Invoice
For any further support, do not hesitate to reach out.
I can’t understand your XML. There are many errors in your Invoice XML. You may need to re-read the Invoice_XML_Implementation_Standard to make sure your Invoice XML complies with UBL 2.1 standards.
For Tax Category “S” you do not need TaxExemptionReasonCode and TaxExemptionReason.
You should also double-check, Spaces in ProfileID and IssueTime elements.
You also need to make sure the required elements in AccountingSipplierParty and AccountingCustomerParty.
A complete example of XML with Prepaid Amount can be found in the Zatca eInvoice SDK.
I changed some parts in the Invoice you shared, hopefully you can find where the problem is in your invoice.
