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

إذا كنت تدير متجراً أو مطعماً أو منتجاً رقمياً في السعودية، فرمز 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 اختصار لرقم الحقل والطول والقيمة. يبدأ كل حقل ببايت لرقمه، ثم بايت لطول القيمة بالبايت، ثم القيمة نفسها. هذا بداية رمزنا بالنظام الست عشري:
01 = الحقل 1 (اسم البائع)، و10 = طوله 16 بايت، ثم الاسم. 02 = الحقل 2، و0F = 15 بايت، ثم الرقم الضريبي. 03 = الحقل 3، و13 = 19 بايت، ثم الوقت. وبعد الحقول التسعة تُرمَّز البايتات بـ base64.
لأن الطول بايت واحد، لا يتجاوز الحقل 255 بايت. وهذا مهم لأسماء البائعين العربية الطويلة، لأن كل حرف عربي يأخذ بايتين.
ما الذي تغيّر بين المرحلة الأولى والثانية؟
بدأت المرحلة الأولى (الإصدار) في 4 ديسمبر 2021 واشترطت رمزاً بالحقول الخمسة المقروءة. أما المرحلة الثانية (الربط) فتُطبَّق على المكلفين على موجات؛ والموجة 25 تشمل من تجاوزت إيراداته الخاضعة للضريبة 187,500 ريال في أي سنة من 2022 إلى 2025، وموعد الربط 1 فبراير 2027 (الهيئة). بعد الربط يوقّع نظامك كل فاتورة، ويحمل الرمز البصمة والتوقيع والمفتاح العام وتوقيع الشهادة، فيستطيع أي أحد التأكد من أن الفاتورة لم تُعدَّل بعد إصدارها.
أخطاء شائعة في الرمز (والتحذير الذي واجهناه)
افحص هذه قبل التشغيل الفعلي
invoiceTimeStamp_QRCODE_INVALID): كانت قيمة QR تحمل حرف Z زائداً. ابنِ الحقل 3 من IssueDate وIssueTime.71.75 فيجب أن يقول رمز QR 71.75، لا 71.750 ولا SAR 71.75. خذ الحقلين 4 و5 من القيم النهائية في الملف.كيف أفحص رمز 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 للمرحلة الثانية وهو يُبنى؟
جرّب تجربة آيفينيكس الحية للمرحلة الثانية: أصدر فاتورة وسترى الرمز والحقول التسعة مفكوكة، وكل ذلك في متصفحك.
اقرأ أيضاً
- اختبرنا فواتير المرحلة الثانية على البيئة التجريبية لمنصة فاتورة: ما معنى PASS وWARNING وERROR؟
- الموجة 25 من فاتورة: ما يجب أن تسلّمه فرق المنتج والبرمجة قبل 1 فبراير 2027
تم التحقق في 21 نوفمبر 2026. المثال مفكوك من فاتورة أصدرها محرك تجربة آيفينيكس (بشهادة تجريبية). المصادر: إعلان الموجة 25، وسجلات اختبارنا.
كل يوم أحد: أخطر الثغرات والاختراقات المؤكدة، ومن المتأثر في السعودية والإمارات ومصر، وما الذي يجب تحديثه أولاً. مجانية، بالعربية والإنجليزية، ويمكنك إلغاء الاشتراك بنقرة.
✓ تم الاشتراك. ستصلك رسالة ترحيب الآن، وأول عدد يوم الأحد.
