تكامل Etsy: واجهة Open API ومدير المتجر وإدارة موحّدة للقوائم

نبذة عن Etsy: المؤسسون والشركات التابعة والمكانة في السوق

القصة (من 2005 حتى اليوم)

Etsy أُطلق في يونيو 2005 من شقة في بروكلين على يد Rob Kalin، بمشاركة Chris Maguire, Haim Schoppik و Jared Tarbell، كسوق يقوده المجتمع للحرفيين والمصممين وهواة الجمع. ثم أُدرج في بورصة NASDAQ عام 2015 تحت الرمز ETSY. وبعد طفرة فترة الجائحة، توسعت الشركة عبر عمليات استحواذ: Reverb (الآلات الموسيقية، 2019)، Depop (إعادة بيع أزياء الجيل Z، 30 مليون مستخدم، 2021) و Elo7 ("Etsy أمريكا اللاتينية" في البرازيل، 2021).

في ظل الرئيس التنفيذي الحالي Josh Silverman، أعادت Etsy Inc تركيزها على سوقها الأساسي — بتشديد تطبيق سياسات البائعين، والاستثمار في مؤشرات الثقة مثل برنامج Star Seller ، ومضاعفة الاهتمام بالتجارة التي يقودها المبدعون. ويولّد الجوال الآن نحو 80% من الجلسات، وتحقق القطاعات الموسمية (حفلات الزفاف وعيد الميلاد وعيد الأم وعيد الحب) نموًا في عدد المشترين يتصدر الفئات بانتظام.

هيكل مجموعة Etsy Inc (2026)

• Etsy.com — السوق الرئيسي للمنتجات اليدوية والقديمة ومستلزمات الحرف
• Reverb — الآلات الموسيقية ومعدات الموسيقى (استُحوذ عليه في 2019)
• Depop — إعادة بيع أزياء الجيل Z، أكثر من 30 مليون مستخدم (استُحوذ عليه في 2021)
• Elo7 — سوق برازيلي للمنتجات اليدوية (استُحوذ عليه في 2021)
• Etsy Payments — معالجة مدفوعات داخلية في أكثر من 40 دولة

مكانة Etsy في السوق البريطاني

تُعد المملكة المتحدة ثاني أكبر سوق للبائعين في Etsy عالميًا — إذ يولّد أكثر من 350,000 بائع نشط في المملكة المتحدة و أكثر من 8 ملايين مشترٍ نشط في المملكة المتحدة ما يزيد على 5 مليارات جنيه إسترليني من إجمالي قيمة المبيعات سنويًا عبر Etsy. ويهيمن الحرفيون البريطانيون على فئات مثل المجوهرات الراقية والمنتجات الجلدية والخزف والمطبوعات وقرطاسية الزفاف المصممة حسب الطلب، بينما يستفيد بائعو القطع القديمة البريطانيون من سياسة Etsy الصارمة "20 عامًا فأكثر" التي تحافظ على انتقاء الفئة.

📥 طلب البيع الرسمي على Etsy etsy.com/sell — طلب مجاني، والموافقة خلال 1–3 أيام عمل →

حجم سوق Etsy ونموه (بيانات 2024–2025)

بعد الطفرة التي شهدتها فترة الجائحة، استقر Etsy على نمو صحي ومربح — مع تفوق المملكة المتحدة وغرب أوروبا باستمرار على الفئات الأمريكية التقليدية. وما زال إجمالي قيمة المبيعات (GMS) وعدد المشترين النشطين أعلى بكثير من مستويات ما قبل 2020.

السنة	إجمالي المبيعات (GMS) بالدولار	المشترون النشطون	البائعون النشطون	البائعون في المملكة المتحدة
2020	~$10.3B	81M	4.4M	~250K
2022	~$13.3B	89M	7.5M	~320K
2024	~$12.6B	95M+	7M+	350K+
2025 (توقعات)	~$13.5B	100M+	7.3M	380K

