موصل Odoo eBay: مزامنة القائمة والأوامر والمخزون

تظل eBay واحدة من أكبر الأسواق في العالم حيث تضم 132 مليون مشتري نشط على مستوى العالم. بالنسبة للبائعين الذين يستخدمون كلاً من eBay وOdoo 19 Enterprise، فإن إدارة نظامين منفصلين للطلبات والمخزون وبيانات العملاء غير فعالة وعرضة للخطأ. يقوم ECOSIRE Odoo eBay Connector بمزامنة متجر eBay الخاص بك مع Odoo، مما يؤدي إلى أتمتة سير عمل البيع بالكامل بدءًا من إنشاء القائمة وحتى تنفيذ الطلبات ومحاسبة ما بعد البيع.

يغطي هذا الدليل كل شيء بدءًا من إعداد بيانات اعتماد eBay API وحتى إدارة القائمة وأتمتة الطلبات ومزامنة المخزون ومعالجة المرتجعات ومراقبة أداء البائع.

الوجبات الرئيسية

• يستخدم الرابط واجهات برمجة تطبيقات eBay REST وOAuth 2.0 للمصادقة
• يدعم eBay Motors وeBay Business & Industrial وفئات المستهلكين
• يتم دعم قوائم الأسعار الثابتة والمزادات (استيراد الطلب للمزادات فقط)
• تقوم مزامنة المخزون بتحديث كميات eBay خلال 10 دقائق من تغير مخزون Odoo
• تتم إدارة إعداد نفاد المخزون (OOS) الخاص بـ eBay تلقائيًا عندما تصل الكمية إلى 0
• يشمل استيراد الطلب تفاصيل المشتري ومتطلبات الشحن ومبالغ الدفع على موقع eBay
• تتم مزامنة حالات الإرجاع وضمان استعادة الأموال من eBay مع سير عمل Odoo RMA
• دعم المتاجر المتعددة: إدارة حسابات بائعين متعددة على موقع eBay من مثيل Odoo واحد

---

إعداد eBay API والترخيص

يستخدم الموصل مجموعة REST API الخاصة بـ eBay، لتحل محل واجهة برمجة تطبيقات التداول الأقدم لمعظم العمليات.

الخطوة 1: إنشاء حساب مطور على موقع eBay

1. سجل في developer.ebay.com
2. قم بإنشاء تطبيق جديد ضمن حسابي → مجموعات مفاتيح التطبيق
3. لاحظ معرف التطبيق (معرف العميل) ومعرف المطور ومعرف الشهادة (سر العميل)
4. قم بإنشاء RuName (اسم عنوان URL لإعادة توجيه eBay) لتدفق OAuth

الخطوة 2: تكوين نطاقات OAuth

يحتاج تطبيقك إلى نطاقات OAuth التالية:

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

الخطوة 3: إنشاء رموز المستخدم

رموز مستخدم OAuth 2.0 (وليس الرموز المميزة للتطبيق) مطلوبة لعمليات البائع:

1. في تكوين الموصل، انقر فوق التفويض باستخدام eBay
2. أكمل تدفق موافقة eBay OAuth
3. يقوم الموصل بتخزين رمز الوصول ورمز التحديث تلقائيًا
4. تنتهي صلاحية الرموز بعد 18 شهرًا؛ يتم تحديث الموصل تلقائيًا باستخدام رمز التحديث

وضع الحماية مقابل الإنتاج

اختبر دائمًا مع بيئة وضع الحماية الخاصة بـ eBay أولاً:

• واجهة برمجة تطبيقات Sandbox: api.sandbox.ebay.com
• تختلف بيانات اعتماد Sandbox عن بيانات اعتماد الإنتاج
• أنشئ حسابات البائع والمشتري في وضع الحماية على developer.ebay.com/sandbox

---

تركيب الموصل وتكوينه

** التثبيت من سوق ECOSIRE: **

1. قم بشراء وحدة eBay Connector من منتجات ECOSIRE
2. التثبيت عبر التطبيقات → تحديث قائمة التطبيقات → ابحث عن "eBay Connector" → التثبيت
3. انتقل إلى المخزون → التكوين → متاجر eBay أو المبيعات → eBay

** تكوين المتجر: **

سياسات التنفيذ:

قبل الإدراج، قم بتكوين سياسات الوفاء بموقع eBay في Seller Hub:

