موصل Odoo Etsy: تكامل التجارة اليدوية

يستضيف Etsy أكثر من 9 ملايين بائع نشط ويخدم مكانًا لا يكرره أي سوق آخر: السلع المصنوعة يدويًا والعتيقة والحرفية. بالنسبة لبائعي Etsy الذين تجاوزوا حدود التتبع الأساسي لجداول البيانات، يوفر Odoo 19 Enterprise إمكانات إدارة المخزون والمحاسبة المالية وتخطيط الإنتاج التي تحتاجها أعمال التوسعة الحرفية.

يربط ECOSIRE Odoo Etsy Connector متجر Etsy الخاص بك مع Odoo، ويقوم بمزامنة القوائم والطلبات والمخزون وبيانات العملاء. يغطي هذا الدليل التكامل الكامل من إعداد بيانات اعتماد Etsy API من خلال إدارة أوامر الإنتاج وإعداد تقارير بائع Etsy.

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

• يستخدم الرابط Etsy API v3 مع مصادقة OAuth 2.0
• تتم مزامنة القوائم في كلا الاتجاهين: أنشئ في Odoo، ثم انشر على Etsy
• يتضمن استيراد الطلب تفاصيل المشتري وملاحظات تخصيص العنصر وأعلام تغليف الهدايا
• يتم دفع المخزون إلى Etsy خلال 5 دقائق من تغير المخزون في Odoo
• يتتبع تكامل أمر الإنتاج (MRP) السلع المصنوعة يدويًا حسب الطلب
• تتم تسوية رسوم Etsy ورسوم معالجة الدفع تلقائيًا مع فواتير Odoo
• دعم المتاجر المتعددة: إدارة العديد من متاجر Etsy من مثيل Odoo واحد
• يتم تتبع تجديد قائمة Etsy (التجديد التلقائي بقيمة 20 سنتًا لكل قائمة) في تكاليف Odoo

---

لماذا يحتاج بائعو Etsy إلى تكامل Odoo

يتعامل مدير المتجر المدمج في Etsy مع تتبع الطلبات الأساسية ولكنه يفتقر إلى العمق الذي تحتاجه الأعمال اليدوية المتنامية:

بالنسبة للبائعين الذين يحققون إيرادات شهرية تزيد عن 10 آلاف دولار أمريكي أو يديرون أكثر من 50 وحدة SKU نشطة عبر المواد اليدوية والمواد، يوفر Odoo إمكانات تشغيلية تتوسع مع حجم الأعمال.

---

إعداد واجهة برمجة تطبيقات Etsy

الخطوة 1: إنشاء حساب مطور Etsy

1. انتقل إلى developers.etsy.com وقم بتسجيل الدخول باستخدام حساب البائع Etsy الخاص بك
2. انقر فوق إنشاء تطبيق ضمن تطبيقاتي
3. قم بتسمية تطبيقك (على سبيل المثال، "تكامل Odoo") ووصف الغرض منه
4. اقبل شروط خدمة Etsy API
5. سيقوم Etsy بمراجعة طلبك (عادةً من 1 إلى 3 أيام عمل)

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

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

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

الخطوة 3: إنشاء بيانات اعتماد واجهة برمجة التطبيقات

بعد الموافقة:

• مفتاح API (سلسلة المفاتيح): معرف التطبيق الخاص بك
• السر المشترك: يستخدم لتدفق OAuth PKCE
• إعادة توجيه URI: https://your-odoo.com/etsy/oauth/callback

الخطوة 4: أكمل تفويض OAuth

من تكوين الموصل في Odoo:

1. انقر الاتصال بمتجر Etsy
2. قم بتخويل الموصل في نافذة Etsy OAuth المنبثقة
3. يستقبل الموصل رمز الوصول ورمز التحديث ويخزنهما

لا تنتهي صلاحية رموز OAuth الخاصة بـ Etsy بحد زمني محدد (على عكس رموز التحديث لمدة 18 شهرًا من Amazon). وتظل صالحة حتى تقوم بإلغائها.

