أرسل إلى eMAG المنتجات
التي تستحق الظهور.

eMAG هي أكبر سوق للتجارة الإلكترونية في رومانيا، وتدير منصات Marketplace مماثلة في بلغاريا (emag.bg) والمجر (emag.hu) ضمن برنامج البائعين نفسه. ولا يبيع البائعون من الأطراف الثالثة عبر متجر منفصل — بل يدرجون عروضهم مباشرةً على كتالوج المنتجات الخاص بـ eMAG من خلال eMAG Marketplace، وينافس كل عرض على صفحة المنتج نفسها عروضَ eMAG للبيع بالتجزئة وبائعي السوق الآخرين. وتوفّر eMAG للبائعين طريقتين لنشر هذا الكتالوج وصيانته: واجهة eMAG Marketplace API (بصيغة JSON، والإصدار الموثّق حاليًا هو 4.5.1) أو Feed Import بصيغة XML/CSV مستضاف تجلبه eMAG وتعالجه من جديد وفق جدول زمني.

إن إعادة إدخال المنتجات يدويًا وإعادة كتابة تغييرات المخزون أو السعر في لوحة البائع في eMAG لا يتوسّع مع نمو الكتالوج إلى ما يتجاوز بضعة عشرات من وحدات SKU، وهو أكبر مصدر وحيد للأسعار القديمة وبيع كميات تفوق المتاح في سوق سريعة الحركة. أما تغذية eMAG برمجيًا فتتيح لكم دفع العروض الجديدة وتغييرات الأسعار ومستويات المخزون من نظام PIM أو متجركم لحظة تغيّرها، بدلًا من انتظار من يتذكّر تسجيل الدخول وتعديل القوائم يدويًا. كما تتيح لكم الوصول إلى ثلاثة أسواق — رومانيا وبلغاريا والمجر — انطلاقًا من بيانات المنتجات نفسها، لأن الأسواق الثلاثة تعمل بآليات Marketplace API وFeed Import ذاتها.

لا تفرض eMAG رسوم تسجيل ولا اشتراكًا شهريًا ولا رسومًا على كل قائمة منتج. ويدفع البائعون عمولة بحسب الفئة على المبيعات المكتملة فقط، وتنص وثائق البائعين الخاصة بـ eMAG على أن العمولة «تتراوح بين 7 و25%، بحسب الفئة» المدرج فيها المنتج — أما النسبة الدقيقة لكل فئة فمحددة في عقد Marketplace الخاص بالبائع. وتُخصم العمولة تلقائيًا قبل الدفع، ويتقاضى البائعون مستحقاتهم مرتين شهريًا. أما البائعون الذين يشتركون في Fulfilled by eMAG (FBE) فيدفعون رسوم تخزين إضافية بحسب مدة بقاء المخزون في مستودع eMAG، إضافةً إلى رسم معالجة لكل طلب يبدأ من 3.99 RON ويزداد بحسب حجم الطرد ووزنه.

تدعم eMAG مسارَي تكامل مختلفين، وقد بُني Feedance حول مسار API لأنه يمنح أدق تحكم في التحقق من البيانات وتوقيت التحديث:

1. Marketplace API (موصى به للأتمتة) — حمولات JSON تُرسل عبر طلبات POST موثّقة إلى نقاط نهاية الموارد مثل product_offer وcategory وorder (مثل product_offer/save وproduct_offer/read وproduct_offer/count). وكل استجابة هي JSON موحّد يحتوي على قيمة منطقية isError ومصفوفة messages، ويقتصر كل استدعاء save واحد على 50 كيانًا (والنطاق الذي توصي به eMAG لمعالجة موثوقة هو 10-50)، بحد أقصى مطلق قدره 4000 عنصر في الاستدعاء الواحد.
2. Feed Import (XML/CSV) — رابط ملف واحد مستضاف تعيد وحدة Feed Import في eMAG جلبه وفق جدول زمني تضبطونه في لوحة البائع. ويقتصر ملف الخلاصة على 100 MB، وبحد أقصى 100,000 منتج، وبحد أقصى 150 فئة في كل خلاصة.

يؤدي المساران في النهاية إلى تعبئة سجلات المنتجات/العروض الأساسية نفسها، لذا يعتمد الاختيار على مقدار التحكم الفوري الذي تحتاجونه في استجابات التحقق ومعالجة الأخطاء — ولهذا يعتمد Feedance افتراضيًا واجهة JSON API.

