[ERROR] Invalid QR code format, Please follow the ZATCA QR code specifications

QR code
1

I get this error in Compliance invoice API:

[ERROR] Invalid QR code format, Please follow the ZATCA QR code specifications

Before signing the invoice is this:

<?xml version="1.0"?>
<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:elementToRemoved></cbc:elementToRemoved>
    <cbc:ProfileID>reporting:1.0</cbc:ProfileID>
    <cbc:ID>1-257</cbc:ID>
    <cbc:UUID>50cc36a7-732b-492a-a482-8d39216932f6</cbc:UUID>
    <cbc:IssueDate>2025-03-24</cbc:IssueDate>
    <cbc:IssueTime>21:38:50</cbc:IssueTime>
    <cbc:InvoiceTypeCode name="0200000">388</cbc:InvoiceTypeCode>
    <cbc:DocumentCurrencyCode>SAR</cbc:DocumentCurrencyCode>
    <cbc:TaxCurrencyCode>SAR</cbc:TaxCurrencyCode>
    <cac:AdditionalDocumentReference>
        <cbc:ID>ICV</cbc:ID>
        <cbc:UUID>1</cbc:UUID>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <cbc:ID>PIH</cbc:ID>
        <cac:Attachment>
            <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">X+zrZv/IbzjZUnhsbWlsecLbwjndTpG0ZynXOif7V+k=</cbc:EmbeddedDocumentBinaryObject>
        </cac:Attachment>
    </cac:AdditionalDocumentReference>
    <cbc:elementToRemoved></cbc:elementToRemoved>
    <cbc:elementToRemoved></cbc:elementToRemoved>
    <cac:AccountingSupplierParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="CRN">1010216483</cbc:ID>
            </cac:PartyIdentification>
            <cac:PostalAddress>
                <cbc:StreetName>صلبوخ حي الوادي</cbc:StreetName>
                <cbc:BuildingNumber>1520</cbc:BuildingNumber>
                <cbc:PlotIdentification>6980</cbc:PlotIdentification>
                <cbc:CitySubdivisionName>Riyadh</cbc:CitySubdivisionName>
                <cbc:CityName>Riyadh</cbc:CityName>
                <cbc:PostalZone>11461</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>SA</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:PartyTaxScheme>
                <cbc:CompanyID>300207668900003</cbc:CompanyID>
                <cac:TaxScheme>
                    <cbc:ID>VAT</cbc:ID>
                </cac:TaxScheme>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:RegistrationName>مؤسسة فهد عبدالله الهويشان للتجارة</cbc:RegistrationName>
            </cac:PartyLegalEntity>
        </cac:Party>
    </cac:AccountingSupplierParty>
    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="NAT"></cbc:ID>
            </cac:PartyIdentification>
            <cac:PostalAddress>
                <cbc:StreetName></cbc:StreetName>
                <cbc:BuildingNumber></cbc:BuildingNumber>
                <cbc:PlotIdentification></cbc:PlotIdentification>
                <cbc:CitySubdivisionName></cbc:CitySubdivisionName>
                <cbc:CityName></cbc:CityName>
                <cbc:PostalZone></cbc:PostalZone>
                <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>الشركة السعودية للتحكم التقني والأمني الشامل المحدوده - TAHAKOM</cbc:RegistrationName>
            </cac:PartyLegalEntity>
        </cac:Party>
    </cac:AccountingCustomerParty>
    <cac:Delivery>
        <cbc:ActualDeliveryDate>2025-03-24</cbc:ActualDeliveryDate>
    </cac:Delivery>
    <cac:PaymentMeans>
        <cbc:PaymentMeansCode>10</cbc:PaymentMeansCode>
    </cac:PaymentMeans>
    <cac:AllowanceCharge>
        <cbc:ID>1</cbc:ID>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:AllowanceChargeReason>discount</cbc:AllowanceChargeReason>
        <cbc:Amount currencyID="SAR">0.00</cbc:Amount>
        <cac:TaxCategory>
            <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
            <cbc:Percent>15</cbc:Percent>
            <cac:TaxScheme>
                <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5153">VAT</cbc:ID>
            </cac:TaxScheme>
        </cac:TaxCategory>
    </cac:AllowanceCharge>
    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="SAR">14.40</cbc:TaxAmount>
    </cac:TaxTotal>
    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="SAR">14.40</cbc:TaxAmount>
        <cac:TaxSubtotal>
            <cbc:TaxableAmount currencyID="SAR">96.00</cbc:TaxableAmount>
            <cbc:TaxAmount currencyID="SAR">14.40</cbc:TaxAmount>
            <cac:TaxCategory>
                <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
                <cbc:Percent>15.00</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">96.00</cbc:LineExtensionAmount>
        <cbc:TaxExclusiveAmount currencyID="SAR">96.00</cbc:TaxExclusiveAmount>
        <cbc:TaxInclusiveAmount currencyID="SAR">110.40</cbc:TaxInclusiveAmount>
        <cbc:AllowanceTotalAmount currencyID="SAR">0.00</cbc:AllowanceTotalAmount>
        <cbc:PrepaidAmount currencyID="SAR">0.00</cbc:PrepaidAmount>
        <cbc:PayableAmount currencyID="SAR">110.40</cbc:PayableAmount>
    </cac:LegalMonetaryTotal>
    <cac:InvoiceLine>
        <cbc:ID>70282</cbc:ID>
        <cbc:InvoicedQuantity unitCode="PCE">3.00</cbc:InvoicedQuantity>
        <cbc:LineExtensionAmount currencyID="SAR">24.00</cbc:LineExtensionAmount>
        <cac:TaxTotal>
            <cbc:TaxAmount currencyID="SAR">3.60</cbc:TaxAmount>
            <cbc:RoundingAmount currencyID="SAR">27.60</cbc:RoundingAmount>
        </cac:TaxTotal>
        <cac:Item>
            <cbc:Name>BALL POINT PENS; STD 1MM BLACK قلم اسود</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">8.00</cbc:PriceAmount>
            <cac:AllowanceCharge>
                <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
                <cbc:AllowanceChargeReason> </cbc:AllowanceChargeReason>
                <cbc:Amount currencyID="SAR">0.00</cbc:Amount>
            </cac:AllowanceCharge>
        </cac:Price>
    </cac:InvoiceLine>
    <cac:InvoiceLine>
        <cbc:ID>70283</cbc:ID>
        <cbc:InvoicedQuantity unitCode="PCE">3.00</cbc:InvoicedQuantity>
        <cbc:LineExtensionAmount currencyID="SAR">24.00</cbc:LineExtensionAmount>
        <cac:TaxTotal>
            <cbc:TaxAmount currencyID="SAR">3.60</cbc:TaxAmount>
            <cbc:RoundingAmount currencyID="SAR">27.60</cbc:RoundingAmount>
        </cac:TaxTotal>
        <cac:Item>
            <cbc:Name>BALL POINT PENS; STD 1MM BLUE قلم ازرق</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">8.00</cbc:PriceAmount>
            <cac:AllowanceCharge>
                <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
                <cbc:AllowanceChargeReason> </cbc:AllowanceChargeReason>
                <cbc:Amount currencyID="SAR">0.00</cbc:Amount>
            </cac:AllowanceCharge>
        </cac:Price>
    </cac:InvoiceLine>
    <cac:InvoiceLine>
        <cbc:ID>70284</cbc:ID>
        <cbc:InvoicedQuantity unitCode="PCE">1.00</cbc:InvoicedQuantity>
        <cbc:LineExtensionAmount currencyID="SAR">48.00</cbc:LineExtensionAmount>
        <cac:TaxTotal>
            <cbc:TaxAmount currencyID="SAR">7.20</cbc:TaxAmount>
            <cbc:RoundingAmount currencyID="SAR">55.20</cbc:RoundingAmount>
        </cac:TaxTotal>
        <cac:Item>
            <cbc:Name>BALL POINT PENS; STD 0.5 MM BLUE قلم ازرق 0.5 ملم</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">48.00</cbc:PriceAmount>
            <cac:AllowanceCharge>
                <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
                <cbc:AllowanceChargeReason> </cbc:AllowanceChargeReason>
                <cbc:Amount currencyID="SAR">0.00</cbc:Amount>
            </cac:AllowanceCharge>
        </cac:Price>
    </cac:InvoiceLine>