• سياسة الشحن: شركات النقل، وقت التسليم المقدر، وقت المناولة
• سياسة الإرجاع: إرجاع خلال 30 يومًا، ورسوم إعادة تخزين
• سياسة الدفع: المدفوعات التي تديرها eBay مطلوبة منذ عام 2021

يشير الموصل إلى هذه حسب معرف السياسة. ربطهم في إعدادات المتجر.

---

إدارة القائمة

يدعم الموصل إنشاء قوائم الأسعار الثابتة وإدارتها مباشرةً من سجلات منتجات Odoo.

إنشاء قائمة من منتج Odoo:

1. افتح نموذج المنتج → علامة التبويب eBay
2. انقر القائمة على موقع eBay
3. تكوين حقول القائمة:

• العنوان: ما يصل إلى 80 حرفًا، يتم ملؤها تلقائيًا من اسم المنتج
• الفئة: حدد فئة eBay (البحث حسب الكلمة الرئيسية أو المعرف)
• الحالة: جديدة، مستعملة، قطع غيار/لا تعمل، إلخ.
• السعر: يستخدم قائمة أسعار المنتجات أو يتجاوز السعر
• الكمية: المخزون المتوفر أو الكمية المخصصة
• المدة: GTC (جيد حتى يتم الإلغاء) موصى به للسعر الثابت
• مواصفات السلعة: يتطلب موقع eBay السمات المطلوبة للفئة

4. انقر نشر على موقع eBay

قوالب القائمة:

بالنسبة للبائعين الذين لديهم العديد من المنتجات في نفس الفئة، قم بإنشاء قوالب القائمة:

• انتقل إلى موقع eBay → القوالب → إنشاء قالب
• تكوين الحقول المشتركة: الفئة، الشحن، سياسة الإرجاع، تفاصيل العنصر
• تطبيق القوالب على منتجات متعددة في وقت واحد

** قائمة بالجملة: **

للكتالوجات التي تحتوي على أكثر من 100 منتج:

1. قم بتصدير قائمة المنتجات إلى ملف CSV مع حقول eBay المطلوبة
2. استخدم الاستيراد المجمع في موقع eBay → القائمة المجمعة → تحميل ملف CSV
3. المراجعة والنشر دفعة واحدة

** مزامنة القائمة: **

التغييرات التي تم إجراؤها في مزامنة Odoo مع eBay:

• تغيرات الأسعار → تم تحديث سعر eBay خلال 15 دقيقة
• تغييرات وصف المنتج ← تم تحديث قائمة eBay في المزامنة التالية
• تغييرات الصور ← تحديث صور eBay (يتطلب إعادة الإدراج لبعض التغييرات)

** تفاصيل عنصر فئة eBay: **

يتطلب موقع eBay سمات خاصة بالفئة (مثل العلامة التجارية والحجم واللون للملابس). يقوم الموصل بتعيين سمات منتج Odoo إلى تفاصيل عنصر eBay:

---

مزامنة الطلب

عملية استيراد الطلب:

تتدفق الطلبات من موقع eBay إلى Odoo تلقائيًا:

1. يقدم المشتري طلبًا على موقع eBay ويكمل عملية الدفع
2. يقوم موقع eBay بإنشاء طلب في حالة "في انتظار الشحن".
3. يقوم موصل باستقصاء واجهة برمجة تطبيقات طلبات eBay كل 15 دقيقة (قابل للتكوين)
4. يقوم Odoo بإنشاء طلب بيع يتضمن تفاصيل المشتري من موقع eBay
5. يتم إنشاء أمر التسليم تلقائيًا
6. يقوم المستودع باستيفاء الطلب والتحقق من صحة التسليم
7. يرسل الرابط رقم التتبع مرة أخرى إلى موقع eBay
8. يضع موقع eBay علامة "تم الشحن" على الطلب

** تعيين بيانات الطلب: **

إرسال معلومات التتبع:

عند التحقق من صحة التسليم في Odoo وإدخال رقم التتبع:

1. يكتشف الموصل رقم التتبع الموجود على المخزون
2. يستدعي واجهة برمجة التطبيقات الخاصة بـ Order Fulfillment API لإضافة التتبع
3. يتلقى المشتري إشعارًا من موقع eBay يتضمن تفاصيل التتبع
4. يقوم موقع eBay بتحديث حالة الطلب إلى "تم الشحن"

