ربط شمس مع WooCommerce (ووردبريس)

1. إنشاء مفاتيح API من WooCommerce

1. افتح لوحة تحكم ووردبريس → WooCommerce → الإعدادات → متقدم → REST API.

2. اضغط على إضافة مفتاح جديد.

3. اختر اسم للمفتاح (مثلاً: Shams Integration).

4. حدد المستخدم المسؤول عن المتجر.

5. في الأذونات اختر: قراءة/كتابة.

6. اضغط إنشاء مفتاح API.

7. انسخ:

   • مفتاح المستهلك (Consumer Key)

   • سر المستهلك (Consumer Secret)

2. إدخال بيانات API في شمس

1. افتح تطبيق شمس → الإعدادات → WooCommerce.

2. ألصق مفتاح المستهلك و سر المستهلك في الحقول المخصصة.

3. ضع رابط متجرك مثل:

   • https://www.mystore.com

   • أو http://www.mystore.com
     📌 مهم: لازم تبدأ بـ http أو https.

4. اختر فرع النشاط الذي تريد ربطه بالمتجر (كل مزامنة تعمل مع فرع واحد فقط).

3. تفعيل المزامنة التلقائية (اختياري)

• إذا فعّلت المزامنة التلقائية:

  • المنتجات والفئات تتحدث تلقائياً كل ليلة.

  • يمكن تغيير التوقيت (لكن كلما زادت المزامنات = زاد الحمل على الخادم).

• للتشغيل: لازم تضيف مهمة مجدولة (Cron Job) في الاستضافة.

4. مزامنة البيانات مع WooCommerce

من قائمة WooCommerce داخل شمس، يمكنك:

• مزامنة الفئات: ينقل الفئات من شمس إلى WooCommerce.

• ربط الضرائب: يربط الضرائب بين النظامين.

• مزامنة المنتجات:

  • خيار 1: مزامنة المنتجات الجديدة فقط.

  • خيار 2: مزامنة الكل (إنشاء + تحديث).
    ⏳ ملاحظة: إذا عندك منتجات كثيرة ممكن تأخذ المزامنة وقت طويل (حتى 30 دقيقة).

• مزامنة الطلبات: ينقل الطلبات الجديدة من المتجر إلى شمس ويصنفها حسب حالتها.

5. ملاحظات مهمة

• المنتجات المجمعة (Combo) لا تتم مزامنتها.

• إذا الطلب ذهب إلى مسودة في شمس:

  • غالبًا المخزون غير كافي.

  • أو أن حالة الطلب في WooCommerce تم ربطها كمسودة (مثال: pending).

• الصور أحيانًا لا تنتقل → الحل تغيير صيغة الصور إلى jpg أو png وأسماء ملفات قصيرة.

• إذا واجهت خطأ في المزامنة:

  • تأكد من أن رابط متجرك صحيح (http/https).

  • تأكد من تفعيل صلاحيات القراءة/الكتابة للمستخدم.

  • تحقق أن Permalinks في ووردبريس مضبوط على "Post Name".

6. Webhook لمزامنة الطلبات مباشرة

إذا تريد الطلبات تنتقل إلى شمس فوراً بدون انتظار:

1. في WooCommerce افتح: الإعدادات → API → Webhooks.

2. أنشئ Webhook جديد واختر:

   • الحالة: نشط

   • الموضوع: Order Created (أو Order Updated … إلخ)

   • رابط التسليم: انسخه من شمس والصقه هنا.

   • الإصدار: WP REST API v2

3. احفظ التغييرات.
   الآن أي طلب جديد يظهر مباشرة في شمس.

📌 باختصار:

• أنشئ API من WooCommerce.

• أدخل المفتاح والسر في شمس + رابط المتجر.

• اختر فرع النشاط.

• فعّل المزامنة (يدوي أو تلقائي).

• تأكد من الضرائب والصور.