مولد رمز QR للفاتورة الإلكترونية

الدليل الكامل للامتثال لرمز الاستجابة السريعة (QR) لهيئة الزكاة

لبناء مولد رمز QR متوافق مع هيئة الزكاة والضريبة والجمارك (ZATCA)، يجب أن تلتزم أداتك بمواصفات تقنية صارمة فيما يتعلق بهيكل البيانات (TLV)، والتشفير (Base64)، والحقول الإلزامية الخاصة بكل مرحلة. رمز QR هو باركود مصفوفي قابل للقراءة آلياً يسمح لأصحاب المصلحة والعملاء بالتحقق من صحة وسلامة الفواتير والإشعارات الإلكترونية.

1. حقول البيانات الإلزامية (المحتوى)

تعتمد المعلومات الموجودة في رمز QR على ما إذا كانت المنشأة تعمل ضمن المرحلة الأولى (الإصدار) أو المرحلة الثانية (الربط والتكامل).

المرحلة الأولى: مرحلة الإصدار (إلزامية منذ 4 ديسمبر 2021)

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

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

المرحلة الثانية: مرحلة الربط والتكامل (بدأ التطبيق على مراحل منذ 1 يناير 2023)

في المرحلة الثانية، تم تعزيز متطلبات رمز QR لتشمل ميزات أمان تشفيرية. بالنسبة لجميع أنواع الفواتير الإلكترونية، الحقول الإضافية التالية (العلامات 6-9) إلزامية:

• العلامة 6: تجزئة XML (Hash): تجزئة ملف XML للفاتورة.
• العلامة 7: توقيع ECDSA: التوقيع الرقمي لتجزئة XML.
• العلامة 8: مفتاح ECDSA العام: المفتاح العام المستخدم لإنشاء التوقيع.
• العلامة 9: توقيع ZATCA: للفواتير المبسطة، توقيع ECDSA للختم التشفيري الصادر عن المرجع المصدق التقني للهيئة.

ملاحظة: بالنسبة للفواتير الضريبية القياسية (B2B) في المرحلة الثانية، ستقوم بوابة "فاتورة" التابعة للهيئة بإنشاء سلسلة رمز QR أثناء عملية الاعتماد (Clearance) وإعادتها للمكلف لعرضها على الفاتورة المقروءة بشرياً.

2. البنية التقنية للتشفير

يجب أن تتبع أداتك تسلسلاً محدداً للعمليات لضمان إمكانية قراءة رمز QR بواسطة أنظمة التحقق الخاصة بالهيئة:

1. تنسيق TLV (العلامة-الطول-القيمة):
   • العلامة (Tag): بايت واحد يمثل رقم العلامة (مثلاً 1 لاسم البائع).
   • الطول (Length): بايت واحد يمثل طول القيمة بالبايت.
   • القيمة (Value): بايتات البيانات الفعلية مشفرة بـ UTF-8.
2. التسلسل (Concatenation): بناء مجموعة TLV لكل حقل مطلوب ودمجها في مصفوفة بايت واحدة متصلة.
3. تشفير Base64: يجب تشفير مصفوفة البايت المدمجة النهائية إلى سلسلة نصية Base64 ASCII.
4. إنشاء الصورة: تحويل سلسلة Base64 الناتجة إلى صورة QR.

3. قيود التنفيذ والامتثال

• مكافحة التلاعب: يجب أن يمنع النظام التعديل اليدوي للطابع الزمني أو عداد الفواتير.
• الظهور ثنائي اللغة: يجب أن تكون الفاتورة المطبوعة باللغة العربية (الإنجليزية اختيارية).
• التحقق: تحقق من رموز QR المولدة باستخدام تطبيق ضريبة القيمة المضافة (ZATCA VAT App) الرسمي.
• مفاتيح التشفير: يجب تخزين المفاتيح الخاصة لتواقيع ECDSA بشكل آمن وغير قابل للتصدير.