يبلغ متوسط قيمة الطلب نحو 25–40 جنيهًا إسترلينيًا، وتتجاوز فئات الزفاف والمجوهرات والهدايا المخصصة هذا المتوسط بوضوح. وبالنسبة للمبدعين في المملكة المتحدة، يظل Etsy أسرع الطرق وأقلها احتكاكًا للوصول إلى المشترين حول العالم — 50% من زيارات Etsy.co.uk تأتي من خارج المملكة المتحدة، وتتصدر الولايات المتحدة وألمانيا وفرنسا وأستراليا وكندا الأسواق الواردة.

كيف تفتح متجرًا على Etsy (قواعد المملكة المتحدة 2026)

1. الحساب والأساسيات القانونية

المتطلبات الورقية في Etsy أقل بكثير من معظم الأسواق — لكن البائعين في المملكة المتحدة ما زالوا بحاجة إلى وضع قانوني سليم. لا يوجد حد أدنى لهيكل الشركة: فالتاجر الفرد والشركات المحدودة والشراكات جميعها مرحّب بها، شريطة أن تمارس نشاطك بصورة قانونية وتدفع الضريبة على مبيعاتك.

• حساب Etsy مع بريد إلكتروني ورقم هاتف موثّقين
• حساب مصرفي في المملكة المتحدة باسم متجرك القانوني (Etsy Payments)
• التسجيل لدى HMRC — التقييم الذاتي للتجار الأفراد، وضريبة الشركات للشركات المحدودة
• تسجيل VAT إذا تجاوز حجم مبيعاتك الحد الأدنى في المملكة المتحدة (نحو 90,000 جنيه إسترليني)؛ ويحصّل Etsy VAT من المشترين في الاتحاد الأوروبي عبر IOSS
• MTD لضريبة VAT مسك دفاتر متوافق مع Making Tax Digital
• التحقق من العلامات التجارية — يطبّق Etsy حماية الملكية الفكرية بصرامة؛ راجع سجل UK IPO قبل استخدام أسماء العلامات التجارية
• وثائق CITES للقطع القديمة التي تحتوي على مواد محمية (العاج وصدف السلحفاة وأنواع معينة من الأخشاب)

2. التقديم عبر Etsy Shop Manager

سجّل عبر etsy.com/sell. تكون الموافقة فورية عادةً للبائعين الملتزمين في المملكة المتحدة — فـ Etsy أكثر تساهلًا من معظم الأسواق في مرحلة الانضمام، لكنه يطبّق السياسات بصرامة بعد الإطلاق. وبعد تفعيل متجرك تحصل على shop_id، ويمكنك إنشاء تطبيق مطوّر على Etsy وإنشاء بيانات اعتماد OAuth 2.0 (معرّف العميل والسر الخاص بالعميل والرموز المحدّدة النطاق) — وهي المفاتيح التي يستخدمها Zunapro للتواصل مع Open API نيابةً عنك.

3. قواعد القوائم والمحتوى

معايير القوائم في Etsy صارمة — وأكثر صرامة مما يتوقعه معظم البائعين:

• العنوان: حتى 140 حرفًا، وصفي وغني بالكلمات المفتاحية، دون إفراط في الأحرف الكبيرة
• الصور: حتى 10 صور بالإضافة إلى 1 فيديو، بدقة موصى بها 2000×2000 بكسل، مع تفضيل التصوير الخفيف والمشرق بأسلوب الحياة اليومية
• الوصف: وصف مطوّل يعتمد على القصة؛ اذكر المواد والأبعاد ووقت المعالجة
• الوسوم: 13 وسمًا لكل قائمة، تعكس نوايا البحث في المملكة المتحدة وعالميًا
• الفئات والسمات: يجب أن تطابق تصنيف Etsy؛ ويجب أن يكون عمر القطع القديمة 20 عامًا فأكثر
• شركاء الإنتاج: الإفصاح إلزامي إذا كنت تستعين بمصنّع لتصاميمك اليدوية

رسوم Etsy في 2026 (للبائعين في المملكة المتحدة)

