موصل Odoo Amazon: الإعداد والبيع متعدد القنوات

تمثل أمازون ما يقرب من 40% من إيرادات التجارة الإلكترونية في الولايات المتحدة، مما يجعلها قناة إلزامية لبائعي المنتجات. تؤدي إدارة طلبات Amazon والمخزون والتنفيذ بشكل منفصل عن نظام تخطيط موارد المؤسسات (ERP) الأساسي الخاص بك إلى إنشاء صوامع البيانات ومشكلات التسوية وأخطاء التنفيذ التي تكلف أموالاً حقيقية.

يربط ECOSIRE Odoo Amazon Connector بين Odoo 19 Enterprise وAmazon Seller Central، حيث يقوم بمزامنة المنتجات والطلبات ومستويات المخزون وحالة التنفيذ في كلا الاتجاهين. يغطي هذا الدليل عملية الإعداد الكاملة، وتكوين تعيين البيانات، وخيارات تكرار المزامنة، ومعالجة الأخطاء، وأفضل الممارسات التشغيلية لتشغيل مبيعات أمازون من خلال Odoo.

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

• يدعم الموصل جميع أسواق أمازون (الولايات المتحدة والمملكة المتحدة والاتحاد الأوروبي واليابان والإمارات العربية المتحدة وغيرها)
• يتم تشغيل مزامنة الطلب كل 15 دقيقة بشكل افتراضي؛ شكلي وصولا الى 5 دقائق
• يتم دفع مستويات المخزون إلى أمازون تلقائيًا في كل حركة للأسهم
• تتم معالجة طلبات FBA وFBM (التي ينفذها التاجر) في سير عمل منفصل
• يستخدم تعيين المنتج ASIN وSKU وEAN/UPC كمفاتيح مطابقة
• يتم تسجيل عمليات المزامنة الفاشلة مع تفاصيل الخطأ ويمكن إعادة محاولتها بشكل فردي
• يمكن لقواعد التسعير أن تتجاوز أسعار أمازون بناءً على قوائم أسعار Odoo
• يستخدم الموصل Amazon SP-API (Selling Partner API)، ليحل محل MWS المهملة

---

المتطلبات الأساسية وإعداد Amazon SP-API

يستخدم الموصل واجهة برمجة تطبيقات شركاء البيع الخاصة بأمازون (SP-API). قبل تثبيت الموصل، تحتاج إلى بيانات اعتماد SP-API من Amazon.

الخطوة 1: التسجيل كمطور في Amazon Seller Central

1. قم بتسجيل الدخول إلى Seller Central → التطبيقات والخدمات → تطوير التطبيقات
2. انقر فوق "إضافة عميل تطبيق جديد" وأكمل تسجيل المطور
3. ستقوم أمازون بمراجعة طلبك (1-3 أيام عمل للموافقة عليه)

الخطوة 2: إنشاء تطبيق SP-API

بمجرد الموافقة:

1. انتقل إلى التطبيقات والخدمات → تطوير التطبيقات → تطبيقاتك
2. انقر على "إضافة عميل تطبيق جديد"
3. حدد IAM ARN (قم بإنشاء مستخدم AWS IAM أولاً) أو استخدم OAuth
4. قم بتعيين URI لإعادة التوجيه إلى مثيل Odoo الخاص بك: https://your-odoo.com/amazon/oauth/callback
5. حدد نطاقات واجهة برمجة التطبيقات المطلوبة:

• أوامر API
• تقارير API
• قوائم API
• واجهة برمجة تطبيقات عناصر الكتالوج
• واجهة برمجة تطبيقات جرد FBA
• واجهة برمجة تطبيقات الخلاصات

الخطوة 3: تفويض حساب البائع الخاص بك

بعد إنشاء التطبيق، قم بتخويل التطبيق لكل سوق:

1. انسخ بيانات اعتماد LWA (تسجيل الدخول باستخدام Amazon) الخاصة بالتطبيق الخاص بك
2. انتقل إلى عنوان URL الخاص بتفويض الموصل
3. أكمل تدفق OAuth لكل حساب في سوق Amazon

بيانات الاعتماد التي ستحتاجها في Odoo:

• معرف عميل LWA
• سر عميل LWA
• تحديث الرمز المميز (الذي تم إنشاؤه أثناء تدفق OAuth)
• منطقة AWS (استنادًا إلى السوق)

