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

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

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

هذه الأداة تولّد ذلك الرمز وفق الترميز المطلوب، لتساعدك على فهم آلية عمله أو إصدار رمز لفاتورة مفردة.

الحقول الخمسة الإلزامية

يجب أن يتضمن الرمز خمسة حقول بترتيب محدد:

| الرقم (Tag) | الحقل | | --- | --- | | 1 | اسم البائع | | 2 | الرقم الضريبي للبائع (15 رقماً) | | 3 | الطابع الزمني للفاتورة (بصيغة ISO 8601) | | 4 | إجمالي الفاتورة شاملاً الضريبة | | 5 | إجمالي ضريبة القيمة المضافة |

ما هو ترميز TLV؟

TLV اختصار لـ Tag-Length-Value (الوسم، الطول، القيمة). كل حقل يُرمَّز في ثلاثة أجزاء متتالية:

1. Tag: بايت واحد يحمل رقم الحقل (1 إلى 5).
2. Length: بايت واحد يحمل عدد بايتات القيمة.
3. Value: القيمة نفسها بترميز UTF-8.

تُرصّ الحقول الخمسة متتالية، ثم يُحوَّل الناتج كاملاً إلى Base64، وهذه السلسلة النصية هي ما يُرمَّز في صورة QR.

مثال توضيحي للبنية

لو كان اسم البائع مكوّناً من 12 بايت، فإن أول حقل يبدأ بـ: بايت قيمته 1 (الوسم)، ثم بايت قيمته 12 (الطول)، ثم 12 بايت الاسم. ثم يبدأ الحقل الثاني بالوسم 2 وهكذا.

انتبه أن الأحرف العربية تشغل بايتين أو أكثر في UTF-8، فطول القيمة بالبايتات يختلف عن عدد الحروف — وهذا مصدر خطأ شائع عند البرمجة اليدوية.

ملاحظات مهمة للتطبيق

• هذه الأداة للمرحلة الأولى: المرحلة الثانية (الربط والتكامل) تتطلب توقيعاً رقمياً وختماً تشفيرياً وحقولاً إضافية، ويجب أن يُنفَّذ عبر حل فوترة معتمد مربوط بمنصة الهيئة.
• الفاتورة الضريبية (للمنشآت) تختلف متطلباتها عن الفاتورة المبسّطة (للمستهلك).
• لا تُغني هذه الأداة عن حل فوترة معتمد إن كنت ملزماً نظاماً — استخدمها للفهم أو للحالات المفردة.

أخطاء شائعة في توليد الرمز

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

خصوصية كاملة

كل عمليات الترميز وتوليد صورة QR تتم داخل متصفحك بالكامل — بيانات فاتورتك واسم منشأتك ورقمك الضريبي لا تُرسل إلى أي خادم ولا تُخزَّن لدينا. يمكنك تحميل صورة الرمز أو نسخ نص Base64 لاستخدامه في نظامك.