يشرح هذا الدليل الطريقة العملية لربط متجر ووكومرس بـ Odoo مع موصل ووكومرس من Abrak يوضح. والنسخة الكاملة المصوّرة من هذا الدليل محدّثة دائمًا على صفحة دليل الموصّل متاح؛ وهنا تقرؤون ملخصه العملي.
الخطوة 1 — تفعيل التطبيق على Odoo
من متجر تطبيقات Abrak، فعّل «موصل ووكومرس». ستظهر قائمة «ووكومرس» في الشريط الرئيسي لأودو.
الخطوة 2 — إنشاء مفتاح REST API في WooCommerce
في WooCommerce ▸ الإعدادات ▸ متقدم ▸ REST API أنشئ مفتاحًا بصلاحية قراءة/كتابة. يُدخَل هذا المفتاح مع عنوان المتجر في نموذج «المتجر» على Odoo، مع مفتاح مشترك لتوقيع HMAC.
الخطوة 3 — تثبيت إضافة ووردبريس
تُحمَّل الإضافة المجانية لووردپرس مباشرة من لوحة أودو أو تُثبَّت بملف zip بسيط. في إعداداتها، يُدخَل عنوان أودو ومعرّف المتجر ونفس المفتاح المشترك من الخطوة السابقة — يجب أن يتطابق حرفيًا.
الخطوة 4 — أول مزامنة كاملة
في سجل المتجر داخل Odoo يرسل زر «إرسال كامل» الكتالوج الكامل من Odoo إلى المتجر، ويستورد زر «مزامنة كاملة» الطلبات والعملاء الموجودين في المتجر إلى Odoo. ومن ثم يجري تبادل كل تغيير لاحق تلقائيًا ولحظيًا.
نقطة مفتاحية: أبقِ SKU موحّدًا
تتم مطابقة المنتجات بين النظامين بناءً على معرّف المنتج (SKU). قبل المزامنة الأولى، تأكدوا من تطابق رموز SKU بين Odoo وووكومرس للمنتجات المشتركة لتجنب إنشاء منتجات مكررة.
إذا واجهت مشكلة
خطأ "توقيع غير صالح" يعني أن المفتاح المشترك بين الطرفين غير متطابق؛ وخطأ الاتصال يعني أن مفتاح REST API أو عنوان المتجر غير صحيح. تُظهر قائمة انتظار المزامنة على Odoo حالة كل مهمة وآخر خطأ. تفاصيل استكشاف الأخطاء الكاملة في الدليل الشامل وقائمة «المساعدة» داخل التطبيق نفسه (المرتبطة بمعرفة Odoo) متاحة.
هل أنتم مستعدون؟ همین حالا شروع کنید أو الأسعار للاطلاع عليه.
عیب‌یابی چهار خطای رایج همگام‌سازی
اگر بعد از گام چهارم چیزی سر جایش ننشست، تقریباً همیشه یکی از این چهار مورد است. هرکدام نشانهٔ مشخصی دارد، پس لازم نیست از اول شروع کنید.
| نشانه | علت محتمل | راه‌حل |
|---|---|---|
| محصول ساخته می‌شود ولی قیمت صفر است | لیست قیمت پیش‌فرض روی اتصال ست نشده | لیست قیمت را در تنظیمات اتصال انتخاب کنید و یک همگام‌سازی دستی بزنید |
| محصولات تکراری ساخته می‌شوند | SKU در دو سیستم یکی نیست | SKU را در ووکامرس با کد داخلی اودو یکسان کنید؛ نگاشت بر پایهٔ SKU است نه نام |
| موجودی به‌روز نمی‌شود | انبار مبدأ مشخص نشده یا محصول «ذخیره‌شدنی» نیست | نوع محصول را روی «ذخیره‌شدنی» بگذارید و انبار فروش آنلاین را تعیین کنید |
| سفارش می‌آید ولی سند مالی ساخته نمی‌شود | روش پرداخت به ژورنال متصل نیست | هر روش پرداخت ووکامرس را به یک ژورنال بانکی/نقدی در اودو نگاشت کنید |
ترتیب درست اولین همگام‌سازی
وسوسه می‌شوید همه‌چیز را یک‌جا سینک کنید. در فروشگاه‌های بالای چند صد محصول، این کار هم کند است هم خطاها را روی هم می‌ریزد. ترتیب زیر خطا را قابل ردیابی نگه می‌دارد:
- اول یک دستهٔ کوچک: پنج تا ده محصول نمونه با SKU درست. تا وقتی این‌ها تمیز سینک نشده‌اند، جلو نروید.
- بعد کاتالوگ کامل: با موجودی و قیمت، بدون سفارش. مغایرت‌ها را همین‌جا اصلاح کنید.
- بعد سفارش‌ها: ابتدا فقط سفارش‌های جدید؛ سفارش‌های تاریخی را جداگانه و در ساعت کم‌ترافیک منتقل کنید.
- آخر مشتری‌ها: نگاشت بر پایهٔ ایمیل انجام می‌شود، پس مخاطبان تکراری اودو را پیش از این مرحله ادغام کنید.
بعد از راه‌اندازی چه چیزی را پایش کنید
سه عدد هفتگی کافی است: تعداد سفارش‌های سینک‌نشده (باید صفر بماند)، اختلاف موجودی بین دو سیستم روی محصولات پرفروش، و فاصلهٔ زمانی بین ثبت سفارش و صدور فاکتور. هر سه اگر از حالت عادی خارج شوند، معمولاً به همان چهار علت جدول بالا برمی‌گردند.
اگر هنوز بین مسیرها تصمیم نگرفته‌اید، مقایسهٔ کانکتور اختصاصی با Zapier را ببینید و برای معماری کامل، صفحهٔ اتصال ووکامرس به اودو و اپ کانکتور ووکامرس.