شركات النقل المدعومة لتحديثات التتبع التلقائي: USPS، وUPS، وFedEx، وDHL، وRoyal Mail، وDeutsche Post، وأكثر من 100 شركة أخرى عبر قائمة رموز شركات النقل الخاصة بـ eBay.

---

مزامنة المخزون

يمنع المخزون الدقيق مقاييس eBay "العيوب" من حالات نفاد المخزون.

آلية مزامنة المخزون:

يستخدم الموصل واجهة برمجة تطبيقات Inventory API الخاصة بـ eBay بالمنطق التالي:

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

عند مزامنة المخزون:

• بعد كل أمر تسليم مؤكد (فوري)
• بعد كل إيصال مصدق (فوري)
• مزامنة كاملة مجدولة كل 30 دقيقة
• المزامنة اليدوية متاحة في أي وقت

** التعامل مع نفاد المخزون: **

قم بتكوين ما يحدث عندما تصل الكمية إلى 0:

• الخيار أ: وضع OOS (توصية Odoo): حافظ على الإدراج نشطًا مع 0 كمية باستخدام خيار eBay's Out of Stock — تحتفظ القائمة بسجلها ومراجعاتها
• الخيار ب: إنهاء القائمة: إزالة القائمة من موقع eBay عندما يصل المخزون إلى 0 وإعادة القائمة عند إعادة تخزينها
• الخيار ج: تعيين الحد الأدنى: قم بتعيين الحد الأدنى للكمية (على سبيل المثال، 1) وانتقل إلى 0 في Odoo فقط عند تشغيل الحد الأدنى لـ OOS

يؤدي الإنهاء وإعادة التسجيل بشكل متكرر إلى الإضرار بموضع بحث eBay. يوصى بوضع OOS.

جرد متعدد المواقع:

في حالة الوفاء من مستودعات متعددة:

• قم بتعيين مستودع أساسي لموقع eBay في إعدادات المتجر
• أو تجميع المخزون عبر مستودعات متعددة
• قم بالتكوين لكل منتج إذا تم شحن بعض وحدات SKU من مواقع محددة

---

التعامل مع الإرجاع والاسترداد

ضمان استعادة الأموال من eBay يعني أنه يجب على البائعين قبول المرتجعات. يعالج الموصل سير عمل الإرجاع في Odoo.

** عودة سير عمل المزامنة: **

1. يفتح المشتري طلب إرجاع في موقع eBay
2. يقوم الرابط باستيراد حالة الإرجاع إلى Odoo باعتبارها RMA (تفويض إرجاع البضائع)
3. يقوم فريق العمليات بمراجعة سبب الإرجاع في Odoo
4. في حالة القبول: قم بإنشاء ملصق شحن الإرجاع (في حالة توفير ملصقات الدفع المسبق)
5. يقوم المشتري بشحن السلعة مرة أخرى
6. استلام البضائع المرتجعة في Odoo ← التحقق من صحة الاستلام
7. معالجة استرداد الأموال: قم بإنشاء إشعار دائن في Odoo → يؤدي الموصل إلى استرداد أموال eBay

حالات حالة الإرجاع التي تم تتبعها:

---

مراقبة أداء البائع على موقع eBay

يقوم موقع eBay بتقييم البائعين بناءً على المقاييس التي تؤثر بشكل مباشر على رؤية القائمة. مراقبتها في Odoo:

** مقاييس البائع الرئيسية على موقع eBay:**

** لوحة معلومات الأداء في Odoo: **

انتقل إلى موقع eBay → الأداء لرؤية:

• الطلبات حسب الحالة خلال الثلاثين يومًا الماضية
• الشحنات المتأخرة (الطلبات التي يتم شحنها بعد وقت المناولة)
• معدل العائد حسب الفئة
• ملخص العيوب مع معرفات الطلب
• مستوى البائع المتوقع للتقييم القادم

---

التسعير والعروض الترويجية

قواعد التسعير الآلي:

قم بتكوين تسعير eBay الديناميكي استنادًا إلى بيانات تكلفة Odoo:

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

مثال: إذا كانت التكلفة 10 دولارات، فإن الهامش المستهدف هو 40%، وتكون رسوم eBay عادةً 12.5%:

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

** عروض التخفيض: **

يدعم الموصل تكامل eBay Promotions Manager:

• إنشاء مبيعات في Odoo → يقوم الموصل بإنشاء عروض ترويجية مقابلة على موقع eBay
• مبيعات فلاش، وخصومات الطلب، والعروض الترويجية للشحن
• العروض الترويجية المجدولة: تم ضبط تواريخ البدء والانتهاء في Odoo

---

الأسئلة المتداولة

هل يدعم الموصل قوائم مزادات eBay؟

يقوم الموصل باستيراد الطلبات من قوائم المزادات تمامًا مثل قوائم الأسعار الثابتة. ومع ذلك، فإن إنشاء قوائم المزادات وإدارتها (تحديد سعر البداية والسعر الاحتياطي والمدة) عبر الرابط محدود - من الأفضل إدارة المزادات مباشرة في eBay Seller Hub. إن إمكانية إدارة القائمة الأساسية للموصل مخصصة لقوائم الأسعار الثابتة / GTC.

كيف يتعامل الموصل مع مدفوعات eBay Managed Payments (معالجة دفع eBay)؟

منذ عام 2021، تقوم eBay بمعالجة جميع المدفوعات من خلال المدفوعات التي تديرها eBay. يقوم الموصل باستيراد إجماليات الطلب بما في ذلك سعر الخروج من موقع eBay (سعر العنصر + الشحن). يقوم موقع eBay بتحويل صافي العائدات (بعد الرسوم) إلى حسابك المصرفي. يدعم الموصل استيراد تقارير عوائد eBay للتسوية، وإنشاء إدخالات دفتر اليومية تلقائيًا التي تمثل رسوم eBay المخصومة من العوائد.

هل يمكنني مزامنة المنتجات من Odoo مع متاجر eBay متعددة (حسابات بائعين مختلفة)؟

نعم. قم بإنشاء تكوينات متعددة لمتجر eBay، كل منها ببيانات اعتماد OAuth الخاصة به. يمكن إدراج المنتجات في متاجر متعددة في وقت واحد مع تجاوزات الأسعار الخاصة بالمتجر. يتم تتبع المخزون عالميًا في Odoo وتخصيصه لقوائم كل متجر بناءً على القواعد التي تم تكوينها.

ماذا يحدث لسجل قائمة eBay الخاص بي (المراجعات وعدد المبيعات) عندما أقوم بتحديث القائمة؟

تحافظ تحديثات القائمة القياسية (السعر والكمية والوصف والصور) على سجل القائمة وعدد المبيعات. الإجراءات التي تعيد ضبط التاريخ: الإنهاء وإعادة التسجيل وتغيير فئة eBay لبعض الفئات. يستخدم الموصل نقطة نهاية "عرض التحديث" الخاصة بـ eBay Inventory API لإجراء تغييرات روتينية، مما يحافظ على التاريخ.

كيف يتعامل الموصل مع متطلبات مبيعات eBay الدولية ومتطلبات الجمارك؟

بالنسبة للمبيعات عبر الحدود من خلال eBay International Shipping أو GSP (برنامج الشحن العالمي)، يقوم الموصل بوضع علامة على أمر البيع مع بلد المشتري. يمكنك تكوين المواقف المالية المناسبة والمعاملة الضريبية في Odoo للمبيعات الدولية. يتم شحن طلبات نظام الأفضليات المعمم إلى مركز الوفاء المحلي التابع لشركة eBay؛ يتم التعامل مع الوثائق الجمركية من خلال برنامج نظام الأفضليات المعمم (GSP) الخاص بشركة eBay، وليس من خلال عملياتك.

---

الخطوات التالية

تعمل إدارة عمليات eBay من خلال Odoo على التخلص من إدخال البيانات يدويًا، وتمنع أخطاء المخزون، وتمنحك مصدرًا واحدًا للحقيقة لجميع قنوات المبيعات. تم تصميم ECOSIRE eBay Connector لـ Odoo 19 Enterprise ويتضمن دعمًا كاملاً لأحدث واجهات برمجة تطبيقات REST الخاصة بـ eBay.

الحصول على موصل ECOSIRE eBay لـ Odoo 19 →

تتضمن كل عملية شراء ترخيص الوحدة ووثائق الإعداد والوصول إلى فريق دعم التنفيذ لدينا لتشغيل مزامنة eBay-Odoo بسلاسة من اليوم الأول.