Error in invoice type code in Standard credit note

XML and business rules
1

While trying to clear a standard credit note of one of our customers, the customer is getting this error.

The invoice transaction code (KSA-2) must exist and respect the following structure: NNPNESB where NN (positions 1 and 2) = invoice
subtype: 01 for tax invoice 02 for simplified tax invoice P
(position 3) = 3rd Party invoice transaction, 0 for false, 1 for true N
(position 4) = Nominal invoice transaction, 0 for false, 1 for true E
(position 5) = Exports invoice transaction, 0 for false, 1 for true S
(position 6) = Summary invoice transaction, 0 for false, 1 for true B
(position 7) = Self billed invoice.

The actual cause of the error is unknown. Please help with this.
The related xml is given below.

<?xml version="1.0" encoding="UTF-8"?>


<cbc:UBLVersionID xmlns=“”>2.1</cbc:UBLVersionID>
<cbc:ProfileID xmlns=“”>reporting:1.0</cbc:ProfileID>
<cbc:ID xmlns=“”>SR/1/202410/000016</cbc:ID>
<cbc:UUID xmlns=“”>2d72c9ff-bca3-4225-a29d-c03f13cb2828</cbc:UUID>
<cbc:IssueDate xmlns=“”>2024-10-29</cbc:IssueDate>
<cbc:IssueTime xmlns=“”>01:20:31</cbc:IssueTime>
<cbc:InvoiceTypeCode xmlns=“” name=“0100000 “>381</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode xmlns=””>SAR</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode xmlns=“”>SAR</cbc:TaxCurrencyCode>
<cac:BillingReference xmlns=“”>
cac:InvoiceDocumentReference
cbc:IDSRD/202410/000012</cbc:ID>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AdditionalDocumentReference xmlns=“”>
cbc:IDICV</cbc:ID>
cbc:UUID44</cbc:UUID>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference xmlns=“”>
cbc:IDPIH</cbc:ID>
cac:Attachment
<cbc:EmbeddedDocumentBinaryObject mimeCode=“text/plain”>BTOI42b0iHlCFancWCKroHZOWVg3M2hIttEBoM+79+E=</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AccountingSupplierParty xmlns=“”>
cac:Party
cac:PartyIdentification
<cbc:ID schemeID=“CRN”>null</cbc:ID>
</cac:PartyIdentification>
cac:PostalAddress
cbc:StreetNameZaid Ibn Al Khattab </cbc:StreetName>
cbc:BuildingNumber7580</cbc:BuildingNumber>
cbc:CitySubdivisionNameAl Olya</cbc:CitySubdivisionName>
cbc:CityNameAl Khobar </cbc:CityName>
cbc:PostalZone34447</cbc:PostalZone>
cac:Country
cbc:IdentificationCodeSA</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
cac:PartyTaxScheme
cbc:CompanyID310903726100003</cbc:CompanyID>
cac:TaxScheme
cbc:IDVAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
cac:PartyLegalEntity
cbc:RegistrationNameMass Vision Trading </cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty xmlns=“”>
cac:Party
cac:PartyTaxScheme
cbc:CompanyID300000432310003</cbc:CompanyID>
cac:TaxScheme
cbc:IDVAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
cac:PartyLegalEntity
cbc:RegistrationNameSaudi Arabian Oil Company</cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:PaymentMeans xmlns=“”>
cbc:PaymentMeansCode1</cbc:PaymentMeansCode>
cbc:InstructionNotereturn</cbc:InstructionNote>
</cac:PaymentMeans>
<cac:TaxTotal xmlns=“”>
<cbc:TaxAmount currencyID=“SAR”>28.37</cbc:TaxAmount>
</cac:TaxTotal>
<cac:TaxTotal xmlns=“”>
<cbc:TaxAmount currencyID=“SAR”>28.37</cbc:TaxAmount>
cac:TaxSubtotal
<cbc:TaxableAmount currencyID=“SAR”>189.12</cbc:TaxableAmount>
<cbc:TaxAmount currencyID=“SAR”>28.37</cbc:TaxAmount>
cac:TaxCategory
<cbc:ID schemeAgencyID=“6” schemeID=“UN/ECE 5305”>S</cbc:ID>
cbc:Percent15.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 xmlns=“”>
<cbc:LineExtensionAmount currencyID=“SAR”>189.12</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID=“SAR”>189.12</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID=“SAR”>217.49</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID=“SAR”>0.0</cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID=“SAR”>0.0</cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID=“SAR”>0.0</cbc:PrepaidAmount>
<cbc:PayableRoundingAmount currencyID=“SAR”>0.0</cbc:PayableRoundingAmount>
<cbc:PayableAmount currencyID=“SAR”>217.49</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine xmlns=“”>
cbc:ID1</cbc:ID>
<cbc:InvoicedQuantity unitCode=“PCE”>1.0</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID=“SAR”>189.12</cbc:LineExtensionAmount>
cac:TaxTotal
<cbc:TaxAmount currencyID=“SAR”>28.37</cbc:TaxAmount>
<cbc:RoundingAmount currencyID=“SAR”>217.49</cbc:RoundingAmount>
</cac:TaxTotal>
cac:Item
cbc:NameTable </cbc:Name>
cac:ClassifiedTaxCategory
cbc:IDS</cbc:ID>
cbc:Percent15.0</cbc:Percent>
cac:TaxScheme
cbc:IDVAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
cac:Price
<cbc:PriceAmount currencyID=“SAR”>189.12</cbc:PriceAmount>
cac:AllowanceCharge
cbc:ChargeIndicatortrue</cbc:ChargeIndicator>
cbc:AllowanceChargeReasondiscount</cbc:AllowanceChargeReason>
<cbc:Amount currencyID=“SAR”>0.0</cbc:Amount>
</cac:AllowanceCharge>
</cac:Price>
</cac:InvoiceLine>

2

Dear @itujar_it

Thanks for reaching out,

Can I kindly ask you to share the XML in the same form that you are sending it and giving you the above error?

If you can send it via mail, will be more helpful to ensure comprehensive support as usual, you can find SP support email below.

SP mail: sp_support@zatca.gov.sa

Thanks,
Ibrahem Daoud.

1 Like
3

thanx for your response. xml Shared by mail.