المدونة/الهندسة
الهندسة

رمز QR في فاتورة هيئة الزكاة والضريبة والجمارك: شرح الحقول التسعة لفاتورة المرحلة الثانية

D
Dante21 نوفمبر 2026 · قراءة 6 دقائق
رمز QR في فاتورة هيئة الزكاة والضريبة والجمارك: شرح الحقول التسعة لفاتورة المرحلة الثانية

شرح · تم التحقق في 21 نوفمبر 2026

رمز QR في فاتورة المرحلة الثانية يحمل 9 حقول: اسم البائع والرقم الضريبي والتاريخ والوقت والإجمالي مع الضريبة ومبلغ الضريبة وبصمة الفاتورة والتوقيع الرقمي والمفتاح العام وتوقيع الشهادة.

يُكتب كل حقل بصيغة TLV (رقم الحقل والطول والقيمة)، وتُجمع الحقول وتُرمَّز بـ base64، ويصبح هذا النص صورة الرمز. فيما يلي نفكّ رمزاً حقيقياً للمرحلة الثانية من تجربتنا الحية بايتاً بايتاً، ونعدّد الأخطاء التي تجعل الهيئة تعترض عليه.

رسم من آيفينيكس: الحقول التسعة بصيغة TLV داخل رمز QR لفاتورة المرحلة الثانية، مفكوكة
أول ثلاثة حقول TLV من رمز حقيقي للمرحلة الثانية، وأسماء الحقول التسعة. تصميم: آيفينيكس.

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

ماذا يوجد داخل رمز QR للفاتورة؟

هذا الرمز من فاتورة تجريبية بقيمة 71.75 ريالاً (صنفان وضريبة 15%) بعد فكّه. الحقول من 1 إلى 5 هي حقول المرحلة الأولى، والحقول من 6 إلى 9 تأتي مع الربط في المرحلة الثانية.

الحقلالاسمما يجب أن يحتويهمثالنا
1اسم البائعالاسم المسجل للبائع كما في ملف XML.iFynx Demo Store (16 بايت)
2الرقم الضريبي15 رقماً تبدأ وتنتهي بالرقم 3.399999999900003 (15 بايت)
3تاريخ ووقت الفاتورةيجب أن يطابق IssueDate وIssueTime في الملف تماماً.2026-11-21T10:15:00 (19 بايت)
4إجمالي الفاتورة مع الضريبةنفس قيمة TaxInclusiveAmount في الملف.71.75 (5 بايت)
5إجمالي الضريبةنفس قيمة ضريبة الفاتورة في الملف.9.36 (4 بايت)
6بصمة الفاتورةSHA-256 لملف XML الموحّد، بترميز base64.44 حرفاً
7التوقيع الرقميتوقيع ECDSA على بصمة الفاتورة، بترميز base64.96 حرفاً في اختبارنا
8المفتاح العامالمفتاح العام لجهاز التوقيع (من شهادته).88 بايت
9توقيع الشهادةتوقيع الهيئة على شهادة الجهاز، ويُستخدم في الفواتير المبسطة.72 بايت في اختبارنا

المجموع 377 بايت، أي 504 أحرف base64 داخل صورة الرمز.

كيف يُرمَّز الرمز؟ (صيغة TLV في صورة واحدة)

TLV اختصار لرقم الحقل والطول والقيمة. يبدأ كل حقل ببايت لرقمه، ثم بايت لطول القيمة بالبايت، ثم القيمة نفسها. هذا بداية رمزنا بالنظام الست عشري:

0110iFynx Demo Store020F39999999990000303132026-11-21T10:15:00…

01 = الحقل 1 (اسم البائع)، و10 = طوله 16 بايت، ثم الاسم. 02 = الحقل 2، و0F = ‏15 بايت، ثم الرقم الضريبي. 03 = الحقل 3، و13 = ‏19 بايت، ثم الوقت. وبعد الحقول التسعة تُرمَّز البايتات بـ base64.

لأن الطول بايت واحد، لا يتجاوز الحقل 255 بايت. وهذا مهم لأسماء البائعين العربية الطويلة، لأن كل حرف عربي يأخذ بايتين.

ما الذي تغيّر بين المرحلة الأولى والثانية؟

بدأت المرحلة الأولى (الإصدار) في 4 ديسمبر 2021 واشترطت رمزاً بالحقول الخمسة المقروءة. أما المرحلة الثانية (الربط) فتُطبَّق على المكلفين على موجات؛ والموجة 25 تشمل من تجاوزت إيراداته الخاضعة للضريبة 187,500 ريال في أي سنة من 2022 إلى 2025، وموعد الربط 1 فبراير 2027 (الهيئة). بعد الربط يوقّع نظامك كل فاتورة، ويحمل الرمز البصمة والتوقيع والمفتاح العام وتوقيع الشهادة، فيستطيع أي أحد التأكد من أن الفاتورة لم تُعدَّل بعد إصدارها.

أخطاء شائعة في الرمز (والتحذير الذي واجهناه)

افحص هذه قبل التشغيل الفعلي