</Invoice>

base64 qrcode:

AUDZhdik2LPYs9ipINmB2YfYryDYudio2K/Yp9mE2YTZhyDYp9mE2YfZiNmK2LTYp9mGINmE2YTYqtis2KfYsdipAg8zMDAyMDc2Njg5MDAwMDMDFDIwMjUtMDMtMjRUMjI6MTQ6MTRaBAYxMTAuNDAFBTE0LjQwBixsVW5BdGE3WEJZZTN3NUpsR2xEd2NWdmxOdXJDcURHNkV6Z1FlcXBKaXA4PQdgTUVZQ0lRQ3N0VFBnaHAwdm5XRVY4eU5xN3VJRkZndHMrK0ZJZE92eG9wOFFJWXBWY1FJaEFLaldtbVpaRXEySTRFNURNSE5lS2krV3pzdUM1dDh5anpzRUxjVlZ3am9iCHhNRll3RUFZSEtvWkl6ajBDQVFZRks0RUVBQW9EUWdBRUNXZTFTLzV4RUFoSUZITUFreHBFL0NRTTBpZFVtMXhaYks1Q0Jmc2pwSXJnTDVJZ3dnSW1WemU5ckYxb2sreU5CRkhGT3J2SG9HZThZbzRoRGt1M2NnPT0JkjAwMzA0NjAyMjEwMDg3M2ZhMGY0ZTRjMTY4OTEyNjFiYWM2MzE2NzRlNWJjOGZmNWU2NDg4YTZlMGU5M2Y4MWYwOWM3YWMzYWJjNDAwMjIxMDBiMTZmMmYxZjM4NzY4NDIzNjY0MTM4ZGQxMjYwZDU2NmEwNTJiYTE2MDQyOGJiMjM3NjRlNDJlNjAxZThlMWU3

WhatsApp Image 2025-03-25 at 12.15.12 AM
WhatsApp Image 2025-03-25 at 12.15.12 AM698×1600 68.2 KB

2

dear @ahmedShaker,

You can’t depend on the third party QR code apps, you should rely only on the ZATCA official app.

However, the after investigating the provided QR code, it seems that the issue is related to the 9th tag, to get the 9th tag of the QR code correctly, please ensure following the below steps:

1- decode the CCSID or the PCSID based on the API that you would like to send the invoice through (CCSID for the compliance checks while PCSID for reporting API). using base64, only "the binary security token value

2- take the output from the previous step, and decode it using a x.509 certificate decoder.

3- go to the value of “Signature Value”, the value should be in HEX (bytes represntation).

4- remove any special character like “:” if exist.

5- place the value in the 9th tag.

Regards,