الدليل الكامل لفك تشفير رموز QR الخاصة بهيئة الزكاة
تفرض هيئة الزكاة والضريبة والجمارك (ZATCA) أن تتضمن جميع الفواتير الإلكترونية في المملكة العربية السعودية رمز QR قابل للقراءة آلياً. يحتوي رمز QR هذا على معلومات الفاتورة الأساسية مشفرة باستخدام تنسيق TLV (العلامة-الطول-القيمة) ومحولة إلى Base64. فهم كيفية فك تشفير هذه الرموز أمر بالغ الأهمية للتحقق من الفواتير، الامتثال للتدقيق، وتكامل الأنظمة.
فهم هيكل تشفير TLV
يستخدم رمز QR الخاص بهيئة الزكاة مخطط تشفير ثنائي حيث يتم هيكلة كل جزء من البيانات كالتالي:
- العلامة (بايت واحد): رقم صحيح من 1-9 يحدد نوع البيانات
- الطول (بايت واحد): عدد البايتات في القيمة (الحد الأقصى 255)
- القيمة (متغيرة): البيانات الفعلية، مشفرة بـ UTF-8 للعلامات 1-7، أو ثنائية خام للعلامات 8-9
بعد دمج جميع مجموعات TLV، يتم تشفير مصفوفة البايت الناتجة إلى Base64، والتي يتم عرضها بعد ذلك كصورة رمز QR.
شرح علامات رمز QR لهيئة الزكاة
علامات المرحلة الأولى (إلزامية منذ ديسمبر 2021)
| العلامة | الحقل | التنسيق | مثال |
|---|---|---|---|
| 1 | اسم البائع | نص UTF-8 | شركة المثال ذ.م.م |
| 2 | الرقم الضريبي | 15 رقم (3...3) | 310122393500003 |
| 3 | الطابع الزمني | ISO 8601 | 2024-01-15T14:30:00 |
| 4 | إجمالي الفاتورة | عشري | 1150.00 |
| 5 | مبلغ الضريبة | عشري | 150.00 |
علامات المرحلة الثانية (بيانات تشفيرية إضافية)
| العلامة | الحقل | التنسيق | الغرض |
|---|---|---|---|
| 6 | تجزئة XML | Base64 (44 حرف) | تجزئة SHA-256 لملف XML الفاتورة |
| 7 | توقيع ECDSA | Base64 (~96 حرف) | التوقيع الرقمي للتجزئة |
| 8 | المفتاح العام | ثنائي DER (Base64) | مفتاح التحقق من التوقيع |
| 9 | توقيع الهيئة | ثنائي (Base64) | توقيع المرجع المصدق (للفواتير المبسطة) |
عملية فك التشفير خطوة بخطوة
- استخراج Base64: امسح رمز QR للحصول على سلسلة Base64
- فك التشفير إلى بايتات: حول Base64 إلى مصفوفة بايت باستخدام الفك القياسي
- تحليل مجموعات TLV: اقرأ العلامة، الطول، القيمة بالتتابع من مصفوفة البايت
- تفسير القيم: حول البايتات إلى نصوص/أرقام بناءً على نوع العلامة
- التحقق من الحقول: تحقق من الامتثال للتنسيق (تنسيق الرقم الضريبي، الطابع الزمني، إلخ)
أخطاء فك التشفير الشائعة وحلولها
دليل استكشاف الأخطاء
- Base64 غير صالح: تأكد من التقاط محتوى QR الكامل. المسح الجزئي سيفشل.
- خطأ في تحليل TLV: قد يستخدم QR تنسيقاً غير متوافق مع الهيئة. تحقق من أنه من نظام متوافق.
- علامات المرحلة الثانية مفقودة: فواتير المرحلة الأولى تحتوي فقط على العلامات 1-5. العلامات 6-9 تتطلب التكامل مع الهيئة.
- توقيع تالف: البيانات الثنائية (العلامات 8-9) يجب التعامل معها كبايتات خام، وليس UTF-8.
التكامل مع الفوترة الإلكترونية للهيئة
للشركات العاملة في المملكة العربية السعودية، فهم فك تشفير QR ضروري لـ:
- التحقق من الفواتير: التحقق من الفواتير المستلمة قبل معالجة الدفع
- الامتثال للتدقيق: التأكد من تطابق رموز QR مع تفاصيل الفاتورة أثناء التدقيق الضريبي
- تكامل الأنظمة: تحليل بيانات QR لسير عمل المحاسبة الآلي
- ثقة العملاء: السماح للعملاء بالتحقق من صحة الفاتورة
نصيحة احترافية: التحقق بالأدوات الرسمية
تحقق دائماً من بيانات QR المفككة مع تطبيق ضريبة القيمة المضافة الرسمي للفواتير الإنتاجية. هذا المفكك مثالي للتطوير، الاختبار، وفهم هيكل QR، لكن التحقق الرسمي يجب أن يستخدم قنوات الهيئة المعتمدة.
أدوات ذات صلة للامتثال لهيئة الزكاة
أكمل مجموعة أدوات الفوترة الإلكترونية الخاصة بك بهذه الأدوات التكميلية:
- مولد رمز QR للهيئة - أنشئ رموز QR متوافقة لفواتيرك
- عارض XML للهيئة - عرض وفهم هيكل XML الفاتورة
- فاحص جاهزية الهيئة - قيّم حالة امتثالك للمرحلة الثانية