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

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

إذا كان متجر WooCommerce لديك يصدر فواتير PDF تحتوي على رمز QR، فعليك فحص محتوى الرمز والنظام الذي أنشأه. وجود الرمز على الفاتورة وحده لا يثبت استيفاء متطلبات الربط والتكامل.

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

بدأت ZATCA تطبيق المرحلة الأولى (الإصدار) في 4 ديسمبر 2021. وألزمت المنشآت بإصدار فواتير إلكترونية تتضمن البيانات المقررة، ومنها رمز QR للفواتير الضريبية المبسطة.

بدأ تطبيق المرحلة الثانية (الربط والتكامل) في 1 يناير 2023، وتُطبق على المكلفين وفق موجات تعلنها الهيئة. وأضيفت فيها متطلبات تقنية لإنشاء الفواتير والتوقيع الرقمي والاتصال بأنظمة ZATCA.

توضح الإرشادات التقنية التفصيلية للفوترة الإلكترونية الصادرة عن ZATCA الفروق بين رموز QR في القسم 6. وتشمل هذه الفروق عدد الحقول والبيانات التقنية التي يحملها الرمز.

مقارنة حقول رمز QR

يوضح الجدول متطلبات رمز QR للفواتير الضريبية المبسطة، التي تُصدر عادة للمستهلكين الأفراد.

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

يشير TLV إلى الوسم والطول والقيمة (Tag-Length-Value). يتضمن كل حقل رقمًا يحدد نوعه، وطول البيانات، وقيمتها. وتحدد ZATCA طريقة تجميع هذه الحقول وترميزها داخل رمز QR.

يحتوي الوسم 6 على بصمة محسوبة من ملف XML للفاتورة. ويحمل الوسم 7 التوقيع الرقمي، بينما يتضمن الوسم 8 بيانات المفتاح العام. أما الوسم 9 فيحتوي على توقيع جهة التصديق التقنية التابعة لـ ZATCA على المفتاح العام للختم التشفيري.

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

وجود رمز QR لا يكفي لاستيفاء متطلبات المرحلة الثانية

قد يطبع مكوّن الفواتير الحالي اسم البائع والرقم الضريبي والإجمالي داخل رمز QR. وقد ينشئ أيضًا فاتورة PDF تحتوي على بيانات الطلب بتنسيق واضح.

لكن هذه الوظائف لا تثبت التوافق مع متطلبات المرحلة الثانية (الربط والتكامل). فهناك عمليات إضافية يجب أن ينفذها نظام الفوترة قبل اعتبار الفاتورة مستوفية للمتطلبات التقنية.

يجب إنشاء الفاتورة بصيغة XML

تستخدم فواتير المرحلة الثانية (الربط والتكامل) صيغة XML المبنية على معيار UBL 2.1. ويتضمن الملف بيانات الفاتورة والحقول التقنية اللازمة لمعالجتها إلكترونيًا.

لا يحل ملف PDF الناتج من بيانات طلب WooCommerce محل ملف XML المطلوب. ويمكن تقديم نسخة مقروءة للعميل، لكن المستند الإلكتروني الأساسي يجب أن يستوفي متطلبات ZATCA من حيث الصيغة والمحتوى.

يجب توقيع الفاتورة رقميًا

تستخدم المرحلة الثانية (الربط والتكامل) التوقيع الرقمي لحماية سلامة بيانات الفاتورة. ويساعد التوقيع على التحقق من أن محتوى المستند لم يتغير بعد توقيعه.

يحمل كل مستند إلكتروني أيضًا عداد الفواتير (ICV) وبصمة الفاتورة السابقة (PIH). وتربط البصمة السابقة المستند بالمستند الذي سبقه في التسلسل.

يجب على نظام الفوترة المحافظة على هذا التسلسل عند إنشاء المستندات. وقد يؤدي إنشاء عدة مستندات في الوقت نفسه دون ضبط العداد وسلسلة البصمات إلى حدوث مشكلات في التسلسل.

يجب أن يتصل النظام بمنصة فاتورة

يرسل نظام الفوترة المرتبط بالهيئة المستندات إلى ZATCA عبر واجهة API. ويختلف الإجراء المطلوب بحسب نوع الفاتورة.

