Aller au contenu
KSA-14

Code QR

Chaîne base64 de balises TLV portant les données essentielles de la facture et son cachet, imprimée sous forme d'image QR que l'acheteur peut vérifier.

Le code est obligatoire sur chaque document (BR-KSA-27) et doit être visible sur l'exemplaire imprimé. En phase 2, il contient neuf balises : nom du vendeur, numéro de TVA, horodatage, total TVA comprise et total de TVA, puis l'empreinte du document, sa signature et la clé publique ; la balise 9, réservée aux documents simplifiés, est la signature de la ZATCA sur le certificat de l'appareil.

Chaque balise se compose d'un octet pour le numéro, d'un octet pour la longueur, puis de la valeur en UTF-8 ; l'ensemble est encodé en base64, et la norme de sécurité plafonne le résultat à 700 caractères. Erreurs courantes : écrire la longueur sous forme de texte au lieu d'un octet, ou encoder un nom arabe autrement qu'en UTF-8.

Le bloc QR est exclu de l'empreinte et de la signature, puisqu'il contient lui-même l'empreinte. Sur une facture standard, la ZATCA ajoute ou met à jour le QR lors de la validation préalable ; sur une facture simplifiée, c'est l'appareil qui écrit le code complet.

IdentifiantKSA-14
Chemin dans le document/Invoice/cac:AdditionalDocumentReference[cbc:ID='QR']/cac:Attachment/cbc:EmbeddedDocumentBinaryObject
Cardinalité0..1
Type de donnéeBinary (base64)
S’applique àFacture fiscale (standard) et Facture fiscale simplifiée

Dans JooDax

Disponible

Les programmes construisent les neuf balises et refusent toute balise de plus de 255 octets, mais ne vérifient pas le total de 700 caractères. Les balises 6 et 7 sont écrites en texte base64, comme dans l'exemple détaillé des lignes directrices techniques, alors que la norme de sécurité décrit la balise 6 comme 32 octets. La balise 3 est en heure locale, sans Z.

crates/jdx-einvoice-sa/src/xml.rs

S’applique à

Facture fiscaleNote de débitAvoirSimplifiéeDébit simplifiéAvoir simplifié
ObligatoireObligatoireObligatoireObligatoireObligatoireObligatoire

Règles qui le contrôlent

  • BR-KSA-27 · Le document doit contenir un code QR encodé en base64Binary.

Champs liés

Champs — La facturation électronique en Arabie saoudite (FATOORA)

Sources

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  4. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA

Vérifié le: 4 novembre 2026. Ce qui concerne JooDax est tiré du code même des programmes.