شرح الفرق بين بيئة الاختبار وبيئة المحاكاة وبيئة الإنتاج في فاتورة

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

مقارنة بيئات فاتورة الثلاث

توفر هيئة الزكاة والضريبة والجمارك (ZATCA) بيئات منفصلة لتطوير أنظمة الفوترة الإلكترونية واختبارها وتشغيلها. ولكل بيئة غرض مختلف، رغم تشابه تنسيق الفواتير وإجراءات الربط بينها.

الفرق الأساسي هو بين اختبار الربط وإصدار فاتورة ضريبية فعلية. نجاح إرسال مستند تجريبي لا يعني أن فاتورة ضريبية قد صدرت نظاميًا.

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

بيئة الاختبار مخصصة للتجربة الأولية للربط

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

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

طريقة ربط رصيدو ببيئة الاختبار

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

تبدأ عملية الربط بإنشاء مفتاح التوقيع وطلب الشهادة. بعد ذلك، يتصل رصيدو ببيئة ZATCA التي اخترتها.

يدعم رصيدو العمليات التالية على المستندات:

• إنشاء الفواتير بتنسيق XML وفق معيار UBL 2.1.
• تطبيق التوقيع الرقمي على المستند.
• إنشاء رمز QR.
• إرسال المستندات عبر واجهة API الخاصة بمنصة فاتورة.
• إنشاء إشعارات دائنة عند رد مبالغ الطلبات.

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

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

بيئة المحاكاة تستخدم هويتك الضريبية المسجلة

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

بخلاف بيئة الاختبار، تستخدم بيئة المحاكاة هوية نشاطك التجاري. وبخلاف بيئة الإنتاج، فإن المستندات المرسلة إليها لا تُعد فواتير ضريبية صادرة نظاميًا.

الحصول على رمز التحقق (OTP) لبيئة المحاكاة

افتح fatoora.zatca.gov.sa وادخل إلى بوابة فاتورة الخاصة ببيئة المحاكاة باستخدام حساب المكلف.

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

1. افتح بوابة فاتورة لبيئة المحاكاة.
2. اختر إضافة وحدة أو جهاز جديد للربط.
3. أنشئ رمز تحقق (OTP) مكونًا من 6 أرقام.
4. اختر بيئة المحاكاة في إعدادات رصيدو.
5. الصق رمز التحقق (OTP) في تبويب «الربط».
6. ابدأ الربط قبل انتهاء صلاحية الرمز.

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

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

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

ما ينبغي التحقق منه في بيئة المحاكاة

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

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

إذا رفضت ZATCA أحد المستندات، راجع سبب الرفض من WooCommerce > الفوترة الإلكترونية (ZATCA) > الفواتير الإلكترونية. تساعدك بيئة المحاكاة على اكتشاف هذه المشكلات قبل إرسال المستندات الفعلية.

بيئة الإنتاج مخصصة للفواتير الضريبية الفعلية

تُستخدم بيئة الإنتاج عندما يصبح متجرك مستعدًا لإصدار الفواتير وفق متطلبات المرحلة الثانية (الربط والتكامل) لدى ZATCA.

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

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

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

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

تشرح ZATCA متطلبات المرحلة الثانية (الربط والتكامل) في صفحة الفوترة الإلكترونية.

موعد الربط المحدد للموجة 25

تشمل الموجة 25 المنشآت التي تجاوزت إيراداتها الخاضعة لضريبة القيمة المضافة 187,500 ريال سعودي في أي سنة من السنوات 2022 أو 2023 أو 2024 أو 2025. ويجب على هذه المنشآت إكمال الربط مع منصة فاتورة بحلول 1 فبراير 2027.

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

المصدر: إعلان ZATCA عن الموجة 25 بتاريخ 24 يوليو 2026.

الترتيب المقترح لاختبار متجر WooCommerce

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

الخطوة 1. تجهيز المتجر

يتطلب رصيدو WordPress بإصدار 6.5 أو أحدث، وPHP بإصدار 8.1 أو أحدث، مع تفعيل WooCommerce.

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

الخطوة 2. البدء ببيئة الاختبار

اختر بيئة الاختبار وأكمل إجراءات الربط الأولية باستخدام رمز التحقق (OTP) التجريبي. فعّل خيار «إصدار الفواتير الإلكترونية» لاختبار الطلبات المدفوعة في بيئة الاختبار. راجع الفواتير الناتجة وأي استجابات واردة من ZATCA.

الخطوة 3. التجربة في بيئة المحاكاة