يجب الإبلاغ عن الفواتير الضريبية المبسطة خلال 24 ساعة من إصدارها. أما الفواتير الضريبية فيجب الحصول على التصريح من ZATCA قبل تقديمها إلى المشتري.

لا يوضح وجود رمز QR على الفاتورة ما إذا كان النظام قد أرسلها إلى الهيئة. ويمكن الرجوع إلى الإرشادات التفصيلية للفوترة الإلكترونية الصادرة عن ZATCA للاطلاع على هذه المتطلبات.

يمكنك فحص رمز QR الموجود على فواتيرك الحالية

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

افحص الرمز باستخدام تطبيق ضريبة القيمة المضافة من ZATCA

توضح ZATCA إمكانية التحقق من رموز QR باستخدام تطبيق ضريبة القيمة المضافة التابع لها. يقرأ التطبيق المعلومات الموجودة داخل الرمز ويعرض نتائج التحقق.

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

تشرح ZATCA طريقة المسح في القسم 11 من الإرشادات التفصيلية للفوترة الإلكترونية.

افحص حقول TLV

يمكنك أيضًا استخدام أداة لفك ترميز TLV تدعم تنسيق رمز QR المعتمد لدى ZATCA. تتيح لك هذه الطريقة الاطلاع على الحقول المضمنة في الرمز وأرقامها.

اتبع الخطوات التالية:

1. افتح فاتورة أنشأها مكوّن WooCommerce الحالي.
2. امسح رمز QR أو أدخل قيمته المشفرة في أداة تدعم فك ترميز TLV.
3. راجع أرقام الوسوم والبيانات التي تعرضها الأداة.
4. تحقق من أن الوسوم من 1 إلى 5 تحتوي على بيانات البائع والفاتورة.
5. ابحث عن الحقول الإضافية المطلوبة للمرحلة الثانية، بدءًا من الوسم 6.
6. إذا كانت الفاتورة ضريبية مبسطة ضمن المرحلة الثانية، فتحقق من وجود الوسوم 7 و8 و9 أيضًا.

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

إذا وجدت الوسوم التسعة، فقد تحققت من بنية الحقول الموجودة في الرمز. لكنك لم تتحقق بعد من صحة ملف XML الموقع أو من وصول الفاتورة إلى ZATCA.

تتيح أداة فك الترميز قراءة محتوى رمز QR. ولا يمكنها وحدها إثبات الحالة الكاملة لنظام الفوترة أو استيفاء جميع متطلبات الربط.

يحتاج متجر WooCommerce إلى نظام فوترة مرتبط بالهيئة

يسجل WooCommerce بيانات البيع والدفع والعميل. ويجب أن يحول مكوّن الفوترة الإلكترونية هذه البيانات إلى المستندات التي تتطلبها ZATCA.

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

تحتاج الطلبات المدفوعة إلى فواتير إلكترونية

ينشئ مكوّن رصيدو للفوترة الإلكترونية السعودية لـ WooCommerce فاتورة ضريبية مبسطة لكل طلب مدفوع بعملة الريال السعودي (SAR)، بعد ربط المتجر وتفعيل خيار "إصدار الفواتير الإلكترونية". ويتجاوز الطلبات بعملات أخرى، مع إضافة ملاحظة إلى الطلب وتنبيه في صحة الموقع (Site Health).

ينشئ المكوّن ملف XML وفق معيار UBL 2.1 ويوقعه باستخدام شهادة المتجر، ثم يولد رمز QR. ويُرسل المستند إلى ZATCA في الخلفية باستخدام Action Scheduler الخاص بـ WooCommerce.

يحمل كل مستند عداد الفواتير (ICV) وبصمة الفاتورة السابقة (PIH). وينشئ رصيدو المستندات واحدًا تلو الآخر حتى لا تؤثر عمليات الدفع المتزامنة في تسلسل الفواتير.

تُحفظ ملفات XML الموقعة واستجابات ZATCA على موقع WordPress الخاص بمتجرك. ويمكن الرجوع إليها من سجلات الفوترة الإلكترونية.

تحتاج حالات فشل الإبلاغ إلى متابعة

