دليل إستخدام إضافة ربط المتجر مع هيئة الزكاة والضريبة السعودية

 المتطلبات الأساسية

1️⃣ المتطلبات التقنية

• WordPress: الإصدار 5.0 أو أحدث
• WooCommerce: الإصدار 4.0 أو أحدث
• PHP: الإصدار 7.4 أو أحدث
• اتصال إنترنت مستقر: للتواصل مع خوادم ZATCA
• شهادة SSL: يجب أن يكون الموقع محميًا (HTTPS)

2️⃣ المتطلبات التجارية والنظامية

⚠️ تحذير: يجب أن تكون منشأتك مسجلة لدى هيئة الزكاة قبل البدء!

• الرقم الضريبي (VAT Number): رقم التعريف الضريبي المكون من 15 رقمًا
• السجل التجاري: سجل تجاري معتمد من وزارة التجارة
• حساب على بوابة فاتورة: fatoora.zatca.gov.sa
• بيانات العنوان الكامل: الشارع، الحي، رقم المبنى، الرمز البريدي، المدينة

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

1 الحصول على الإضافة

1. قم بزيارة الموقع الرسمي: wooarab.com/zatca-integration-woocommerce
2. اشتر الإضافة وقم بتنزيل ملف ZIP
3. احتفظ برخصة الإضافة (License Key) في مكان آمن

2 رفع الإضافة إلى ووردبريس

ووردبريس > إضافات > أضف جديد > رفع إضافة > اختر ملف ZIP > التنصيب الآن > تفعيل

1. من لوحة تحكم ووردبريس، انتقل إلى إضافات > أضف جديد
2. اضغط على زر رفع إضافة في أعلى الصفحة
3. اختر ملف ZIP الذي قمت بتنزيله
4. اضغط على التنصيب الآن
5. بعد اكتمال التنصيب، اضغط على تفعيل الإضافة

✅ تم التثبيت بنجاح! ستظهر الآن قائمة جديدة باسم “الربط مع ZATCA” في الشريط الجانبي.

🔑 تفعيل الرخصة

⚠️ مهم جداً: يجب تفعيل الرخصة قبل المتابعة في إعداد الربط مع ZATCA. الإضافة لن تعمل بدون رخصة صالحة!

1 الوصول إلى صفحة الترخيص

من القائمة الجانبية، انتقل إلى: الربط مع ZATCA > ترخيص ZATCA

2 خطوات التفعيل

1. أدخل مفتاح الترخيص: الصق مفتاح الترخيص الذي حصلت عليه من عملية الشراء
2. اضغط على “تفعيل الرخصة”: انتظر حتى تكتمل عملية التفعيل
3. تحقق من الحالة: يجب أن تظهر رسالة تأكيد

📊 حالات الرخصة

🏢 إعداد معلومات المؤسسة

الوصول إلى إعدادات الربط

الربط مع ZATCA > إعدادات الربط

📝 الحقول الإلزامية

جميع الحقول المشار إليها بعلامة * إلزامية ويجب ملؤها بشكل صحيح.

البيانات الأساسية

• اسم المؤسسة إلزامي
  اسم منشأتك كما هو مسجل في السجل التجاري
  مثال: شركة التجارة الإلكترونية المحدودة
• الرقم الضريبي إلزامي
  رقم التعريف الضريبي المكون من 15 رقمًا
  مثال: 300000000000003
• رقم السجل التجاري (CRN) إلزامي
  رقم السجل التجاري الخاص بمنشأتك
  مثال: 111111113
• الفرع إلزامي
  اسم الفرع الرئيسي لمتجرك
  مثال: فرع الرياض

معلومات العنوان

• التصنيف إلزامي
  نوع النشاط التجاري
  مثال: Medical, Retail, Technology
• الشارع إلزامي
  اسم الشارع الذي يقع فيه مقر عملك
  مثال: شارع الملك فهد
• الرمز البريدي إلزامي
  5 أرقام بالضبط
  مثال: 12345
• رقم المبنى إلزامي
  4 أرقام بالضبط
  مثال: 1001
• المدينة إلزامي
  مثال: الرياض، جدة، الدمام
• المنطقة إلزامي
  مثال: الرياض، العليا، الملقا

💡 نصيحة: تأكد من صحة جميع البيانات المدخلة قبل الحفظ. أي خطأ قد يؤدي إلى فشل عملية الربط مع منصة فاتورة.

🔗 إعدادات الربط والفواتير

اختيار البيئة

تقدم الإضافة نوعين من البيئات:

إعدادت ارسال الفواتير

• أضغط على تفعيل لتفعيل إرسال الفواتير تلقائيا
• أختر حالة الطلب التي تريد إرسال الفواتير عندها (يوصى بإختبار الحالة التي يكون المستخدم قد دفع المبلغ واستلم المنتج بالفعل – في العادة حالة الطلب مكتمل Completed)
• يمكنك أيضا تفعيل إظهار فواتير XML للمستخدم في حسابها وكذلك في بريد إكمال الطلب.
• كما يمكنك أيضا تفعيل إرسال الإشعارات الدائنة Credit Note عند عمل إسترداد Refund للطلب.

الربط مع منصة فاتورة

بعد إكمال بيانات المؤسسة في الإعدادات العامة وضبط إعدادات الفواتير والربط، الآن نأتي لخطوة ربط المتجر مع منصة فاتورة.

يجب عليك أولا الحصول على رمز OTP من منصة فاتورة وفق الخطوات التالية:

🔐 الحصول على رمز OTP

⏰ تحذير: رمز OTP صالح لمدة ساعة واحدة فقط! تأكد من استخدامه مباشرة بعد الحصول عليه.

خطوات الحصول على OTP من بوابة فاتورة:

1. افتح متصفح الإنترنت وانتقل إلى: fatoora.zatca.gov.sa
2. سجّل دخولك بحسابك الحكومي
3. اضغط على “تهيئة وحدة/جهاز جديد”
4. اضغط على “إنشاء رمز تفعيل”
5. حدد عدد رموز OTP (عادة 1 رمز)
6. أكد أنك لست برنامج روبوت (CAPTCHA)
7. انسخ الرمز فوراً واحفظه في مكان آمن

إدخال رمز OTP في الإضافة:

1. ارجع إلى لوحة تحكم ووردبريس
2. انتقل إلى الربط مع ZATCA > إلربط مع ZATCA
3. في قسم رمز التحقق (OTP)، الصق الرمز
4. اضغط على حفظ أو بدء عملية الربط