تخطي إلى المحتوى الرئيسي

Microtec

مولّد رمز QR للفاتورة الضريبية

خمسة حقول ← ترميز TLV ← نص Base64 ← رمز المرحلة الأولى.

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

ر.س
ر.س

كل شيء يُحسب في متصفحك، ولا يُرسل أي حقل إلى خادم.

—

—

التاريخ
—
الضريبة
—
الإجمالي
—
أكمل الحقول الخمسة ليظهر الرمز

رمز المرحلة الأولى

تفكيك TLV حقلاً حقلاً
الوسمالحقلالطول (بايت)القيمةأول البايتات (Hex)
—

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

باختصاركل حقل يُكتب بثلاثة أجزاء: رقم الوسم، وطول القيمة بالبايت، ثم القيمة. تُرصّ الحقول الخمسة متتالية ثم تُحوَّل إلى Base64، وهذا النص هو ما يُرسم رمزاً.

كيف يُبنى باركود الضريبة بترميز TLV

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

[Tag 1 byte][Length 1 byte][Value UTF-8] × 5 → Base64 → QR

مثال توضيحي: «مؤسسة الريان التجارية» برقم ضريبي 310122393500003، وفاتورة بتاريخ 1 أكتوبر 2026 الساعة 12:30 بتوقيت السعودية، إجماليها 1,150.00 ريالاً وضريبتها 150.00. اسم البائع 19 حرفاً ومسافتان تصير 40 بايتاً، فيبدأ الحقل الأول بالبايتين 01 28. والتاريخ يُكتب بالتوقيت العالمي 2026-10-01T09:30:00Z في 20 بايتاً. يبدأ النص الناتج بـASjZhdik، والمثال جاهز بزر «مثال توضيحي».

باركود الفاتورة الإلكترونية في المرحلة الأولى والثانية

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

باركود هيئة الزكاة والدخل: ما الذي يقرؤه تطبيق الهيئة

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

أخطاء شائعة في رمز QR للفاتورة

  • كتابة طول الحقل بعدد الحروف لا بعدد البايتات، فيُقرأ الاسم العربي مقطوعاً.
  • رقم ضريبي من 14 رقماً أو بمسافات، والصحيح 15 رقماً يبدأ بالرقم 3 وينتهي به.
  • الإجمالي قبل الضريبة في الحقل الرابع، والمطلوب الإجمالي شاملاً الضريبة.
  • التاريخ بلا وقت، أو بالتوقيت المحلي دون فرق التوقيت.
  • رسم رابط صفحة الفاتورة في الرمز بدل نص Base64.

ماذا تفعل بعد توليد الرمز

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

حين تحتاج رمز المرحلة الثانية

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

أسئلة شائعة

ما البيانات التي يحملها باركود الفاتورة الضريبية؟

في المرحلة الأولى خمسة حقول: اسم البائع، ورقمه الضريبي، وتاريخ الفاتورة ووقتها، والإجمالي شاملاً الضريبة، ومبلغ الضريبة، مرمّزة بطريقة TLV ثم Base64.

هل يكفي هذا الرمز لتكون فاتورتي فاتورة إلكترونية؟

لا. الفاتورة الإلكترونية تصدر من حل فوترة إلكترونية متوافق، والرمز وحده لا يغيّر طبيعة المستند. ورمز المرحلة الثانية يحتاج توقيعاً رقمياً لا يولّده إلا حل مربوط بالهيئة.

لماذا يختلف طول الحقل عن عدد حروف اسم البائع؟

لأن الطول يُحسب بالبايت بعد ترميز UTF-8، والحرف العربي بايتان. «مؤسسة الريان التجارية» فيها 19 حرفاً ومسافتان، فطولها 40 بايتاً، وهذا الرقم هو ما يُكتب بعد الوسم.

بأي صيغة يُكتب تاريخ الفاتورة في الرمز؟

بصيغة ISO 8601 بالتوقيت العالمي، مثل 2026-10-01T09:30:00Z. المولّد يأخذ الوقت بتوقيت السعودية ويطرح منه ثلاث ساعات.

↑