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

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

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

القيم الخمس

• اسم البائع كما يظهر في الفاتورة، ويُحفظ الاسم العربي كما هو لأن القيم تُكتب بترميز UTF-8.
• الرقم الضريبي للبائع، ١٥ رقمًا.
• تاريخ الفاتورة ووقتها.
• إجمالي الفاتورة شاملًا ضريبة القيمة المضافة.
• إجمالي الضريبة.

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

كيف يُبنى الرمز

1. تُكتب كل قيمة بصيغة TLV: بايت لرقم الوسم من ١ إلى ٥، ثم بايت لطول القيمة بالبايت، ثم القيمة نفسها نصًا بترميز UTF-8.
2. تُضم المجموعات الخمس بعضها إلى بعض بترتيب الوسوم دون أي فاصل.
3. تُحوَّل البايتات المضمومة إلى نص Base64، وهذا النص هو ما يحمله الرمز.
4. يُرسم النص على هيئة رمز QR، وإذا قرأته كاميرا الهاتف ظهر النص نفسه.

لأن الطول يُكتب في بايت واحد، لا يمكن أن تزيد أي قيمة على ٢٥٥ بايتًا. والحرف العربي يشغل بايتين، فقد يبلغ اسم عربي طويل جدًا هذا الحد. عندها تنبهك الأداة بدل أن تقص الاسم، لأن رمزًا يُقرأ وفيه نصف اسم أسوأ من عدم وجود رمز.

كيف تكتب القيم بشكل صحيح

• اكتب المبالغ رقمًا عشريًا بخانتين ودون فواصل للآلاف كما في أمثلة الهيئة: 1150.00 لا 1,150. الأداة تفعل ذلك تلقائيًا، وتقبل الأرقام العربية الهندية في الإدخال.
• الإجمالي هو ما يدفعه العميل شاملًا الضريبة، وإجمالي الضريبة هو الضريبة التي بداخله. إذا كنت تعرف الإجمالي فقط فالزر تحت حقل الضريبة يحسب ضريبة ١٥٪ منه: الإجمالي مضروبًا في ١٥ ومقسومًا على ١١٥.
• يتبع الوقت أمثلة الهيئة بصيغة ISO 8601 المنتهية بحرف Z. تكتب الأداة التاريخ والوقت اللذين تدخلهما بهذه الصيغة، فاستخدم الوقت المطبوع على الفاتورة نفسه.
• يجب أن يطابق اسم البائع ورقمه الضريبي ما هو مطبوع على الفاتورة. الرمز الذي يخالف فاتورته هو أكثر خطأ يكشفه القارئ.

تعمل مراجعتان أثناء الكتابة. الأولى للرقم الضريبي: الأرقام الضريبية السعودية ١٥ رقمًا تبدأ بالرقم 3 وتنتهي به. والثانية تقسم الضريبة على المبلغ قبل الضريبة، فإذا لم تكن النتيجة ١٥٪ أو صفرًا فراجع القيم، لأن ذلك يعني غالبًا أن الإجمالي كُتب دون الضريبة أو أن الحقلين تبادلا مكانيهما.

المرحلة الأولى والمرحلة الثانية

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

تنقل الهيئة المنشآت إلى المرحلة الثانية على موجات، وتبلّغ كل منشأة تشملها. وفي ٢٤ يوليو ٢٠٢٦ أعلنت الموجة الخامسة والعشرين: المنشآت التي تجاوزت إيراداتها الخاضعة للضريبة ١٨٧٬٥٠٠ ريال في أي سنة من ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ أو ٢٠٢٥، وعليها الربط في موعد أقصاه ١ فبراير ٢٠٢٧. هذا الحد يشمل كثيرًا من المنشآت الصغيرة، فإذا وصلك إشعار من الهيئة فيجب أن تحمل فواتيرك الرمز الذي يصدره نظامك المرتبط من التاريخ المحدد فيه.

الموجة الخامسة والعشرون وحد الإيرادات والسنوات المعتمدة وموعد ١ فبراير ٢٠٢٧ واردة في إعلان الهيئة. هيئة الزكاة والضريبة والجمارك، الموجة الخامسة والعشرون من مرحلة الربط والتكامل

يُنشأ الرمز داخل متصفحك. القيم التي تكتبها والصورة والنص لا تغادر جهازك، ولا يُحفظ شيء بعد إغلاق الصفحة.