يقوم النموذج التجاري لـ Etsy على اقتصاديات صغيرة لكل قائمة بدلًا من عمولة سوق ثابتة. ويستهين معظم البائعين في المملكة المتحدة بالأثر التراكمي لرسوم القوائم + رسوم المعاملات + معالجة الدفع + Offsite Ads — وهنا تحديدًا يتسرب الهامش بصمت. فيما يلي التفصيل المهم فعليًا عند تسعير شمعة بسعر 30 جنيهًا إسترلينيًا أو خاتم بسعر 180 جنيهًا إسترلينيًا:

معادلة صافي الهامش الحقيقي: سعر البيع − رسم القائمة − رسم المعاملة 6.5% − معالجة الدفع (4% + 0.20 جنيه إسترليني) − إعلانات Offsite/Etsy الاختيارية − VAT − تكلفة البضاعة المباعة − تكلفة الشحن = صافي الربح. يحسب Zunapro ذلك لكل SKU ولكل فئة، ويحدد المنتجات الخاسرة قبل إدراجها، ويتيح لك تعيين حد أدنى للهامش لا يُسمح لأي أتمتة بتجاوزه.

Etsy Open API v3 — التفاصيل التقنية

تُعد Etsy Open API v3 واجهة قائمة على REST تتيح للبائعين إدارة القوائم والمخزون والطلبات والشحن والبيانات المالية برمجيًا. عنوان URL الأساسي: https://openapi.etsy.com/v3/application/. التوثيق الرسمي متاح على developers.etsy.com.

المصادقة: OAuth 2.0

على خلاف الأسواق القديمة، يستخدم Etsy معيار OAuth 2.0 with PKCE. تسجّل تطبيق مطوّر، وتطلب أذونات محدّدة النطاق (مثل listings_w, transactions_r, shops_w)، وتستبدل رمز التفويض برمز وصول (صالح لمدة 1 ساعة) ورمز تحديث (صالح لمدة 90 يومًا). يتولى Zunapro عملية OAuth كاملة وتدوير الرموز، فلا ترى خطأ 401 في بيئة الإنتاج أبدًا.

مجموعات نقاط النهاية الأساسية

• Listings API — إنشاء القوائم وتحديثها وتجديدها وإلغاء تنشيطها وإدارة مخزونها (بما في ذلك الخيارات والتخصيص)
• Inventory API — الكمية لكل SKU والتسعير لكل خيار بعملة متجرك
• Receipts API — الطلبات (يسميها Etsy "receipts")، وبيانات المشتري، وعناوين الشحن
• Shipping API — ملفات الشحن، والشحن المحسوب، وشراء الملصقات (الولايات المتحدة/المملكة المتحدة)
• Shop API — سياسات المتجر والإعلانات ووضع الإجازة
• Payments API — الدفعات المالية وتفصيل الرسوم والمبالغ المحتجزة
• Reviews API — تقييمات المشترين والردود عليها لمراقبة جودة الخدمة

حدود المعدل ومعالجة الأخطاء

يفرض Etsy Open API حدودًا متدرجة للمعدل — عادةً 10 طلبات/ثانية و 10,000 طلب/يوم لكل تطبيق. وتجاوزها يعيد الخطأ 429 Too Many Requests. ومن الأخطاء الشائعة 400 (التحقق من الصحة، أو سمات التصنيف الناقصة)، 401 (رمز منتهي الصلاحية — يلزم التحديث)، 404 (القائمة/المتجر غير موجود) و 409 (تعارض، وغالبًا بسبب تزامن تحديثات المخزون). ينفذ Zunapro التراجع الأسي ومفاتيح عدم التكرار وطابور الرسائل الفاشلة، فلا يضيع أي تحديث للمخزون بسبب أخطاء عابرة.

الرفع المجمّع للقوائم — من Shopify أو WooCommerce أو XML إلى Etsy

لا يملك Etsy أداة استيراد XML أصلية كما في الأسواق الأخرى — إذ يجب إنشاء القوائم عبر Open API أو يدويًا في Shop Manager. وهذا يجعل أداة التكامل الجيدة هي الفارق بين إطلاق 50 قائمة أسبوعيًا وإطلاق 5,000. يحوّل محرك الرفع المجمّع في Zunapro كتالوجك الحالي إلى قوائم متوافقة مع Etsy، تُعالج على دفعات ضمن حد معدل الواجهة البرمجية.