قد تُنشأ الفاتورة أثناء تعذر الاتصال بخدمات ZATCA. ويمكن أن يحدث ذلك نتيجة مشكلة في الشبكة أو توقف مؤقت لخدمات الهيئة.

يعيد رصيدو محاولة الإبلاغ عند حدوث هذه المشكلات. وتستمر المحاولات لعدة ساعات ضمن مهلة الإبلاغ المحددة بـ 24 ساعة.

إذا أصبحت حالة المستند مرفوضة لدى ZATCA، يعرض رصيدو أسباب الرفض في تبويب الفواتير الإلكترونية، ويضيف ملاحظة إلى طلب WooCommerce.

يمكنك مراجعة هذه السجلات لمعرفة حالة المستند. وهي توفر معلومات عن الإبلاغ لا يمكن استنتاجها من رمز QR الموجود على فاتورة العميل.

يحتاج العملاء إلى فواتير مقروءة

يحصل عملاؤك على صفحة فاتورة باللغتين العربية والإنجليزية تتضمن رمز QR. ويضيف رصيدو رابط الصفحة إلى تفاصيل الطلب ورسائل البريد الإلكتروني المتعلقة به.

تُفتح صفحة الفاتورة باستخدام مفتاح الطلب. ويمكنك الاطلاع على تفاصيل المستند الذي يظهر للعميل في صفحة ميزة الفواتير العربية.

يعتمد موعد الربط على الموجة المحددة لمنشأتك

تطبق ZATCA المرحلة الثانية (الربط والتكامل) على موجات متتابعة من المكلفين. ولذلك يختلف موعد الربط بحسب الموجة التي تشمل المنشأة.

أعلنت الهيئة في 24 يوليو 2026 عن الموجة 25. وتشمل المكلفين الذين تجاوزت إيراداتهم الخاضعة لضريبة القيمة المضافة 187,500 ريال سعودي في أي سنة من السنوات التالية:

• 2022
• 2023
• 2024
• 2025

حددت ZATCA يوم 1 فبراير 2027 موعدًا نهائيًا للربط ضمن الموجة 25. وتوضح الهيئة أنها تُشعر المكلفين المستهدفين قبل موعد الربط بستة أشهر على الأقل.

المصدر: إعلان ZATCA عن الموجة 25.

إذا تلقت منشأتك إشعارًا بالدخول في المرحلة الثانية (الربط والتكامل)، فاعتمد الموعد المحدد لها عند التخطيط للتغيير. وجود رمز QR من المرحلة الأولى (الإصدار) لا يمدد مهلة الربط.

افحص فواتيرك وابدأ ربط المتجر

ابدأ بفحص فاتورة ضريبية مبسطة حديثة. تحقق من حقول رمز QR، ومن إنشاء ملف XML موقع، ومن اتصال نظام الفوترة بمنصة فاتورة.

لإعداد رصيدو، أدخل بيانات منشأتك من خلال WooCommerce > الفوترة الإلكترونية (ZATCA)، ثم افتح تبويب بيانات البائع. تشمل البيانات الاسم القانوني، والرقم الضريبي المكوّن من 15 رقمًا، ورقم السجل التجاري، والرمز المختصر للعنوان الوطني، والفرع.

يبدأ رصيدو في بيئة الاختبار، التي لا تتطلب رمز التحقق (OTP) من بوابة فاتورة، وتصدر مستندات اختبارية فقط. من تبويب بيانات البائع، غيّر حقل البيئة إلى بيئة الإنتاج لإصدار فواتير فعلية، أو إلى بيئة المحاكاة لإجراء تجربة. بعد ذلك أنشئ رمز التحقق (OTP) المكوّن من 6 أرقام عبر بوابة فاتورة على fatoora.zatca.gov.sa. وتبلغ صلاحية الرمز ساعة واحدة.

أدخل الرمز في تبويب «الربط» داخل رصيدو. ينشئ المكوّن المفتاح وطلب الشهادة، ويحصل على شهادة الامتثال، ويجتاز اختبارات الامتثال الستة، ثم يطلب شهادة الإنتاج.

بعد اكتمال ربط المتجر، فعّل خيار "إصدار الفواتير الإلكترونية" لبدء إصدار المستندات. يوضح دليل إعداد رصيدو خطوات ربط متجر WooCommerce.