---

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

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

متوفر لدى منتجات ECOSIRE. بعد الشراء:

1. قم بتحميل وتثبيت وحدة Etsy Connector عبر التطبيقات
2. انتقل إلى المخزون → Etsy أو المبيعات → متاجر Etsy

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

** تعيين أقسام متجر Etsy: **

تنظم Etsy القوائم في أقسام المتجر (أي ما يعادل الفئات). قم بتعيين أقسام Etsy إلى فئات منتجات Odoo:

---

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

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

1. افتح نموذج المنتج → علامة التبويب Etsy → إنشاء قائمة
2. تكوين الحقول الخاصة بالقائمة:

• العنوان: 140 حرفًا كحد أقصى، غني بالكلمات الرئيسية لـ Etsy SEO
• الوصف: وصف كامل بالمواد والأبعاد وتعليمات العناية
• العلامات: ما يصل إلى 13 علامة، وهي ضرورية لخوارزمية بحث Etsy
• الفئة: تصفح شجرة التصنيف في Etsy
• من صنعها: أنا فعلتها، عضو في متجري، شخص آخر
• عند الصنع: صُنع حسب الطلب، 2020-2025، 2010-2019، إلخ.
• النوع: عنصر مادي، تنزيل رقمي
• السعر: سعر القائمة (يمكن أن يختلف عن قائمة أسعار Odoo)
• الكمية: المخزون المتاح للقائمة
• المواد: ما يصل إلى 13 علامة مادة
• الصور: ما يصل إلى 10 صور (الصورة الأولى تصبح صورة القائمة الرئيسية)

3. انقر نشر على Etsy

قوائم الصيغ (متغيرات المنتج):

يدعم Etsy "الاختلافات" - يقوم Odoo بتعيينها لسمات المنتج:

مثال: خاتم يُباع باللون الذهبي/الفضي بمقاسات من 5 إلى 10 يُنشئ قائمة Etsy واحدة تحتوي على 12 مجموعة مختلفة، لكل منها سعرها الخاص وتتبع المخزون.

قوائم الطلبات الشخصية والمخصصة:

تشتهر Etsy بالعناصر الشخصية. تكوين التخصيص في الموصل:

• قم بتمكين التخصيص مطلوب/اختياري في القائمة
• يقوم المشتري بإدخال نص التخصيص (الاسم، التاريخ، المونوغرام) عند الدفع
• يظهر هذا النص في حقل ملاحظات العميل الخاص بأمر بيع Odoo
• يرى فريق الإنتاج التخصيص عند صنع المنتج

---

مزامنة الطلب

تفاصيل استيراد الطلب:

تتضمن طلبات Etsy الحقول المهمة للبائعين المصنوعين يدويًا:

** توجيه الطلب حسب الطلب: **

غالبًا ما يقوم بائعو Etsy بتصنيع العناصر بعد تلقي الطلب (MTO). تكوين الموصل:

1. في إعدادات المنتج ← علامة تبويب المبيعات ← عند الطلب: "صنع حسب الطلب"
2. عند استيراد أمر Etsy، يقوم Odoo بإنشاء:

• أمر البيع (مؤكد)
• أمر التصنيع (مسودة) مرتبط بالبيع
• يوضح أمر التصنيع المواد المطلوبة ووقت العمل

3. يعمل فريق الإنتاج من خلال أمر التصنيع
4. عند الانتهاء من MO، تصل البضائع إلى المخزون → يتم تأكيد التسليم
5. تم إرسال تفاصيل الشحنة إلى Etsy

** التعامل مع الطلب حسب الطلب: **

بالنسبة للعمولات المخصصة (غير مدرجة في Etsy):

1. اقبل الطلب المخصص في Etsy
2. في Odoo، قم بإنشاء أمر بيع "منتج مخصص" يدويًا بالسعر المتفق عليه
3. قم بالارتباط بمحادثة Etsy في ملاحظات الطلب
4. قم بوضع علامة على أنه تم شحنه في Etsy يدويًا أو عبر أداة الطلب المخصصة للموصل