أساسيات حمولة قائمة Etsy

تتضمن كل قائمة Etsy تنشئها أداة التكامل ما يلي:

• title, description, price, quantity, who_made, when_made, is_supply
• taxonomy_id (فئة Etsy) بالإضافة إلى property_values المطلوبة (المواد واللون الأساسي وغيرها)،
• tags (حتى 13)، materials (حتى 13)، shop_section_id
• shipping_profile_id, processing_min, processing_max
• inventory — الكمية والسعر ورمز SKU لكل منتج (مع دعم الخيارات)
• images — حتى 10 صور بالإضافة إلى 1 فيديو، تُرفع عبر نقطة نهاية صور القوائم

من المتجر إلى Etsy — مسار Zunapro

يدير معظم المبدعين في المملكة المتحدة موقعًا إلكترونيًا (Shopify أو WooCommerce أو Squarespace) إلى جانب Etsy. ويُبقي Zunapro الاثنين متزامنين:

1. يقرأ كتالوجك الرئيسي من Shopify/WooCommerce/CSV/XML وفق جدول زمني
2. يربط الفئات بتصنيف Etsy (يدويًا في المرة الأولى، ثم باقتراحات الذكاء الاصطناعي)
3. يوحّد السمات — المواد والألوان والمقاسات — في قيم خصائص Etsy
4. يبني سعر عملة المتجر (GBP) مع قواعد هامش الربح ورسوم Etsy المضمّنة
5. يولّد 13 وسمًا تلقائيًا لكل قائمة باستخدام بيانات اتجاهات البحث في Etsy
6. يرفع إلى Etsy عبر Open API، ثم يجدول التجديدات التلقائية قبل انتهاء مدة 4 أشهر

تلبية الطلبات في Etsy — أنت تشحن ونحن نؤتمت

على عكس Amazon FBA، لا يشغّل Etsy مراكز تلبية طلبات. يُشحن كل طلب من مقر البائع — وهذا أكبر قيد على Etsy وفي الوقت نفسه أكبر قيمة لعلامته (منتجات يدوية يرسلها صانعها). ومهمة أداة التكامل جعل هذا المسار سلسًا.

شركات الشحن المدعومة في المملكة المتحدة

• Royal Mail — Tracked 24/48 وSpecial Delivery وInternational Tracked & Signed
• Evri — طرود اقتصادية وشبكة نقاط تسليم الطرود
• DPD UK — توصيل في اليوم التالي مع نوافذ تسليم مدتها 1 ساعة
• FedEx & DHL Express — أولوية دولية
• USPS & Parcelforce — لتلبية الطلبات المباشرة للمشترين في الولايات المتحدة

الأتمتة داخل Zunapro

• اختيار شركة الشحن تلقائيًا حسب الوزن وبلد الوجهة وتفضيل المشتري
• طباعة الملصقات بنقرة واحدة (A4 وطابعات حرارية 4×6) مع إرسال رقم التتبع إلى Etsy عبر Receipts API
• مراقبة اتفاقية مستوى خدمة وقت المعالجة — تُبقيك فوق حد Star Seller البالغ 95% للشحن في الموعد
• إقرارات الجمارك (CN22/CN23) تُعبأ تلقائيًا لطلبات Etsy الدولية
• علامة الشحن المعوَّض كربونيًا متوافقة مع رسائل Etsy حول الاستدامة

Star Seller والتقييمات ومعدلات الإلغاء

تُعد شارة Star Seller لدى Etsy أقرب ما يملكه السوق إلى درجة جودة علنية، وهي تؤثر مباشرةً في ترتيب البحث. وللتأهل يجب أن يحقق المتجر الحدود الثلاثة جميعها خلال نافذة متحركة مدتها ثلاثة أشهر:

• تقييمات 5 نجوم — 95% على الأقل من التقييمات يجب أن تكون 5★ (متوسط التقييم فوق 4.8)
• الشحن في الموعد مع التتبع — شحن 95% من الطلبات ضمن وقت المعالجة المعلن، مع رقم تتبع صالح
• سرعة الرد على الرسائل — الرد الأول على رسائل المشترين خلال 24 ساعة
• الحد الأدنى لحجم الطلبات — عادةً 10 طلبات فأكثر ومبيعات 240 جنيهًا إسترلينيًا فأكثر خلال النافذة
• معدل الإلغاء أقل من 4%؛ ويُعد البيع الزائد والإلغاء بسبب "نفاد المخزون" أكبر قاتل لـ Star Seller

تقلل مزامنة المخزون الفورية في Zunapro خطر الإلغاء بنحو 90% — فعند بيع SKU على موقعك أو على Depop أو على قناة أخرى، تُخفَّض كمية Etsy خلال ثوانٍ، فلا تقبل طلبًا لا تستطيع تلبيته.

إعلانات Etsy وOffsite Ads والتسعير متعدد العملات

منتجا الإعلانات في Etsy

• إعلانات Etsy (داخل الموقع) — مزاد بنظام التكلفة لكل نقرة للحصول على موضع متميز في نتائج بحث Etsy؛ وتحدد ميزانية يومية (تبدأ من 1 جنيه إسترليني)
• Offsite Ads — يشغّل Etsy حملات على Google وMeta وPinterest وBing لقوائمك؛ وتدفع 12% (أو 15% للمتاجر التي تقل إيراداتها عن 8,200 جنيه إسترليني سنويًا) فقط على المبيعات المنسوبة — وهي إلزامية للمتاجر التي تتجاوز هذا الحد
• Etsy Seller Bundles — مواضع موسمية في أدلة الهدايا التحريرية في Etsy (عيد الميلاد وعيد الأم وعيد الحب والزفاف)
• تعزيز Star Seller — تحصل المتاجر المؤهلة على شارة ظاهرة وتحسين في الترتيب العضوي

التسعير متعدد العملات (الأساس بالجنيه الإسترليني، والمشتري بعملته المحلية)

لمتجرك على Etsy عملة واحدة (عادةً GBP للبائعين في المملكة المتحدة)، لكن المشترين يرون الأسعار محوّلة تلقائيًا إلى عملتهم المحلية عند الدفع. وقد تؤدي تقلبات الصرف إلى تآكل الهامش بصمت في مبيعات الدولار أو اليورو. تحتفظ أداة إعادة التسعير في Zunapro بسعر رئيسي بالجنيه الإسترليني، وتعيد احتساب الهامش الواصل وفق أسعار الصرف الحية، وتحدّث Etsy كلما خرجت التكلفة مضافًا إليها الرسوم عن نطاق التسامح لديك — دون أن تتجاوز حد الهامش الأدنى لديك.

الامتثال لـ UK VAT وMTD وHMRC لبائعي Etsy

يحصّل Etsy VAT ويورّدها نيابةً عن البائعين للمشترين في الاتحاد الأوروبي عبر IOSSوعلى السلع الرقمية في كثير من الولايات القضائية — لكن البائعين المسجلين في VAT بالمملكة المتحدة يظلون مسؤولين عن إقرارهم المحلي لـ VAT. ومطابقة ملفات CSV المصدّرة من Etsy يدويًا مع Xero أو QuickBooks هي من الأعمال الإدارية التي تلتهم بصمت صباح سبت كل شهر.

وحدة VAT والمحاسبة في Zunapro:

• تسجّل كل إيصال Etsy تلقائيًا كفاتورة مبيعات بالمعالجة الصحيحة لـ VAT (القياسية، أو الصفرية، أو المحصّلة عبر IOSS، أو المورّد المفترض للسوق)
• تدفع السجلات إلى Xero, QuickBooks, Sage عبر API — متوافقة مع MTD لضريبة VAT دون إعداد إضافي
• تُصدر إشعارات دائنة للمبالغ المستردة تلقائيًا عندما يعالج Etsy عملية إرجاع
• تجهيز الإقرار الفصلي لـ VAT وملخصات جاهزة للتقديم إلى HMRC
• إيصالات العملاء ترسل تلقائيًا بالبريد الإلكتروني بصيغة PDF، مع تأكيد اختياري عبر الرسائل النصية

