ERP Cloud Systems - ربط WooCommerce

ربط WooCommerce

تم إيقافه في الإصدار 15

يتيح ربط WooCommerce لنظام ERPNext إنشاء أوامر بيع (Sales Orders) تلقائيًا داخل النظام لكل طلب يتم إنشاؤه في WooCommerce من خلال الويب هوك (Webhook).

أثناء إنشاء أمر البيع من WooCommerce، إذا لم يكن العميل أو الصنف موجودًا في ERPNext، فسيقوم النظام تلقائيًا بإنشاء عميل جديد (Customer) و/أو صنف جديد (Item) باستخدام التفاصيل المأخوذة من بيانات الطلب في WooCommerce كما يقوم بإنشاء عنوان مرتبط بالعميل باستخدام بيانات الشحن الخاصة بالطلب.

1. كيفية إعداد WooCommerce

1.1 إنشاء مفتاح API و Secret

1. من الشريط الجانبي في موقع WooCommerce، انتقل إلى Settings (الإعدادات).
2. انقر على تبويب Advanced (المتقدم)، ثم على رابط REST API.

3. اضغط على زر Add key (إضافة مفتاح)، أدخل التفاصيل المطلوبة، ثم اضغط على Generate API key (توليد مفتاح API).

1.2 إعداد WooCommerce

على موقع ERPNext الخاص بك، انتقل إلى

الصفحة الرئيسية > الربط > الإعدادات > إعدادات WooCommerce

ثم قم باتباع الخطوات التالية:

1. الصق مفتاح الـ APIوالـ Secret الذي تم توليده في الخطوة السابقة داخل حقلي API Consumer Key و API Consumer Secret.
2. في حقل WooCommerce Server URL، الصق رابط موقع WooCommerce الخاص بك.
3. تأكد من تفعيل خيار Enable Syncلبدء المزامنة.
4. في قسم Account Details، اختر الحسابات التالية:

• Tax Account(حساب الضرائب)
• Freight and Forwarding Account(حساب الشحن والنقل)

5. في قسم Defaults، حدد Creation Userوهو المستخدم الذي سيُستخدم لإنشاء العملاء، الأصناف، وأوامر البيع. تأكد أن لديه الصلاحيات المناسبة.
6. اختر الشركة (Company)التي سيتم من خلالها إنشاء أوامر البيع.
7. اضغط Save (حفظ).

1.3 إعداد Webhook في WooCommerce

1. من الشريط الجانبي في موقع WooCommerce، انتقل إلى Settings (الإعدادات).
2. انقر على تبويب Advanced (المتقدم)، ثم اختر Webhooks، واضغط على Add Webhook (إضافة Webhook).
3. أدخل اسمًا مميزًا للـ Webhook حسب رغبتك.
4. من قائمة Status (الحالة)، اختر Active (نشط).
5. في خيار Topic (الموضوع)، اختر Order created (تم إنشاء طلب).
6. انسخ القيمة الموجودة في حقل Endpointمن مستند WooCommerce Settings داخل ERPNext، ثم الصقها في حقل Delivery URL في
7. انسخ القيمة الموجودة في حقل Secretمن نفس المستند في ERPNext، ثم الصقها في حقل Secret في
8. اترك إصدار الـ API (API Version)كما هو، ثم اضغط على Save Webhook (حفظ Webhook).

1.4 إنشاء الطلبات والمزامنة في WooCommerce

1. من موقع WooCommerce، قم بالتسجيل كمستخدم جديدمن صفحة الحساب.
2. بعد التسجيل، انتقل إلى قسم العناوين (Addresses)وأدخل التفاصيل المطلوبة.
3. انقر على Shop (المتجر)لعرض المنتجات المتاحة.
4. أضف المنتجات المطلوبة إلى سلة التسوقثم انقر على View Cart (عرض السلة).
5. بعد مراجعة المنتجات في السلة، اضغط على Proceed to Checkout (المتابعة للدفع).
6. تحقق من تفاصيل الفاتورة والطلب، ثم اضغط على Place Order (إتمام الطلب).
7. ستظهر رسالة "Order Received" (تم استلام الطلب)لتأكيد نجاح عملية الشراء.
8. الآن، في نظام ERPNext، تحقق من المستندات التالية:

• Customer (العميل)
• Address (العنوان)
• Item (الصنف)
• Sales Order (أمر البيع)
  سيتم إنشاؤها تلقائيًا من بيانات الـ

في حال عدم مزامنة الطلبات، يمكنك التحقق من سجل الأخطاء عبر:

الصفحة الرئيسية > الإعدادات > النظام الأساسي > سجل الأخطاء

2. الميزات

2.1 الإعدادات الافتراضية

في نموذج إعدادات WooCommerce داخل ERPNext، يمكنك ضبط الإعدادات التالية:

• المخزن (Warehouse):سيتم استخدام هذا المخزن لإنشاء أوامر البيع. المخزن الافتراضي هو "Stores".
• التسليم بعد (أيام) (Delivery After Days):هو عدد الأيام الافتراضي المضاف إلى تاريخ إنشاء الطلب لتحديد تاريخ التسليم. القيمة الافتراضية هي 7 أيام من تاريخ الطلب.
• تسلسل أوامر البيع (Sales Order Series):يمكنك تحديد تسلسل خاص لأوامر البيع التي يتم إنشاؤها من التسلسل الافتراضي هو "SO-WOO-".
• وحدة القياس (UOM):هي وحدة القياس الافتراضية المستخدمة في العناصر وأوامر البيع. الوحدة الافتراضية هي "Nos".

3. المواضيع ذات الصلة

• أمر البيع (Sales Order)
• الصنف (Item)
• العميل (Customer)
• العنوان (Address)