---

تثبيت وتكوين الموصل

** قم بتثبيت وحدة ECOSIRE Amazon Connector: **

يتوفر الموصل في سوق ECOSIRE. بعد الشراء:

1. قم بتنزيل الملف المضغوط للوحدة من حساب ECOSIRE الخاص بك
2. قم بالرفع إلى خادم Odoo الخاص بك: cp amazon_connector.zip /opt/odoo/addons/
3. استخراج وتثبيت: انتقل إلى التطبيقات → تحديث قائمة التطبيقات → ابحث عن "Amazon Connector" → تثبيت

التكوين الأولي:

انتقل إلى المخزون → التكوين → Amazon Marketplaces (أو المبيعات → Amazon → التكوين اعتمادًا على تخطيط Odoo الخاص بك).

انقر إنشاء لإضافة اتصال جديد بالسوق:

اختبار الاتصال:

بعد الحفظ، انقر فوق اختبار الاتصال. يُرجع الاختبار الناجح اسم التاجر الخاص بك ويؤكد الوصول إلى واجهة برمجة التطبيقات. إذا فشلت، تحقق مما يلي:

• بيانات اعتماد LWA صحيحة
• لم تنتهي صلاحية رمز التحديث
• منطقة AWS تتوافق مع السوق الخاص بك
• تطبيق SP-API في حالة "منشور" (وليس "مسودة")

---

تعيين المنتج ومزامنة الكتالوج

يقوم الموصل بتعيين منتجات Odoo إلى Amazon ASINs باستخدام ثلاث طرق:

الطريقة الأولى: مطابقة SKU (مستحسن)

إذا كانت مراجع منتجك الداخلي (رموز SKU) تتطابق مع SKU البائع الذي تستخدمه على Amazon، فقم بتمكين SKU Auto-Match في إعدادات السوق. سيقوم الموصل تلقائيًا بربط منتجات Odoo بقوائم Amazon الخاصة بها.

الطريقة الثانية: مطابقة EAN/UPC

يستعلم الموصل عن واجهة برمجة تطبيقات كتالوج أمازون للعثور على قوائم مطابقة للرمز الشريطي لمنتجك (EAN13 أو UPC). يعمل هذا مع المنتجات ذات العلامات التجارية المدرجة في كتالوج أمازون.

** الطريقة الثالثة: تعيين ASIN يدويًا **

بالنسبة للمنتجات أو الحزم المخصصة:

1. انتقل إلى نموذج المنتج → علامة التبويب Amazon
2. أدخل رقم ASIN لكل سوق
3. قم بتعيين المتغيرات إلى أرقام ASIN الخاصة بها

استيراد كتالوج أمازون:

بدلاً من تعيين واحد تلو الآخر، قم باستيراد كتالوج أمازون الخاص بك:

1. انتقل إلى أمازون → الكتالوج → استيراد القوائم
2. حدد السوق
3. يقوم الموصل بتنزيل جميع قوائمك النشطة وإنشاء/تحديث منتجات Odoo
4. مراجعة المنتجات المستوردة للتأكد من دقة رسم الخرائط الميدانية

تكوين تعيين حقل المنتج:

---

مزامنة الطلب

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

** سير عمل مزامنة الطلب: **

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

إعدادات مزامنة الطلب:

** التعامل مع الطلبات الملغاة: **

عندما تقوم أمازون بإلغاء طلب (إلغاء العميل أو فشل الدفع):

1. يكتشف الموصل الإلغاء في المزامنة التالية
2. إذا لم يتم التحقق من صحة أمر التسليم: يتم إلغاؤه تلقائيًا
3. إذا تم التحقق من صحة التسليم بالفعل: يقوم الموصل بإنشاء إرجاع RMA
4. يتم إلغاء الفاتورة أو إلغاؤها بإشعار دائن

---

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

تمنع دقة المخزون في الوقت الفعلي الإفراط في البيع، مما يؤدي إلى فرض عقوبات على حساب بائع أمازون.

دفع المخزون إلى أمازون:

في كل مرة تحدث فيها عملية نقل لمخزون Odoo (التسليم، الاستلام، الإرجاع، التعديل)، يدفع الموصل الكمية المحدثة إلى Amazon Inventory API:

• منتجات FBM: الكمية المتوفرة لدى Odoo مطروحًا منها المخزون الاحتياطي الاحتياطي
• منتجات FBA: تدير أمازون مخزون FBA؛ يتلقى Odoo مستويات FBA عبر Amazon Inventory API

تكوين المخزون الآمن:

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

قم بتكوين مخزون الأمان لكل منتج أو عالميًا:

• انتقل إلى المنتج → علامة تبويب أمازون → مخزون الأمان: 5
• أو عالميًا في إعدادات السوق → مخزون الأمان الافتراضي: 2

** تردد مزامنة المخزون: **

على عكس مزامنة الطلب (المعتمدة على الحدث + المجدولة)، تعتمد مزامنة المخزون على الدُفعات:

• الافتراضي: كل 30 دقيقة
• بعد أي حركة للمخزون: خلال 5 دقائق (بنمط webhook)
• قبل فترات الذروة: قم بتشغيل المزامنة اليدوية

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

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

1. قم بإنشاء تكوينات Amazon Marketplace منفصلة لكل مستودع
2. يقوم الموصل بتجميع المخزون عبر جميع المستودعات المرتبطة
3. أو: استخدم ميزة المخزون متعدد المواقع من أمازون مع تخصيص الكمية الخاصة بالمستودع

---

تكامل FBA (يتم الوفاء به من قبل أمازون).

يتم تنفيذ طلبات FBA من خلال مستودع أمازون، ولكن لا يزال Odoo بحاجة إلى معرفتها من أجل التسوية المالية.

سير عمل طلب FBA في Odoo:

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

إدارة مخزون FBA:

إرسال المخزون إلى Amazon FBA من خلال Odoo:

1. قم بإنشاء شحنة FBA في Odoo (أو في Seller Central وربطها)
2. يقوم الموصل بإنشاء عملية نقل مخزون من المستودع الخاص بك إلى موقع "Amazon FBA".
3. التحقق من صحة النقل عند شحن البضائع إلى أمازون
4. يتم تعقب كميات FBA في Odoo لأغراض إعداد التقارير

تسوية رسوم FBA:

تقوم أمازون بخصم الرسوم (الوفاء والتخزين والإحالة) قبل تحويل الدفع. تكوين الموصل إلى:

• استيراد تقارير تسوية أمازون
• إنشاء إدخالات دفتر اليومية تلقائيًا لرسوم FBA
• تسوية صافي مبلغ التسوية مقابل الفواتير المستحقة

---

إدارة الأسعار

** إعادة التسعير الآلي: **

يدعم الموصل تحديثات الأسعار التلقائية إلى Amazon بناءً على قواعد قائمة أسعار Odoo:

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

التكوين:

• انتقل إلى إعدادات السوق → التسعير
• قم بتعيين مصدر السعر: قائمة الأسعار، أو التكلفة + الهامش، أو ثابت
• قم بتعيين المضاعف (على سبيل المثال، 1.0 لنفس السعر، 1.15 لـ 15% من العلامات)
• تمكين ** أسعار المزامنة التلقائية **: يتم دفع الأسعار إلى أمازون عند تغييرها في Odoo

** التعامل مع العملة: **

بالنسبة للأسواق غير الدولار الأمريكي (يورو، جنيه استرليني، ين ياباني)، الرابط:

1. يقرأ الأسعار من قائمة الأسعار الخاصة بالسوق إذا تم تكوينها
2. أو قم بالتحويل من عملتك الأساسية باستخدام أسعار الصرف اليومية من Odoo

---

معالجة الأخطاء ومراقبتها

سجل أخطاء المزامنة:

انتقل إلى Amazon → Sync Logs لرؤية جميع عمليات المزامنة:

• الأخضر: مزامنة ناجحة
• الأصفر: مزامنة جزئية (فشلت بعض السجلات)
• الأحمر: فشل المزامنة بالكامل

يظهر كل إدخال خطأ:

• الطابع الزمني ونوع المزامنة (الطلبات والمخزون والقوائم)
• رمز الخطأ من Amazon API
• معرف السجل المتأثر
• رسالة خطأ
• زر إعادة المحاولة

** الأخطاء الشائعة والحلول: **

التنبيهات التلقائية:

تكوين تنبيهات البريد الإلكتروني لفشل المزامنة:

• انتقل إلى إعدادات السوق → الإخطارات
• إضافة عناوين البريد الإلكتروني للإعلام عن أخطاء المزامنة
• ضبط عتبة التنبيه: قم بالإخطار بعد 3 حالات فشل متتالية

---

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

هل يدعم الموصل خدمة Amazon FBA Multi-Channel Fulfillment (MCF)؟

نعم. يتيح لك MCF استخدام مخزون Amazon FBA لتلبية الطلبات من قنوات المبيعات الأخرى (موقع الويب الخاص بك، والأسواق الأخرى). يمكن للموصل إنشاء طلبات تنفيذ MCF عند استلام أمر بيع من قناة غير تابعة لأمازون، بشرط أن يتم تخزين المنتج في FBA. يتم تتبع طلبات MCF في Odoo من خلال حركات موقع FBA.

كيف يتعامل الموصل مع القواعد الضريبية المعقدة لأمازون (VAT OSS، Marketplace Facilitator)؟

بالنسبة للأسواق التي تقوم فيها أمازون بجمع وتحويل الضرائب (قواعد Marketplace Facilitator، المطبقة في معظم الولايات الأمريكية والاتحاد الأوروبي للبائعين من خارج الاتحاد الأوروبي)، يقوم الموصل بإنشاء طلبات بضريبة قدرها 0 دولار، حيث تتولى Amazon الالتزام الضريبي. بالنسبة للمواقف التي لا تتعلق بالميسر، يقوم الموصل بتطبيق المواقف المالية التي تم تكوينها في Odoo استنادًا إلى عنوان التسليم الخاص بالمشتري.

هل يمكنني إدارة حسابات أمازون متعددة (حسابات بائعين مختلفة) من مثيل Odoo واحد؟

نعم. قم بإنشاء تكوينات سوق متعددة، كل منها ببيانات اعتماد SP-API الخاصة بها. يمكن أن يكون لديك تكوينات منفصلة لحسابات بائعين مختلفة، أو أسواق مختلفة ضمن نفس الحساب، أو شركات مختلفة في إعداد Odoo متعدد الشركات. تتم إدارة الطلبات والمخزون والتسعير حسب تكوين السوق.

ماذا يحدث إذا قامت أمازون بتغيير الطلب بعد استيراده إلى Odoo؟

يتحقق الموصل من تعديلات الطلب في كل دورة مزامنة. إذا قامت أمازون بتحديث طلب (على سبيل المثال، تغيير الكمية قبل الشحن، تصحيح العنوان)، يقوم الموصل بتحديث أمر بيع Odoo المقابل إذا لم يتم تأكيده بعد. تؤدي التعديلات على الطلبات المؤكدة إلى إنشاء تنبيه نظام للمراجعة اليدوية.

هل يتعامل الموصل مع محتوى Amazon A+ أو محتوى العلامة التجارية المحسّن؟

لا. إدارة محتوى A+ هي محتوى تسويقي يتم إدارته حصريًا من خلال Seller Central. يركز الموصل على البيانات التشغيلية: الطلبات والمخزون والتسعير والتنفيذ. يمكن دفع محتوى المنتج (الأوصاف والصور) إلى قوائم أمازون الأساسية ولكن ليس إلى قوالب محتوى A+.

---

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

يعد البيع على Amazon من خلال Odoo أكثر كفاءة بكثير من إدارة نظامين منفصلين - ولكن يجب إعداد الموصل بشكل صحيح من البداية. تؤدي تعيينات المنتجات التي تم تكوينها بشكل خاطئ، أو إعدادات مزامنة المخزون الخاطئة، أو تكوينات الضرائب غير الصحيحة إلى حدوث مشكلات تتفاقم بمرور الوقت.

تم تصميم وحدة Amazon Connector الخاصة بـ ECOSIRE خصيصًا لـ Odoo 19 Enterprise، ويقدم فريقنا المساعدة في الإعداد والتدريب والدعم المستمر لبائعي السوق الذين يديرون Amazon من خلال Odoo.

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

يتضمن الشراء ترخيص الوحدة والوثائق ودعم التنفيذ لمدة 30 يومًا لتشغيل تكامل Amazon-Odoo بشكل صحيح من اليوم الأول.