ملفات الشحن في Etsy وتكامل شركات الشحن

تُشحن قوائم Etsy ضمن ملفات شحن قابلة لإعادة الاستخدام — بلد المنشأ، والأسعار الثابتة أو المحسوبة، ووقت المعالجة، والبلدان التي تشحن إليها. ويدير معظم البائعين في المملكة المتحدة ملفات منفصلة لـ Royal Mail المحلي، وللشحن المتتبَّع إلى الاتحاد الأوروبي، وللشحن الدولي المتتبَّع. وتختار وحدة الشحن متعدد الناقلين في Zunapro الملف المناسب لكل طلب تلقائيًا، وتطبع الملصقات لـ Royal Mail وEvri وDPD UK وFedEx وDHLوترسل أرقام التتبع إلى Etsy عبر Receipts API — فتغلق تلقائيًا حلقة "الشحن في الموعد مع التتبع" الخاصة بـ Star Seller.

المرتجعات وشكاوى الملكية الفكرية ونزاعات المشترين

تمنح لوائح العقود الاستهلاكية في المملكة المتحدة المشترين حق الإلغاء خلال 14 يومًا لمعظم الطلبات غير المخصصة، وتشترط سياسة Etsy على المتاجر نشر سياسة إرجاع واضحة. ومعدلات الإرجاع في Etsy أقل بكثير من أسواق الأزياء — عادةً 3–8% — لأن المنتجات مصنوعة حسب الطلب ومختارة بدافع عاطفي لا اندفاعي كالأزياء. لكن الخطر الحقيقي على بائعي Etsy مختلف: شكاوى الملكية الفكرية والعلامات التجارية.

مسار الإرجاع المعتاد في Etsy:

1. يفتح المشتري حالة عبر مركز Help With Order في Etsy خلال 100 يوم من التسليم
2. يرد البائع خلال 48 ساعة؛ وإن لم يفعل فقد يحكم Etsy لصالح المشتري افتراضيًا
3. يُصدر الاسترداد عبر Etsy Payments — جزئيًا أو كليًا، مع شحن الإرجاع أو دونه
4. وفي حالة شكاوى العلامات التجارية/الملكية الفكريةتُزال القائمة فورًا، ويجب على البائع تقديم إشعار مضاد عبر نموذج الملكية الفكرية في Etsy
5. قد تؤدي مخالفات الملكية الفكرية المتكررة إلى تعليق المتجر نهائيًا

تتتبع وحدة إدارة الحالات في Zunapro كل نزاع مفتوح، وتُصدر تلقائيًا إشعارًا دائنًا عند قيام Etsy برد المبلغ للمشتري، وتنبهك فور تسجيل شكوى ملكية فكرية لتتمكن من الرد ضمن مهلة Etsy.

ربط Etsy مع Zunapro — 4 خطوات (10 دقائق)

1. فوّض متجرك على Etsy — في لوحة Zunapro اذهب إلى Marketplace ← Etsy، وانقر "Connect"، وأكمل موافقة OAuth 2.0 في Etsy. لا نرى كلمة مرورك أبدًا — فقط رموزًا محدّدة النطاق.
2. اربط متجرك الإلكتروني — صِل Shopify أو WooCommerce أو Magento أو BigCommerce أو Squarespace أو خلاصة CSV/XML. تتولى الموصلات الجاهزة بيانات الاعتماد وWebhooks.
3. اربط الفئات وملفات الشحن — اسحب فئاتك وأفلتها على تصنيف Etsy؛ وتنتهي اقتراحات الذكاء الاصطناعي خلال دقائق. اختر ملف الشحن الذي ينطبق على كل نوع من المنتجات.
4. أول مزامنة — تبدأ القوائم والمخزون والأسعار والطلبات والشحن بالمزامنة تلقائيًا. وخلال 10 دقائق يصبح متجرك على Etsy مُدارًا بالكامل من Zunapro.

الأسئلة الشائعة حول تكامل Etsy