---

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

بالنسبة للمنتجات المادية:

يتم تشغيل مزامنة المخزون كل 5 دقائق بشكل افتراضي. عندما يتغير مخزون Odoo:

1. الكمية المتاحة المعاد حسابها (الموجودة مطروحًا منها المحجوزة)
2. تم دفع الكمية إلى Etsy عبر List Inventory API
3. إذا وصلت الكمية إلى 0: تم ضبط القائمة على البيع (تبقي القائمة نشطة)
4. عند إعادة التخزين: يتم إعادة تنشيط القائمة تلقائيًا

للمنتجات حسب الطلب:

لا تقوم منتجات MTO بتتبع المخزون الفعلي بالمعنى التقليدي. قم بتكوين كمية قائمة Etsy كمؤشر للطاقة الإنتاجية:

• قم بتعيين "الكمية المتاحة" الثابتة (على سبيل المثال، 5) التي تمثل سعة الطلب الحالية
• اضبط يدويًا عند امتلاء قائمة انتظار الإنتاج الخاصة بك

للتنزيلات الرقمية:

المنتجات الرقمية لديها مخزون لا حصر له. يقوم الموصل بتعيين كمية Etsy على 999 ولا يقوم مطلقًا بمزامنة تغييرات المخزون. يتم التعامل مع تسليم الملفات الرقمية من خلال نظام التنزيل الرقمي الأصلي لـ Etsy - لا يلمس الموصل تسليم الملفات.

---

التسوية المالية

تتطلب معالجة الدفع وهيكل الرسوم في Etsy إعدادًا محاسبيًا دقيقًا.

** هيكل رسوم مدفوعات Etsy (كمرجع):**

• رسوم الإدراج: 0.20 دولارًا أمريكيًا لكل قائمة (يتم تحصيلها عند الإدراج وكل 4 أشهر عند التجديد التلقائي)
• رسوم المعاملة: 6.5% من سعر السلعة + الشحن
• رسوم معالجة الدفع: 3% + 0.25 دولار لكل معاملة (الولايات المتحدة)
• رسوم الإعلانات خارج الموقع: 12-15% عندما تعلن Etsy عن العنصر الخاص بك (إذا كان مسجلاً)

إعداد تسوية الرسوم في Odoo:

1. قم بإنشاء مجلة Etsy Payments مخصصة (نوع البنك)
2. إنشاء الحسابات:

• Etsy Listing Fees (نفقة)
• Etsy Transaction Fees (نفقة)
• Etsy Payment Processing Fees (نفقة)
• Etsy Payments Receivable (الأصل الحالي)

3. استيراد بيانات الدفع Etsy:

• انتقل إلى Etsy ← المدفوعات ← كشف الحساب الشهري ← تنزيل ملف CSV
• الاستيراد إلى أداة التوفيق الخاصة بالموصل
• يقوم الموصل بإنشاء إدخالات دفتر اليومية لكل نوع معاملة

عملية تسوية نهاية الشهر:

1. قم بتنزيل ملف الدفع الشهري Etsy CSV
2. الاستيراد عبر الموصل: Etsy → المصالحة → بيان الاستيراد
3. قم بمراجعة الإدخالات المتطابقة تلقائيًا
4. قم بمطابقة أي معاملات غير معروفة يدويًا
5. قم بتأكيد التسوية ← إدخالات دفتر اليومية المنشورة في Odoo
6. قم بتسوية الحساب البنكي لـ Etsy Payments مع رصيد Odoo

---

Etsy SEO وتتبع الأداء

** مزامنة أداء القائمة: **

يقوم الموصل باستيراد إحصائيات متجر Etsy إلى Odoo:

• المشاهدات لكل قائمة يوميا
• عدد المفضلة
• معدل التحويل (المشاهدات إلى المبيعات)
• الإيرادات عن طريق القائمة

