الحقول الخمسة التي تطلبها المواصفة، مرمّزة بصيغة TLV ثم Base64، محسوبة من المبالغ نفسها المطبوعة على الفاتورة فلا يمكن أن يختلفا.
مجاني وبلا تسجيل. ولا يخرج شيء مما تكتبه من متصفحك.
مثال مملوء. أرقامك تحل مكان هذه الأرقام.
رمز المرحلة الأولى ليس صورة للفاتورة ولا رابطًا إلى الهيئة. هو سلسلة نصية قصيرة تحمل خمسة حقول عن هذه الفاتورة بعينها، مطبوعة على الورقة حتى يستطيع أي مفتش التحقق منها بهاتفه دون اتصال بأي نظام.
لا أكثر. لا بنود، ولا اسم المشتري، ولا رقم الفاتورة. الرمز الذي يحمل أكثر من ذلك ليس أكثر توافقًا، بل مختلف عن المواصفة.
كل حقل يُكتب على ثلاثة أجزاء متتابعة: رقم الوسم في بايت واحد، ثم طول القيمة في بايت واحد، ثم القيمة نفسها بترميز UTF-8. تُرصف الحقول الخمسة بترتيب الوسوم، ثم تُحوَّل سلسلة البايتات كلها إلى Base64، وهذه السلسلة هي ما يوضع في الرمز.
بايت الطول واحد، فأقصى طول لقيمة واحدة ٢٥٥ بايت. واسم مورّد عربي طويل قد يتجاوز ذلك لأن الحرف العربي يشغل بايتين في UTF-8 لا بايتًا واحدًا. يرفض المولّد القيمة الأطول بخطأ صريح بدلًا من قطعها، لأن اسمًا مقطوعًا ينتج رمزًا يُقرأ ويكذب.
تشرح مواصفة الهيئة الحقول الخمسة وترميز TLV وتحويله إلى Base64، وفيها مثالان محسوبان. دليل إنشاء رمز الاستجابة السريعة المتوافق مع فاتورة
القيم الرقمية تُكتب بالأرقام الغربية وبنقطة عشرية عادية، بلا فواصل آلاف وبلا رمز عملة، أيًا كان ما يُعرض على الفاتورة. فإن اخترت عرض الأرقام العربية الهندية فسترى ١٢٠٤٫٠٠ على الورقة و1204.00 داخل الرمز، وهذا هو الصحيح.
يبني المولّد محتوى الرمز من المبالغ نفسها التي تُعرض على الفاتورة، من مصدر واحد مشترك بين المعاينة وملف PDF، فلا يمكن أن يختلف الرمز عن الأرقام المطبوعة فوقه.
هذه القيم الخمس هي ما يُرمَّز. الرقم الضريبي أعلاه مثال من مواصفة الهيئة نفسها لا رقم منشأة قائمة.
امسح الرمز بأي قارئ على هاتفك. يجب أن تظهر لك سلسلة Base64 لا رابط. ثم افتح ملف PDF على جهاز آخر وامسحه مرة أخرى: هكذا تعرف أن الرمز خرج في الملف نفسه لا في المعاينة وحدها.
اختبارات المولّد تفعل ذلك آليًا: تطابق مخرجاته مع المثالين المنشورين في مواصفة الهيئة بايتًا ببايت، ثم تفك قراءة الرمز المرسوم وتعيده إلى حقوله، ثم تمسح رمزًا من ملف PDF مولَّد فعلًا.
المرحلة الأولى هي الإصدار. هذا المولّد لا يرتبط بمنصة فاتورة ولا يرسل إليها، فلا يُغني عن تكامل المرحلة الثانية إذا كانت منشأتك ملزمة به.
آخر تحقق من المصادر 2026-10-16