تخطَّ إلى المحتوى
KSA-14

رمز الاستجابة السريعة (QR Code)

نص base64 لسلسلة أوسمة TLV تحمل بيانات الفاتورة وختمها، ويُطبع رمزاً مربعاً يتحقق منه المشتري.

الرمز إلزامي في كل مستند (القاعدة BR-KSA-27) ويجب أن يكون ظاهراً في النسخة المطبوعة. في المرحلة الثانية يحمل تسعة أوسمة: اسم البائع ورقمه الضريبي والطابع الزمني والإجمالي مع الضريبة وإجمالي الضريبة، ثم hash المستند وتوقيعه والمفتاح العام، والوسم التاسع للمبسطة فقط وهو توقيع الهيئة على شهادة الجهاز.

كل وسم يُكتب بايتاً للرقم وبايتاً للطول ثم القيمة بترميز UTF-8، ثم تُرمّز السلسلة كلها بـ base64، ولا يتجاوز الناتج 700 حرف بحسب معيار الأمان. خطأ شائع أن يُكتب الطول نصاً بدل بايت، أو أن يُرمَّز الاسم العربي بغير UTF-8.

كتلة الرمز مستثناة من الـ hash ومن التوقيع، لأنها تحمل الـ hash نفسه. في الفاتورة الضريبية تضيف الهيئة رمزها أو تحدّثه عند الاعتماد، أما المبسطة فيضع الجهاز رمزها كاملاً.

المعرّفKSA-14
المسار في المستند/Invoice/cac:AdditionalDocumentReference[cbc:ID='QR']/cac:Attachment/cbc:EmbeddedDocumentBinaryObject
التكرار0..1
نوع البياناتBinary (base64)
ينطبق علىالفاتورة الضريبية (القياسية) والفاتورة الضريبية المبسطة

في جوداكس

مبني

يبني البرنامج الأوسمة التسعة ويرفض أي وسم يتجاوز 255 بايتاً، لكنه لا يتحقق من حد الـ 700 حرف الكلي. الوسمان 6 و7 يُكتبان نص base64، كما في المثال المحلول في الإرشادات الفنية، بينما يصف معيار الأمان الوسم 6 بأنه 32 بايتاً. الوسم 3 بالتوقيت المحلي بلا Z.

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

ينطبق على

فاتورة ضريبيةإشعار مدينإشعار دائنمبسطةمدين مبسطدائن مبسط
إلزاميإلزاميإلزاميإلزاميإلزاميإلزامي

القواعد التي تفحصه

  • BR-KSA-27 · يجب أن يحمل المستند رمز استجابة سريعة بترميز base64.

حقول ذات صلة

الحقول — الفوترة الإلكترونية في السعودية (فاتورة)

المصادر

  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

تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.