تظهر هذه البيانات في لوحة معلومات تحليلات Etsy في Odoo، مما يسمح لك بتحديد أصحاب الأداء العالي والقوائم ذات الأداء الضعيف دون التبديل إلى واجهة إحصائيات Etsy.

تتبع العلامات والكلمات الرئيسية:

تتبع مصطلحات البحث التي تدفع حركة مرور Etsy عن طريق سحب الإحصائيات من واجهة برمجة تطبيقات Etsy's Shop Stats. استخدم هذه البيانات من أجل:

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

---

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

هل يستطيع الموصل التعامل مع نموذج Etsy (موقع ويب مخصص) بالإضافة إلى سوق Etsy؟

لا، فالموصل يتكامل مع سوق Etsy على وجه التحديد. يشترك Etsy Pattern (أداة إنشاء مواقع الويب المستضافة) في نفس المخزون ولكنه يستخدم معالجة دفع ودفع منفصلة. يجب إدارة أوامر الأنماط بشكل منفصل. للحصول على تكامل موقع الويب كامل الميزات، يوصى بوحدة موقع الويب الخاص بـ Odoo أو التكامل مع Shopify.

كيف يتعامل الموصل مع احتياطي Etsy للمعاملات (تعليق دفع Etsy)؟

تقوم Etsy أحيانًا بوضع احتياطي على مدفوعات البائع الجديد لإدارة المخاطر. يتتبع الموصل حالة الدفع لكل طلب. تظهر المبالغ المحجوزة في رصيد Etsy Payments ولكنها غير متاحة للسحب. يقوم الموصل بوضع علامة على هذه الفواتير على أنها "في انتظار الدفع" حتى يتم تحرير الاحتياطي، ثم يتم تحديثها إلى "مدفوعة" عندما يتم تحرير الأموال إلى البنك الذي تتعامل معه.

هل يمكنني إدارة متاجر Etsy متعددة (على سبيل المثال، متجر للمجوهرات وآخر لديكور المنزل) من مثيل Odoo واحد؟

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

هل يدعم الموصل وظائف البيع بالجملة/B2B الخاصة بـ Etsy؟

ليس لدى Etsy برنامج بيع بالجملة/B2B أصلي. إذا كنت تستخدم Etsy للاستفسارات بالجملة ولكنك تتعامل مع المعاملة الفعلية دون الاتصال بالإنترنت، فإن الموصل يتعامل معها بنفس الطريقة التي يتعامل بها أي طلب مخصص - يمكنك إنشاء أمر بيع Odoo يدويًا بسعر متفق عليه وتنفيذه من خلال العملية القياسية الخاصة بك.

كيف يتعامل الموصل مع مبيعات Etsy الدولية ومتطلبات ضريبة القيمة المضافة/ضريبة السلع والخدمات؟

تقوم Etsy بجمع وتحويل ضريبة القيمة المضافة/ضريبة السلع والخدمات نيابة عن البائعين للمشترين في الاتحاد الأوروبي والمملكة المتحدة وأستراليا والولايات القضائية الأخرى حيث تعمل Etsy كميسر للسوق. يقوم الموصل باستيراد هذه الطلبات بضريبة قدرها 0 دولار (حيث قامت Etsy بجمعها). بالنسبة للأسواق التي تكون مسؤولاً فيها عن تحصيل الضرائب، قم بتكوين الأوضاع المالية المناسبة في Odoo استنادًا إلى بلد المشتري.

---

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

يقوم ECOSIRE Etsy Connector بتحويل Etsy من سوق مستقل إلى قناة مبيعات متكاملة تمامًا داخل Odoo 19 Enterprise. بالنسبة للشركات المصنوعة يدويًا التي تتجاوز نطاق إدارة المتاجر الأساسية، فإن هذا التكامل يوفر العمود الفقري التشغيلي للنمو المستدام.

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

يشتمل الموصل على وثائق الإعداد وأدوات الاستيراد لبيانات الطلب التاريخية ودعم التنفيذ لدمج متجر Etsy الخاص بك مع Odoo بسرعة وبشكل صحيح.