1. احصلوا على الموافقة على حساب البائع في eMAG Marketplace، ثم أنشئوا بيانات اعتماد API من لوحة البائع.
2. في Feedance، أضيفوا eMAG وجهةً وأدخلوا بيانات الاعتماد هذه ليتمكن Feedance من المصادقة على Marketplace API.
3. اربطوا حقول كتالوج منتجاتكم بمخطط product_offer — name وpart_number وbrand وsale_price وvat_id وstock وEAN والصور، إضافةً إلى الخصائص الخاصة بكل فئة التي تتطلبها eMAG لكل category_id تبيعون ضمنه.
4. حدّدوا حدّي min_sale_price / max_sale_price حتى لا تُرفض تحديثات الأسعار المستقبلية بصمت بعد أن يصبح العرض مباشرًا.
5. دعوا Feedance يتحقق من الخلاصة المربوطة، ويقسّمها إلى دفعات بالحجم الذي توصي به eMAG، أي 10-50 كيانًا لكل استدعاء save، ثم يدفعها — مع ضبط وتيرة الطلبات تلقائيًا للبقاء دون حد الطلبات في eMAG بدلًا من إرسال كل شيء دفعة واحدة.
6. راجعوا استجابات isError / messages التي يعرضها Feedance من كل عملية دفع، حتى يتم تنبيهكم إلى العروض المرفوضة (اقتران خاطئ بين الفئة والخاصية، سعر خارج النطاق، EAN غير صالح، وغير ذلك) لإصلاحها بدلًا من أن تختفي بصمت.

إرشادات eMAG نفسها صريحة بشأن وتيرة الطلبات: تسمح Marketplace API بحد أقصى طلب واحد كل 3 ثوانٍ و20 طلبًا في الدقيقة لكل حساب، وتوصي eMAG بعدم جدولة الاستدعاءات في أوقات ساعة مستديرة وثابتة (مثل بدء دفعة عند 12:04:42 بدلًا من 12:00:00) حتى لا تتصادم مهام عدد كبير من البائعين في الثانية نفسها. وضمن هذا الحد الأقصى، يُعدّ السعر والمخزون أجدر الحقول بالتحديث المكثّف — ويفضّل عند كل تغيّر لديكم، وعلى الأقل عدة مرات في اليوم — لأن رقم مخزون قديمًا في سوق سريعة يكلّفكم مباشرةً طلبات لا تستطيعون تلبيتها أو ترتيبكم أمام العروض المنافسة على صفحة المنتج نفسها. أما المزامنة الكاملة للكتالوج (المنتجات الجديدة والأوصاف المحدّثة والصور والخصائص) فتناسب معظم البائعين على وتيرة يومية؛ وإذا كنتم تستخدمون Feed Import بدلًا من API، فإن الملف لا يكون أحدث من آخر مرة أعادت فيها وحدة Feed Import في eMAG جلب الرابط المستضاف الخاص بكم، لذا تحقّقوا من فاصل التحديث الذي ضبطتموه في لوحة البائع.

أكثر حالات الرفض شيوعًا الموثّقة في المرجع الخاص بـ Marketplace API لدى eMAG هي:

• isError: true مع مصفوفة messages — غلاف الفشل القياسي في eMAG؛ يجب فحص كل طلب بحثًا عن هذه القيمة بدلًا من افتراض نجاحه لمجرد أنه أعاد HTTP 200.
• سعر غير صالح (حالة التحقق 11) — تحدث عندما يقع تحديث sale_price خارج نطاق min_sale_price/max_sale_price المحدد عند أول حفظ للعرض.
• التحقق من EAN/العلامة التجارية/الوثائق قيد الانتظار أو مرفوض (الحالات 1-8) — تُمرّر eMAG العروض الجديدة عبر مراحل تحقق خاصة بـ Marketplace والعلامة التجارية وEAN والوثائق قبل اعتماد العرض (الحالة 9)؛ ويُعدّ الباركود المشوّه (يجب أن يتألف من 6 إلى 14 خانة رقمية بصيغة EAN/UPC/GTIN معروفة) سببًا متكررًا للتعثر عند مرحلة EAN.
• عدم تطابق الفئة والخاصية — إرسال إدخال characteristics لا يصلح معرّفه للفئة category_id الخاصة بالعرض يؤدي إلى رفض ذلك الحفظ.
• أخطاء الصور — تُرفض الصور التي تتجاوز 6000x6000 بكسل أو 8 MB، أو التي بصيغة غير JPG/JPEG/PNG.
• تجاوز حد الطلبات HTTP 429 — يُعاد عند تجاوز طلب واحد كل 3 ثوانٍ أو 20 طلبًا في الدقيقة، مع ترويستي X-RateLimit-Limit-3second / X-RateLimit-Remaining-3second اللتين يمكنكم استخدامهما لتخفيف الوتيرة قبل بلوغ الحد الأقصى مجددًا.

• إذا كان المنتج موجودًا أصلًا في كتالوج eMAG، فاربطوا عرضكم به باستخدام part_number_key بدلًا من إرسال منتج جديد كليًا — فهذا يتجاوز إعادة التحقق ويجعل عرضكم مباشرًا أسرع.
• حدّدوا مسبقًا حدّين واقعيين لـ min_sale_price/max_sale_price؛ فالنطاق الضيق جدًا يعني رفض إعادة التسعير الاعتيادية لاحقًا، ولا تتيح eMAG ضبط هذين الحدّين إلا عند أول حفظ.
• أدخلوا EAN بشكل صحيح من أول مرة — فالتحقق من الباركود من أبطأ مراحل الاعتماد، ورفض EAN يمنع العرض بأكمله من أن يصبح مباشرًا وليس ذلك الحقل وحده.
• املؤوا كل خاصية إلزامية للفئة، لا الحد الأدنى اللازم لاجتياز التحقق فقط — فمرشّحات eMAG في الموقع تُبنى من هذه القيم، والخصائص غير المكتملة تقلّل بهدوء من إمكانية العثور على عرضكم عند تصفح الفئات.
• قسّموا استدعاءات product_offer/save إلى دفعات ضمن نطاق 10-50 كيانًا الذي توصي به eMAG، وباعدوا وقت بدء مهمتكم عن دقائق الساعة المستديرة لتجنب تصادم حد الطلبات مع المهام المجدولة لدى بائعين آخرين.
• تعاملوا مع كل استجابة isError: true على أنها تستدعي إجراءً لا مجرد تفصيل شكلي — فوثائق eMAG نفسها تشير إلى أن بعض عمليات الحفظ الفاشلة تُعالَج جزئيًا، ما قد يترك القائمة في حالة غير متسقة إذا جرى تجاهل الخطأ.