اختر بيئة المحاكاة واربط المتجر باستخدام رمز تحقق (OTP) جديد من بوابة المحاكاة. فعّل خيار «إصدار الفواتير الإلكترونية» لاختبار الطلبات المدفوعة في بيئة المحاكاة. راجع فواتير الطلبات المدفوعة، والإشعارات الدائنة الناتجة عن الاسترداد، وبيانات البائع الواردة في المستندات.

الخطوة 4. الربط ببيئة الإنتاج

اختر بيئة الإنتاج وأنشئ رمز تحقق (OTP) جديدًا من بوابة فاتورة الخاصة ببيئة الإنتاج. أكمل إجراءات الربط لهذه البيئة.

لا تفعّل خيار «إصدار الفواتير الإلكترونية» في بيئة الإنتاج إلا عندما يصبح متجرك مستعدًا لإصدار الفواتير الفعلية للطلبات المدفوعة.

قائمة التحقق قبل التشغيل

• إصدارات WordPress وPHP وWooCommerce تستوفي متطلبات رصيدو.
• الاسم القانوني للبائع صحيح.
• الرقم الضريبي مكون من 15 رقمًا ويبدأ وينتهي بالرقم 3.
• اكتملت حقول بيانات البائع الـ11: الاسم القانوني للبائع، والرقم الضريبي، ورقم هوية البائع (عادةً رقم السجل التجاري)، والشارع، ورقم المبنى، والحي، والمدينة، والرمز البريدي، والرمز المختصر للعنوان الوطني، واسم الفرع، ونشاط المنشأة. لن يبدأ ربط المتجر في أي بيئة، بما فيها بيئة الاختبار، قبل اكتمالها.
• اكتملت الاختبارات في بيئة الاختبار.
• اكتمل الربط واختبار المستندات في بيئة المحاكاة إذا اخترت استخدام هذه البيئة الاختيارية التي يُنصح بها قبل التشغيل الفعلي.
• استُخدم رمز تحقق (OTP) جديد خاص ببيئة الإنتاج.
• تم الحصول على شهادة الإنتاج.
• تم تفعيل «إصدار الفواتير الإلكترونية» لاختبار الطلبات المدفوعة في بيئة الاختبار وبيئة المحاكاة، ولا يُفعّل في بيئة الإنتاج إلا عندما يصبح المتجر جاهزًا لإصدار الفواتير الفعلية.
• تمت مراجعة نتائج الإرسال في تبويب الفواتير الإلكترونية.

لمعرفة خطوات إعداد الإضافة، راجع دليل إعداد رصيدو.

أخطاء شائعة أثناء ربط المتجر

استخدام رمز تحقق خاص ببيئة الإنتاج في بيئة المحاكاة

تعمل بيئة المحاكاة وبيئة الإنتاج بإجراءات ربط مستقلة. لذلك لا تستخدم رمز تحقق (OTP) صادرًا لبيئة الإنتاج عند ربط المتجر ببيئة المحاكاة.

تحقق من البيئة المحددة في رصيدو قبل إنشاء الرمز. ثم أنشئ رمز التحقق (OTP) من بوابة فاتورة المطابقة لتلك البيئة.

استخدام رمز تحقق منتهي الصلاحية

تبلغ صلاحية رمز التحقق (OTP) في بوابة فاتورة ساعة واحدة. إذا انتهت صلاحيته، أنشئ رمزًا جديدًا وأعد إجراءات الربط.

لا تكرر إرسال الرمز القديم بعد انتهاء مدة صلاحيته.

إدخال بيانات بائع غير صحيحة

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

راجع تبويب بيانات البائع قبل طلب رمز تحقق (OTP) جديد. وإذا أعادت ZATCA رسالة خطأ، فاقرأ الاستجابة قبل تكرار الطلب.

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

المستندات الصادرة في بيئة الاختبار وبيئة المحاكاة مخصصة للتجربة. ولا يمكن استخدامها بدلًا من الفواتير التي يجب إصدارها في بيئة الإنتاج.

انتبه إلى هذا الفرق عند مراجعة الطلبات التجريبية. وجود ملف XML أو توقيع رقمي أو رمز QR لا يغير البيئة التي أُنشئ فيها المستند.

مراجعة سجلات بيئة الإنتاج بعد الربط

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

تعرض صحة الموقع (Site Health) أيضًا تنبيهات عند تفعيل الفوترة الإلكترونية دون إكمال ربط المتجر، أو عند تأخر المستندات مدة أطول من المحدد، أو عند اقتراب انتهاء صلاحية الشهادة.

ينبه رصيدو قبل انتهاء صلاحية الشهادة بـ30 يومًا. ويتطلب تجديدها إعادة ربط المتجر باستخدام رمز تحقق (OTP) جديد. ولا تتأثر الفواتير الصادرة سابقًا بالتغييرات التي تطرأ على مفاتيح الربط المخزنة.