تكامل WooCommerce

يتيح لكم تكامل WooCommerce ربط متجركم الإلكتروني WooCommerce بـ Gem Logic. بمجرد الربط، يمكنكم نقل المنتجات من Gem Logic إلى متجركم على WooCommerce وسحب الطلبات من WooCommerce إلى Gem Logic. يحافظ هذا على تزامن كتالوج المنتجات وإدارة الطلبات عبر المنصتين.

الإعدادات

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

قبل ربط WooCommerce بـ Gem Logic، تحتاجون إلى إنشاء مفاتيح API في متجركم على WooCommerce.

1. سجّلوا الدخول إلى لوحة إدارة WordPress الخاصة بكم.

2. انتقلوا إلى WooCommerce ‣ Settings ‣ Advanced ‣ REST API.

3. انقروا على Add key.

4. املأوا التفاصيل:

   • Description: أدخلوا اسماً لتحديد هذا المفتاح (مثل Gem Logic Integration).

   • User: اختاروا مستخدم WordPress الذي سيُستخدم لاتصال API.

   • Permissions: اختاروا Read/Write. هذا مطلوب حتى يتمكن Gem Logic من قراءة الطلبات وإنشاء/تحديث المنتجات في متجركم.

5. انقروا على Generate API key.

6. انسخوا Consumer key و Consumer secret. ستُعرض مرة واحدة فقط، لذا احفظوها في مكان آمن.

مهم

يُعرض consumer secret مرة واحدة فقط. إذا فقدتموه، ستحتاجون إلى إلغاء المفتاح وإنشاء واحد جديد.

ربط WooCommerce بـ Gem Logic

1. في Gem Logic، انتقل إلى Configuration ‣ Sales channels.

2. افتح قناة البيع التي تريد ربطها بـ WooCommerce، أو أنشئ قناة جديدة.

3. فعّل خانة الاختيار WooCommerce.