هل تستخدم eMAG خلاصة XML أم واجهة JSON API؟
كلاهما متاح. فـ Marketplace API تعمل بصيغة JSON عبر طلبات POST موثّقة، وهي المسار الذي يؤتمته Feedance. كما تقدّم eMAG خيار Feed Import منفصلًا يقبل ملف XML أو CSV مستضافًا، بحد أقصى 100 MB و100,000 منتج و150 فئة.

هل تكفي خلاصة واحدة لرومانيا وبلغاريا والمجر معًا؟
تدير كل دولة حساب Marketplace خاصًا بها ونسخة API/لوحة بائع خاصة بها (emag.ro وemag.bg وemag.hu)، لذا تربطون كل دولة على حدة، مع أن المخطط والآليات واحدة في الدول الثلاث.

ماذا يحدث إذا تجاوزت حد الطلبات في API لدى eMAG؟
تحصلون على استجابة HTTP 429 مع رسالة تجاوز حد الطلبات. وحد eMAG هو طلب واحد كل 3 ثوانٍ و20 طلبًا في الدقيقة لكل حساب.

هل هناك تكلفة لاستخدام eMAG Marketplace API نفسها؟
لا — لا توجد رسوم منفصلة للوصول إلى API. فإيرادات eMAG تأتي من العمولة بحسب الفئة (نحو 7-25%) المفروضة على المبيعات المكتملة، لا على التكامل أو نشاط الإدراج.

كم منتجًا يمكنني تضمينه في استدعاء حفظ API واحد؟
حتى 50 كيانًا في استدعاء product_offer/save الواحد، ويوصى بنطاق 10-50 لمعالجة موثوقة، مع حد إجمالي قدره 4000 عنصر في الاستدعاء الواحد.

Emag منصة تجارة إلكترونية تقدّم مجموعة واسعة من المنتجات للمستهلكين. أُطلقت في عام 2001، ما يجعلها واحدة من أقدم الأسواق الإلكترونية وأكثرها رسوخًا. بلد المنشأ لمنصة Emag هو رومانيا، وقد وسّعت عملياتها منذ ذلك الحين لتشمل دولًا أخرى في وسط أوروبا وشرقها.

توفّر المنصة لعملائها تشكيلة متنوعة من المنتجات، تشمل الإلكترونيات والأجهزة المنزلية والأزياء ومنتجات التجميل والمعدات الرياضية ومستلزمات المنزل والحديقة وغيرها الكثير. وبفضل واجهة سهلة الاستخدام ومجموعة واسعة من المنتجات، تسعى Emag إلى تلبية احتياجات عملائها وتفضيلاتهم المتنوعة.

ومن أبرز سمات Emag تركيزها القوي على خدمة العملاء ورضاهم. فالمنصة تضع في أولوياتها تقديم تجربة تسوّق سلسة وموثوقة من خلال ميزات مثل وسائل الدفع الآمنة، وخدمات التوصيل الفعّالة، وفريق دعم عملاء سريع الاستجابة. وقد كان هذا الالتزام برضا العملاء عاملًا أساسيًا في بناء قاعدة عملاء وفية على مر السنين.

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

وفي السنوات الأخيرة، وسّعت Emag خدماتها بإطلاق ميزات إضافية مثل Emag Pay، وهي محفظة رقمية تتيح للعملاء إجراء مدفوعات سريعة وآمنة، وEmag Marketplace التي تمكّن البائعين من الأطراف الثالثة من إدراج منتجاتهم وبيعها على المنصة.

وبصفتها منصة تجارة إلكترونية بارزة، حصلت Emag على عدة تكريمات وجوائز تقديرًا لإسهامها في القطاع. ويعود نموها ونجاحها إلى تفانيها في إرضاء العملاء، والتزامها بالجودة، وابتكارها المستمر في تقديم تجربة تسوّق إلكتروني سلسة.

ختامًا، Emag منصة تجارة إلكترونية راسخة نشأت في رومانيا عام 2001. وهي تقدّم لعملائها تشكيلة واسعة من المنتجات وتركّز على تقديم خدمة عملاء ممتازة. وقد جعل نموها وتوسّعها المطّردان منها خيارًا شائعًا للتسوّق عبر الإنترنت في وسط أوروبا وشرقها.