رمز QR في الفاتورة الإلكترونية: متطلبات الهيئة للمرحلتين

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

ما رمز الاستجابة السريعة في الفاتورة الإلكترونية؟

رمز QR في فاتورة الزكاة هو المربع المطبوع على الفواتير الإلكترونية في المملكة، وهو ليس رابطًا لموقع إلكتروني، بل نسخة مشفّرة ومختصرة من أهم بيانات الفاتورة يمكن لأي شخص مسحها للتأكد من مُصدر الفاتورة وتاريخها وقيمة الضريبة فيها. أطلقته الهيئة مع المرحلة الأولى من الفوترة الإلكترونية (مرحلة الإصدار) في 4 ديسمبر 2021، ثم توسّع محتواه في المرحلة الثانية (مرحلة الربط والتكامل) التي تُطبَّق على المكلفين على دفعات منذ 1 يناير 2023.

ويُعد الرمز من أوضح علامات الالتزام بالفوترة الإلكترونية؛ فالعميل أو المدقق أو مفتش الهيئة يستطيع التحقق منه خلال ثوانٍ، ولذلك يُكتشف الرمز الخاطئ أو غير المقروء بسهولة.

ما الفواتير التي تحتاج إلى رمز QR؟

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

في المرحلة الثانية تخضع الفواتير الضريبية لـالاعتماد (Clearance) من الهيئة قبل مشاركتها مع المشتري، بينما يتم الإبلاغ (Reporting) عن الفواتير المبسطة خلال 24 ساعة من إصدارها، وفي الحالتين يجب أن يطابق الرمز الفاتورة النهائية الموقّعة. ويشرح دليلنا للمرحلة الثانية من الفوترة الإلكترونية الاعتماد والإبلاغ بتفصيل أكبر.

بيانات رمز QR في المرحلة الأولى

يحتوي رمز المرحلة الأولى على خمسة حقول:

الوسم	الحقل	قيمة توضيحية
1	اسم البائع	Example Store
2	الرقم الضريبي للبائع	300000000000003
3	تاريخ ووقت إصدار الفاتورة	2026-11-09T14:25:00Z
4	إجمالي الفاتورة شاملًا الضريبة	1150.00
5	إجمالي ضريبة القيمة المضافة	150.00

كيف يعمل ترميز TLV وBase64؟

لا تُكتب الحقول نصًا عاديًا، بل يُرمَّز كل حقل بصيغة TLV (الوسم - الطول - القيمة): بايت واحد لرقم الوسم، وبايت واحد لطول القيمة بالبايت، ثم القيمة نفسها بترميز UTF-8. تُضمّ الحقول متتالية دون فواصل، ثم تُحوَّل السلسلة كاملة إلى Base64، وهذا النص هو ما يخزّنه رمز QR.

في المثال أعلاه طول الوسم 1 يساوي 13 بايت، والوسم 2 يساوي 15، والوسم 3 يساوي 20، والوسم 4 يساوي 7، والوسم 5 يساوي 6. والناتج بصيغة Base64 هو:

AQ1FeGFtcGxlIFN0b3JlAg8zMDAwMDAwMDAwMDAwMDMDFDIwMjYtMTEtMDlUMTQ6MjU6MDBaBAcxMTUwLjAwBQYxNTAuMDA=

انتبه إلى أن الطول يُحسب بالبايت لا بعدد الحروف؛ فالحرف العربي يشغل بايتين في UTF-8، أي أن اسمًا عربيًا من أربعة أحرف طوله 8 بايت. والخطأ في ذلك من أشهر أسباب فشل قراءة الرمز.

الحقول الإضافية في رمز المرحلة الثانية

بعد ربط المنشأة بمنصة "فاتورة"، يجب أن يُصدر نظامها فاتورة XML موقّعة رقميًا، ويُضاف إلى الرمز حقول تشفيرية تربطه بتلك الفاتورة:

الوسم	الحقل	الغرض
6	قيمة التجزئة (Hash) لفاتورة XML	تثبت أن الرمز يخص هذه الفاتورة تحديدًا
7	التوقيع الرقمي ECDSA	توقيع الفاتورة من نظام البائع
8	المفتاح العام ECDSA	يُمكّن من التحقق من التوقيع
9	توقيع الهيئة على المفتاح العام لختم التشفير	للفواتير المبسطة وإشعاراتها؛ يربط شهادة الجهاز بالهيئة

يُمنح ختم التشفير لكل جهاز أو نظام فوترة عند تسجيله وربطه بالهيئة. ولأن قيمة التجزئة والتوقيع تُحسبان من فاتورة XML النهائية، يجب توليد الرمز بعد توقيع الفاتورة، ولا يجوز تعديل الفاتورة المطبوعة بعد ذلك؛ وأي تصحيح يتم بإشعار دائن أو مدين له رمزه الخاص.

كيف يتحقق العميل من رمز QR؟

توفر الهيئة تطبيقًا رسميًا على Google Play وApp Store يتضمن خدمة التحقق من الفاتورة الإلكترونية، وتوضح صفحة خدمة التحقق من صحة الفاتورة الخطوات:

1. افتح التطبيق وانتقل إلى قسم خدمات الزكاة والضريبة والجمارك.
2. اختر خدمة التحقق من الفاتورة الإلكترونية.
3. امسح رمز QR على الفاتورة المطبوعة أو بصيغة PDF.
4. قارن البيانات الظاهرة (البائع، الرقم الضريبي، التاريخ، الإجماليات) بما هو مطبوع على الفاتورة.

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

إذا لم تتطابق البيانات أو تعذّرت قراءة الرمز، فللعميل الحق في التشكيك في الفاتورة؛ لذلك ينبغي للمتاجر والمطاعم اختبار الرموز بالتطبيق على طابعاتها الفعلية قبل التشغيل.

أخطاء شائعة في رمز QR يجب تجنّبها

• ترميز رابط أو نص عادي بدلًا من بيانات TLV بصيغة Base64.
• كتابة الوسم والطول كحروف نصية (مثل "01") بدلًا من بايت واحد.
• حساب الطول بعدد الحروف لا بالبايت، مما يفسد أسماء البائعين العربية.
• إجماليات لا تطابق الفاتورة بسبب فروق التقريب بين البنود والإجمالي.
• اسم بائع أو رقم ضريبي مختلف عن البيانات المسجلة لدى الهيئة.
• صيغة خاطئة للتاريخ والوقت، أو استخدام وقت الطباعة بدل وقت الإصدار.
• توليد رمز المرحلة الثانية قبل التوقيع، فلا تتطابق قيمة التجزئة والتوقيع مع ملف XML المرسل إلى الهيئة.
• طباعة الرمز صغيرًا أو باهتًا على الإيصالات الحرارية فلا تقرؤه الهواتف.
• استخدام مولّد QR مجاني بدل نظام فوترة متوافق بعد شمولك بالمرحلة الثانية.

توليد رموز QR متوافقة تلقائيًا

الطريقة الأكثر أمانًا أن يبني نظام الفوترة رمز QR من البيانات نفسها التي تُنتج الفاتورة، فلا تختلف الإجماليات أو الضريبة أو التوقيعات أبدًا. يُصدر نظام أكسو ون السحابي لنقاط البيع فواتير مبسطة وضريبية متوافقة مع المرحلة الثانية مع رمز QR يولّده النظام، ويعمل مع نظام أكسو ون للمخزون والمحاسبة لدفاترك وتقارير الضريبة. وللمطاعم يمكنكم الاطلاع على نظام نقاط البيع للمطاعم.

هل تريد فواتير يتحقق منها عملاؤك بثقة؟ تعرّف على نظام أكسو ون السحابي لنقاط البيع أو احجز عرضًا تجريبيًا مجانيًا مع فريقنا في الرياض.

الأسئلة الشائعة