إعداد ربط WooCommerce مع منصة فاتورة

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

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

قبل البدء

جهّز موقع WordPress وبيانات منشأتك قبل الربط مع ZATCA. تأكد من توفر المتطلبات التالية:

1. تحقق من أن موقعك يعمل بإصدار WordPress 6.5 أو أحدث، وإصدار PHP 8.1 أو أحدث. يجب أن تكون إضافة WooCommerce مثبتة ومفعلة.

2. جهّز الرقم الضريبي السعودي لمنشأتك. يجب أن يتكون من 15 رقمًا، وأن يبدأ بالرقم 3 وينتهي به.

3. اجمع الاسم القانوني المسجل ورقم السجل التجاري والرمز المختصر للعنوان الوطني وبيانات الفرع. ستدخل هذه المعلومات في قسم بيانات البائع.

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

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

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

تثبيت الإضافة

ثبّت النسخة المجانية من خلال لوحة تحكم WordPress. اتبع الخطوات التالية:

1. نزّل ملف ZIP الخاص بإضافة رصيدو باستخدام الزر الموجود أدناه.

2. سجّل الدخول إلى WordPress بصلاحية مدير. افتح إضافات > أضف إضافة جديدة > رفع إضافة.

3. اختر ملف ZIP الذي نزّلته. اضغط على التنصيب الآن، ثم فعّل الإضافة.

4. افتح WooCommerce > الفوترة الإلكترونية (ZATCA). ستجد 3 علامات تبويب: بيانات البائع، ربط المتجر، والفواتير الإلكترونية.

تظهر شاشات الإعداد بالعربية عندما تكون لغة الموقع أو لغة المستخدم في WordPress هي العربية. ويمكن تثبيت برو إلى جانب الإضافة المجانية، لكن عليك إكمال إعداد الإضافة المجانية قبل استخدام ميزات B2B في برو.

إدخال بيانات البائع

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

1. الاسم القانوني: أدخل الاسم المسجل لمنشأتك. يُوصى بكتابته بالعربية لأنه يظهر في الفاتورة ورمز QR.

2. الرقم الضريبي: انسخ الرقم المكون من 15 رقمًا من شهادة التسجيل في ضريبة القيمة المضافة. تحقق من أن الرقم الأول والأخير هما 3.

3. السجل التجاري: أدخل رقم السجل التجاري الخاص بمنشأتك كما يظهر في سجلها الرسمي.

4. العنوان الوطني: أدخل الرمز المختصر من خدمة العنوان الوطني السعودي. استخدم بيانات العنوان المسجلة لمنشأتك.

5. الفرع: أدخل بيانات فرع المنشأة الذي سيصدر الفواتير.

6. البيئة: اختر بيئة الاختبار لإجراء أول تجربة. ويمكنك تغييرها لاحقًا إلى بيئة المحاكاة أو بيئة الإنتاج عندما تصبح مستعدًا للمرحلة التالية.

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

تستخدم الإضافة بيانات البائع عند إنشاء مستندات XML بتنسيق UBL 2.1. ويحمل كل مستند أيضًا عداد الفواتير (ICV) وتجزئة الفاتورة السابقة (PIH).

تجربة الإضافة في بيئة الاختبار

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

1. افتح علامة تبويب ربط المتجر، وتأكد من اختيار بيئة الاختبار.

2. ابحث عن حقل رمز التحقق (OTP). تملأ رصيدو رمز الاختبار تلقائيًا.

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

4. بعد اكتمال ربط المتجر، فعّل خيار إصدار الفواتير الإلكترونية.

5. أنشئ طلبًا تجريبيًا في WooCommerce وغيّر حالته إلى مدفوع. افتح علامة تبويب الفواتير الإلكترونية لفحص المستند ورد ZATCA عليه.

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

يتضمن ملف XML بيانات البائع والمبالغ والتوقيع الرقمي. ويحتوي رمز QR على اسم البائع والرقم الضريبي والتاريخ والوقت وإجمالي الفاتورة ومبلغ الضريبة وتجزئة الفاتورة والتوقيع الرقمي.

يمكنك تكرار الاختبار قبل الانتقال إلى بيئة المحاكاة.

الحصول على رمز التحقق من بوابة فاتورة

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

1. افتح بوابة فاتورة وسجّل الدخول باستخدام حساب المكلف.

2. اختر الإجراء الخاص بربط وحدة جديدة من نظام الفوترة الإلكترونية.

3. أنشئ رمز التحقق (OTP) المكون من 6 أرقام. يكون الرمز صالحًا لمدة ساعة واحدة.

4. ارجع إلى WooCommerce > الفوترة الإلكترونية (ZATCA) > ربط المتجر. تأكد من أن البيئة المحددة هي البيئة التي تجري الربط لها.

5. الصق رمز التحقق (OTP)، ثم اضغط على اربط هذا المتجر.

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

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

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

الانتقال إلى بيئة المحاكاة ثم بيئة الإنتاج

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

1. غيّر البيئة إلى بيئة المحاكاة من قسم بيانات البائع. استخدم الرقم الضريبي الخاص بمنشأتك.

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

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

4. عندما تصبح مستعدًا لإصدار الفواتير الفعلية، غيّر البيئة إلى بيئة الإنتاج.

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

في بيئة الإنتاج، يجب الإبلاغ عن الفواتير الضريبية المبسطة إلى ZATCA خلال 24 ساعة. ترسلها رصيدو في الخلفية باستخدام Action Scheduler.

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

متابعة المتجر بعد بدء التشغيل

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

1. افتح WooCommerce > الفوترة الإلكترونية (ZATCA) > الفواتير الإلكترونية. راجع المستندات الصادرة وعمليات الإرسال المعلقة وردود ZATCA.

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

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

4. جدّد الشهادة التي تقترب من الانتهاء بإكمال ربط المتجر مرة أخرى باستخدام رمز تحقق (OTP) جديد.

5. حافظ على ثبات قيمتي AUTH_KEY وSECURE_AUTH_KEY في WordPress. تستخدمهما رصيدو لتشفير الشهادات والمفاتيح الخاصة. إذا تغيرتا، فعليك ربط المتجر مرة أخرى. لا تتأثر الفواتير التي سبق إصدارها.

6. احتفظ بملفات XML الموقعة وردود ZATCA ضمن سجلات متجرك. تخزنها رصيدو على موقع WordPress الخاص بك، وتحتفظ بها بعد إزالة الإضافة ما لم تختر صراحةً حذف جميع البيانات.

إذا واجهت مشكلة في رمز التحقق (OTP) أو المستندات المعلقة أو الفواتير المرفوضة، فراجع دليل معالجة المشكلات.

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