1
وقت لا يطابق ملف XML. هذا بالضبط التحذير الذي أعطتنا إياه البيئة التجريبية للهيئة (invoiceTimeStamp_QRCODE_INVALID): كانت قيمة QR تحمل حرف Z زائداً. ابنِ الحقل 3 من IssueDate وIssueTime.
2
صيغة مختلفة للمبالغ. إذا كان الملف يقول 71.75 فيجب أن يقول رمز QR ‏71.75، لا 71.750 ولا SAR 71.75. خذ الحقلين 4 و5 من القيم النهائية في الملف.
3
عدّ الحروف بدل البايتات. الأطوال في TLV بالبايت. الحرف العربي يأخذ بايتين في UTF-8، فاسم بائع عربي من 20 حرفاً طوله 40 بايت. والطول الخاطئ يفسد كل الحقول التي بعده.
4
بصمة محسوبة قبل الملف النهائي. يجب أن يكون الحقل 6 بصمة الفاتورة كما أُرسلت. أي تغيير بعد حساب البصمة، ولو في المسافات، يفسدها.
5
رمز المرحلة الأولى في نظام المرحلة الثانية. كان رمز بخمسة حقول كافياً في المرحلة الأولى. بعد الربط تحمل الفواتير المبسطة الحقول التسعة كلها.
6
رمز مطبوع صغير أو غير واضح. رمز المرحلة الثانية يحمل بضع مئات من البايتات (377 في مثالنا)، فهو أكثف بكثير من رمز المرحلة الأولى. جرّب أن تقرأه الهواتف على طابعة الإيصالات والورق الذي تستخدمه فعلاً.

كيف أفحص رمز QR في فاتورة؟

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

كيف تساعد آيفينيكس

تربط آيفينيكس أنظمة الكاشير وERP والمتاجر الإلكترونية والتطبيقات الخاصة بمنصة فاتورة، مع رموز QR صحيحة للمرحلة الثانية على الشاشة وعلى طابعات الإيصالات.

  • توليد الرمز من ملف XML النهائي الموقّع، بالعربية والإنجليزية، مع اختبار على طابعات حقيقية.
  • التسجيل في فاتورة والتوقيع والإبلاغ والاعتماد، مع مراقبة التحذيرات.
  • اختبار على البيئة التجريبية بفواتيرك الحقيقية قبل التشغيل.

جرّب التجربة الحية · تواصل مع آيفينيكس · احسب تكلفة مشروعك

أسئلة شائعة

كم حقلاً في رمز QR لفاتورة الهيئة؟

رمز المرحلة الأولى فيه 5 حقول: اسم البائع والرقم الضريبي والتاريخ والوقت والإجمالي مع الضريبة ومبلغ الضريبة. وتضيف المرحلة الثانية 4 حقول: بصمة الفاتورة والتوقيع الرقمي والمفتاح العام وتوقيع الشهادة، فيصبح المجموع 9 في الفواتير المبسطة.

ما صيغة رمز QR في فاتورة الهيئة؟

يُكتب كل حقل بصيغة TLV: بايت لرقم الحقل، وبايت للطول بالبايت، ثم القيمة. تُجمع الحقول كلها ويُرمَّز الناتج بـ base64، وهذا النص هو ما تحتويه صورة QR.

لماذا يظهر عند مسح الرمز نص غير مفهوم؟

لأن الرمز يحمل نص base64 لا كلمات عادية. فك ترميز base64 ثم اقرأ حقول TLV واحداً تلو الآخر. وتجربتنا الحية تعرض الحقول مفكوكة بجانب الرمز.

هل يحتاج وقت رمز QR إلى منطقة زمنية؟

يجب أن يطابق IssueDate وIssueTime في الفاتورة كما كُتبا في ملف XML تماماً. في اختبارنا على البيئة التجريبية أدت إضافة حرف Z إلى قيمة QR وحدها إلى التحذير invoiceTimeStamp_QRCODE_INVALID.

هل أستطيع توليد الرمز دون الربط مع فاتورة؟

رمز المرحلة الأولى (5 حقول) لا يحتاج ربطاً. أما الحقول من 6 إلى 9 في المرحلة الثانية فتحتاج مفتاح توقيع وشهادة تصدر عند التسجيل في فاتورة، فهي تأتي مع الربط.

أين أرى رمز QR للمرحلة الثانية وهو يُبنى؟

جرّب تجربة آيفينيكس الحية للمرحلة الثانية: أصدر فاتورة وسترى الرمز والحقول التسعة مفكوكة، وكل ذلك في متصفحك.

اقرأ أيضاً

تم التحقق في 21 نوفمبر 2026. المثال مفكوك من فاتورة أصدرها محرك تجربة آيفينيكس (بشهادة تجريبية). المصادر: إعلان الموجة 25، وسجلات اختبارنا.

🛡️ نشرة آيفينيكس الأمنية · كل أحدثغرات الأسبوع التي تهمّ شركات الخليج ومصر، في رسالة واحدة

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

تصفّح الأعداد السابقة →