4. املأوا الحقول التالية:

   • URL: عنوان URL الكامل لمتجر WooCommerce الخاص بكم (مثل https://www.yourstore.com). لا تُدرجوا شرطة مائلة في النهاية.

   • WooCommerce Key: الصق Consumer key الذي أنشأتموه سابقاً.

   • WooCommerce Secret: الصق Consumer secret الذي أنشأتموه سابقاً.

5. إذا كنتم تستخدمون إضافة Perfect WooCommerce Brands في متجر WooCommerce الخاص بكم، فعّلوا خانة الاختيار WooCommerce brands plugin. يتيح ذلك لـ Gem Logic مزامنة علامات المنتجات التجارية مع WooCommerce.

6. احفظوا قناة البيع.

نصيحة

تأكدوا من أن متجر WooCommerce الخاص بكم يستخدم HTTPS. يتم تشفير بيانات اعتماد API وتخزينها بشكل آمن في Gem Logic.

تعيين المنتجات لقناة البيع

لإرسال المنتجات إلى WooCommerce، يجب تعيينها لقناة بيع WooCommerce.

1. انتقل إلى Products.

2. افتح منتجاً وانتقل إلى قسم sales channels الخاص به.

3. أضف قناة بيع WooCommerce إلى المنتج.

4. تأكدوا من أن المنتج لديه pricing rule مُهيّأة لقناة البيع هذه، بحيث يكون له سعر عند إرساله إلى WooCommerce.

إرسال المنتجات

يمكنكم إرسال المنتجات من Gem Logic إلى متجر WooCommerce الخاص بكم. ينشئ ذلك المنتجات أو يحدّثها في WooCommerce بناءً على البيانات الموجودة في Gem Logic.

إرسال منتج واحد

لإرسال منتج واحد، افتح المنتج في Gem Logic واستخدم إجراء الإرسال من قسم قنوات البيع الخاص بالمنتج. سيتم إنشاء المنتج في WooCommerce إذا لم يكن موجوداً بعد، أو تحديثه إذا كان لديه بالفعل معرّف WooCommerce.

إرسال جميع المنتجات

لإرسال جميع المنتجات المعيّنة لقناة بيع WooCommerce دفعة واحدة:

1. انتقل إلى Configuration ‣ Sales channels.

2. افتح قناة بيع WooCommerce.

3. انقر على إرسال جميع المنتجات إلى WooCommerce.

يتم تشغيل ذلك كمهمة في الخلفية. يمكنكم متابعة التقدّم في صفحة سجل الإرسال.

ما الذي يتم إرساله

عند إرسال منتج إلى WooCommerce، يتم مزامنة البيانات التالية:

• SKU (يُستخدم لمطابقة المنتجات بين النظامين)

• الاسم و**الوصف** (بناءً على لغة قناة البيع)

• السعر العادي و**سعر التخفيض** (من قاعدة التسعير لقناة البيع هذه)

• الصور (يُعاد رفعها فقط عند حدوث تغييرات)

• الفئات و**المجموعات** (تُنشأ في WooCommerce إذا لم تكن موجودة)

• السمات (تُنشأ كسمات WooCommerce عامة)

• علامات

• كمية المخزون

• العلامات التجارية (إذا كان إضافة WooCommerce brands مُفعَّلاً)

• نوع المنتج: بسيط أو متغيّر (مع تنويعات)

المنتجات المتغيّرة والتنويعات

إذا كان المنتج في Gem Logic مُحدَّداً كـ منتج أصلي، يُدفع كمنتج متغيّر في WooCommerce. جميع المنتجات الفرعية (التنويعات) تُدفع كتنويعات منتج. يتضمّن كل تنويع سعره الخاص، ورقم SKU، وصورته، وقيم السمات (مثل الحجم واللون).

إلغاء تفعيل المنتج

يمكنكم إلغاء تفعيل منتج في WooCommerce من Gem Logic. هذا يضبط حالة المنتج على مسودة في WooCommerce، ما يجعله غير مرئي في الواجهة دون حذفه.

سجل الدفع

تُسجَّل كل عملية دفع. يمكنكم الاطلاع على سجل الدفع من صفحة تفاصيل قناة البيع. يعرض كل سجل:

• وقت البدء والانتهاء

• الحالة (بدأت، اكتملت، فشلت، أو نجاح جزئي)

• إجمالي المنتجات، وأعداد الناجحة والفاشلة

• نسبة النجاح والمدة

• النتائج التفصيلية لكل منتج (اضغطوا على عرض التفاصيل لمعرفة أي المنتجات نجحت أو فشلت)

سحب المنتجات

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

1. انتقل إلى Configuration ‣ Sales channels.

2. افتح قناة بيع WooCommerce.

3. اضغطوا على سحب المنتجات من WooCommerce.

يعمل هذا كمهمة في الخلفية ويستورد البيانات التالية لكل منتج:

• SKU، والاسم، والوصف

• السعر العادي وسعر التخفيض

• الفئات والعلامات التجارية

• الصور (تُحمَّل وتُخزَّن في Gem Logic)

• العلامات

• كميات المخزون

• السمات والمعادن

• تنويعات المنتج (للمنتجات المتغيّرة)

ملاحظة

المنتجات الموجودة مسبقاً في Gem Logic (المُطابقة بمعرّف WooCommerce أو SKU) تُتجاوز أثناء الاستيراد. تُنشأ المنتجات الجديدة فقط.

سحب الطلبات

يمكنكم سحب الطلبات المكتملة من WooCommerce إلى Gem Logic.

سحب الطلبات يدوياً

1. انتقل إلى Configuration ‣ Sales channels.

2. افتح قناة بيع WooCommerce.

3. انقر سحب الطلبات من WooCommerce.

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

سحب الطلبات تلقائياً

يمكن أيضاً سحب الطلبات تلقائياً وفق جدول زمني باستخدام نظام المهام الخلفية. يضمن ذلك استيراد الطلبات المكتملة الجديدة بانتظام دون تدخل يدوي.

ما يتم استيراده

عند سحب الطلبات من WooCommerce، يتم استيراد البيانات التالية:

• مفتاح الطلب (يُستخدم كمعرّف فريد للطلب)

• معلومات الاتصال بالعميل (الاسم، العنوان، البريد الإلكتروني، الهاتف) — يتم إنشاء جهة اتصال أو تحديثها في نظام إدارة علاقات العملاء

• تاريخ الطلب و**العملة**

• بنود السطور: يتضمن كل سطر طلب المنتج (يتم مطابقته بمعرّف WooCommerce أو SKU)، والكمية، والأسعار (غير شامل وشامل ضريبة القيمة المضافة)، ومعدل الضريبة

• خصم المخزون: يتم خصم المخزون تلقائياً لكل بند من بنود الطلب

ملاحظة

يتم استيراد الطلبات التي تحمل حالة مكتمل فقط. يتم تجاهل الطلبات ذات الحالات الأخرى (مثل قيد المعالجة، قيد الانتظار، معلّق).

ملاحظة

يتم تجاهل الطلبات التي تم استيرادها مسبقاً (مطابقة بمفتاح الطلب) لتجنب التكرار.

سجل السحوبات

يتم تسجيل كل عملية سحب. يمكنكم الاطلاع على سجل السحوبات من صفحة تفاصيل قناة البيع. يُظهر كل سجل:

• وقت البدء والانتهاء

• الحالة (بدأت، اكتملت، فشلت، أو نجاح جزئي)

• إجمالي الطلبات المعالجة، الطلبات الجديدة المُنشأة، المتجاهلة، وأعداد الفاشلة

• المدة وأي رسائل خطأ