دليل متطلبات رمز الاستجابة السريعة (QR Code) وتشفير TLV من هيئة الزكاة والضريبة والجمارك

فهم متطلبات رمز الاستجابة السريعة (QR Code) في الفوترة الإلكترونية

في بيئة الأعمال السعودية، يعد رمز الاستجابة السريعة (QR Code) الموجود على الفاتورة الإلكترونية أكثر من مجرد وسيلة وصول سريعة؛ فهو هيكل بيانات مشفر ومعقد تفرضه هيئة الزكاة والضريبة والجمارك (ZATCA). سواء كنت في المرحلة الأولى (مرحلة الإصدار) أو المرحلة الثانية (مرحلة الربط والتكامل)، فإن ضمان التزام الرمز بمعيار التشفير TLV (وسم-طول-قيمة) هو أمر حيوي لتجنب الغرامات ورفض الفواتير.

تعتبر أخطاء رمز الاستجابة السريعة من بين الأسباب الأكثر شيوعاً لرفض الفواتير في منصة فاتورة. يوضح هذا الدليل المتطلبات التقنية وكيفية تنفيذها بشكل صحيح.

ما هو تشفير TLV؟

تتطلب الهيئة صياغة بيانات رمز الاستجابة السريعة باستخدام طريقة TLV (Tag-Length-Value) قبل تحويلها إلى صيغة Base64. تضمن هذه الطريقة أن تكون البيانات مضغوطة، ومنظمة، وسهلة القراءة من قبل أنظمة الهيئة.

مكونات الـ TLV:

1. الوسم (Tag): معرف فريد لكل حقل بيانات (مثلاً: الوسم رقم 1 لاسم المورد).
2. الطول (Length): عدد البايتات في حقل القيمة.
3. القيمة (Value): البيانات الفعلية (مثلاً: “شركة قيمة للبرمجيات”).

الحقول المطلوبة للمرحلة الأولى (الفواتير المبسطة والضريبية)

يجب أن يحتوي الرمز في المرحلة الأولى على الحقول الخمسة التالية:

الوسم	اسم الحقل	الوصف
1	اسم المورد	الاسم القانوني للمنشأة كما هو مسجل في الهيئة.
2	الرقم الضريبي	الرقم الضريبي المكون من 15 رقماً للمورد.
3	الطابع الزمني	تاريخ ووقت إصدار الفاتورة (بتنسيق ISO 8601).
4	إجمالي الفاتورة	المبلغ الإجمالي للفاتورة شاملاً ضريبة القيمة المضافة.
5	إجمالي الضريبة	مبلغ ضريبة القيمة المضافة المحتسب في الفاتورة.

المرحلة الثانية: تطور متطلبات الـ QR Code

في المرحلة الثانية (مرحلة الربط والتكامل)، يصبح رمز الاستجابة السريعة أكثر تعقيداً. لم يعد مجرد ملخص للفاتورة، بل أصبح أداة للتحقق من سلامة المستند الرقمي وعدم التلاعب به.

بالإضافة إلى الحقول الخمسة الأساسية، يجب أن تحتوي رموز QR للفواتير الضريبية المبسطة (B2C) على:

• الوسم 6 (Invoice Hash): بصمة رقمية (SHA-256) لملف XML الخاص بالفاتورة.
• الوسم 7 (Digital Signature): توقيع رقمي (ECDSA) يتم إنشاؤه باستخدام المفتاح الخاص المرتبط بـ الختم الرقمي.
• الوسم 8 (Public Key): المفتاح العام المستخدم للتحقق من التوقيع.
• الوسم 9 (Certificate Signature): توقيع الشهادة الرقمية للفواتير المبسطة.

💡 ملاحظة: بالنسبة لـ الفواتير الضريبية القياسية (B2B)، يتم إنشاء رمز QR بواسطة بوابة “فاتورة” بعد اعتماد الفاتورة، بينما في الفواتير المبسطة، يجب على برنامج المحاسبة إنشاؤه محلياً.

خطوات تشفير الرمز تقنياً

لإنشاء رمز QR صحيح، يجب على نظامك اتباع الخطوات التالية:

1. جمع البيانات: تحضير كافة الحقول المطلوبة.
2. التحويل إلى Hexadecimal TLV: تحويل كل حقل إلى تمثيل سداسي عشري (Hex).
   • مثال: الوسم 1 بقيمة “ABC” يصبح 01 (الوسم) 03 (الطول) 414243 (القيمة بالـ Hex).
3. الدمج: دمج كافة السلاسل السداسية العشرية في سلسلة واحدة.
4. تشفير Base64: تحويل السلسلة النهائية إلى صيغة Base64.
5. إنشاء الصورة: استخدام سلسلة Base64 لإنشاء صورة الـ QR على نسخة الـ PDF.

⚠️ تحذير: وضع رابط موقع إلكتروني أو نص عادي داخل الرمز سيؤدي إلى عدم مطابقة الفاتورة. يمكنك استخدام أداة فك تشفير QR الخاصة بنا للتحقق من فواتيرك الحالية.

أخطاء شائعة وكيفية إصلاحها

عند الربط مع بوابة فاتورة، قد تظهر لك بعض الأخطاء التقنية:

• BR-KSA-26: حقل رمز الاستجابة السريعة لا يطابق معايير تشفير TLV.
• BR-KSA-27: فقدان أحد الحقول الإلزامية في الرمز (مثل الرقم الضريبي).
• عدم تطابق الوقت: يجب أن يتطابق الطابع الزمني في الرمز مع وقت الإصدار المذكور في ملف XML تماماً.

للتأكد من جاهزية نظامك، استخدم أداة فحص الجاهزية لتقييم وضعك الحالي.

لماذا يعد التنفيذ اليدوي خطيراً؟

محاولة بناء مشفر TLV وإدارة الختم الرقمي يدوياً عملية معقدة للغاية وعرضة للأخطاء. تتطلب المرحلة الثانية الحفاظ على تسلسل دقيق للفواتير عبر بصمة الفاتورة السابقة (PIH) و عداد الفواتير (ICV) لضمان عدم كسر التسلسل.

استخدام حل معتمد مثل “قيمة” يضمن لك:

• إنشاء تلقائي لرموز QR وفقاً لأحدث معايير الهيئة.
• معالجة فورية لتشفير TLV وتحويل Base64.
• تطبيق التوقيعات الرقمية للمرحلة الثانية دون أي تدخل يدوي.

كيف يساعدك نظام “قيمة” في الامتثال لهيئة الزكاة؟

تم تطوير نظام “قيمة” خصيصاً للسوق السعودي، مما يضمن أن كل فاتورة تصدرها—سواء كانت للأفراد أو الشركات—متوافقة بنسبة 100% مع المتطلبات التقنية للهيئة.

✅ إنشاء QR تلقائي: يقوم نظام المبيعات بإنشاء رموز مطابقة لكل فاتورة. ✅ جاهزية المرحلة الثانية: نتولى عملية الربط الكامل مع بوابة فاتورة، بما في ذلك إنشاء ملفات XML والتوقيع الرقمي. ✅ تحقق فوري: يقوم النظام بفحص الأخطاء قبل إرسال الفاتورة لتجنب الرفض. ✅ محاسبة متكاملة: بالإضافة للفوترة، يمكنك إدارة دليل الحسابات و المخازن في منصة سحابية واحدة.

هل أنت مستعد لتبسيط الفوترة الإلكترونية؟ اطلع على الأسعار أو تواصل مع خبرائنا اليوم للحصول على تجربة مجانية.