تكامل Ecomanager: أرسل طلباتك إلى Ecomanager

الفئة: منصات خارجية  ·  أدنى خطة: Pro  ·  الصفحة: /dashboard/addons/ecomanager

Ecomanager منصة تجارة إلكترونية لإدارة الطلبات والتوصيل، ولكل متجر فيها عنوان خاص به على شكل https://your-store.ecomanager.dz. إذا كان فريقك يؤكد الطلبات ويشحنها من Ecomanager، فهذا التكامل يضع طلبات DZBuild في متجرك على Ecomanager دون أي نسخ يدوي، ويعيد حالة كل طلب في Ecomanager إلى الطلب المقابل له في DZBuild.

ماذا يفعل التكامل

• يرسل الطلبات الجديدة. الطلبات التي تصل من متجرك ومن صفحات الهبوط تذهب إلى Ecomanager في الخلفية ما دام خيار مزامنة الطلبات الجديدة مفعّلاً. وتصل إلى Ecomanager في حالة En confirmation.
• يترك لك إرسال البقية يدوياً. أي طلب آخر، مثل طلب تنشئه من صفحة الطلبات أو طلب وصل قبل الربط، ينتظر في صفحة التكامل حتى ترسله.
• يعيد الحالات. بعد تسجيل الـ webhooks، كل تغيير في حالة الطلب على Ecomanager يحدّث حالة الطلب في DZBuild، ورقم التتبع الذي يعطيه Ecomanager يُنسخ إلى الطلب.
• يتخطى الطلبات المرسلة. الطلب الذي يحمل مرجعاً من Ecomanager لا يُرسل مرة ثانية.

تغييرات الحالة تسير في اتجاه واحد فقط. DZBuild لا يرسل تغييرات الحالة إلى Ecomanager، فالطلب الذي تؤكده أو تلغيه في DZBuild يبقى بحالته السابقة في Ecomanager. قم بهذه التغييرات في Ecomanager واتركها تعود إلى DZBuild.

ماذا يستقبل Ecomanager

كل طلب يصل إلى Ecomanager ومعه:

• اسم الزبون ورقم هاتفه وولايته وبلديته وعنوانه، مع البريد الإلكتروني والملاحظة إن قدّمهما الزبون؛
• كل سطر منتج برمز SKU والكمية وسعر الوحدة؛
• تكلفة الشحن والتخفيض، ونوع التوصيل: إلى المنزل أو إلى Stop Desk.

رقم الهاتف يُرسل بالصيغة المحلية التي تبدأ بـ 0، فالرقم المكتوب بـ +213 يُعاد كتابته. والبلدية تُرسل باسمها الفرنسي حتى تطابق قائمة البلديات في Ecomanager.

قبل الإرسال، يبحث DZBuild عن كل منتج في متجرك على Ecomanager، أولاً برمز SKU ثم بالاسم. والمنتج الذي لا يجده يُنشأ في Ecomanager باسمه ورمز SKU وسعره. وإذا لم يكن للمنتج رمز SKU في DZBuild، يأخذ الرمز الذي يحمله في Ecomanager؛ وعندما يضطر DZBuild إلى إنشاء رمز، فإنه يبدأ بـ DZBUILD-. يرسل DZBuild رمز SKU واحداً لكل منتج، فمتغيّران من المنتج نفسه يصلان بالرمز نفسه.

الحالات التي تعود من Ecomanager

تصل حالات Ecomanager إلى DZBuild بطريقتين: عبر الـ webhooks بعد تسجيلها، وعندما تضغط زر التحديث على طلب مُرسل. وكل حالة تحلّ محل حالة الطلب في DZBuild:

حالة Ecomanager	تصبح حالة طلبك في DZBuild
En confirmation	قيد الانتظار
En préparation	مؤكد
En dispatch	جاري التحضير
En livraison	تم الشحن
Livrée, Encaissée	تم التوصيل
En retour, Retournée	مرتجع
Annulée	ملغي

يتبع المخزون الحالة الجديدة بالقاعدة نفسها التي تُطبّق عندما تغيّر الحالة بنفسك (انظر الطلبات). والتغيير الذي يصل عبر webhook يحدّث أيضاً سطر الطلب في Google Sheets إذا كان متجرك يستعمله، ويرسل لك تنبيه تحديث حالة الطلب نفسه الذي يصلك عندما تغيّر الحالة بنفسك (انظر الإشعارات).

مع تسجيل الـ webhooks، حذف طلب في Ecomanager لا يحذفه من DZBuild: يفقد الطلب مرجعه في Ecomanager ويعود إلى قائمة الطلبات التي تنتظر الإرسال، إلا إذا كان ملغياً.

كم يكلّف

ليس للتكامل سعر خاص به في DZBuild، ولا يُحتسب أي مبلغ على الطلبات المرسلة. البطاقة تسمح بالربط على خطط Pro وUnlimited وEnterprise. وعلى الخطة المجانية تُظهر شارة PRO وزر الترقية إلى Pro الذي يفتح /dashboard/subscribe. أما اشتراكك في Ecomanager فتفوتره Ecomanager.

كيف تربطه

1. في Ecomanager، سجّل الدخول إلى حسابك، وافتح Shop Configuration وانسخ API Token.
2. في DZBuild، افتح لوحة التحكم → الإضافات على /dashboard/addons، وابحث عن بطاقة Ecomanager في قسم منصات خارجية وانقر ربط Ecomanager.
3. في خانة رابط متجرك في Ecomanager، اكتب slug متجرك فقط، بدون https:// وبدون .ecomanager.dz. بالنسبة لـ https://my-shop.ecomanager.dz، اكتب my-shop. العنوان الكامل يظهر تحت الخانة أثناء الكتابة.
4. الصق المفتاح في خانة مفتاح API.
5. انقر اختبار وربط. يتحقق DZBuild من الـ slug والمفتاح مع متجرك على Ecomanager، ولا يحفظ الربط إلا إذا نجح التحقق. أما اختبار الاتصال فقط فيُجري التحقق نفسه دون حفظ أي شيء.
6. عندما يُعاد تحميل الصفحة وتظهر شارة متصل، اضغط تسجيل Webhooks حتى تعود حالات Ecomanager إلى DZBuild.

خيار مزامنة الطلبات الجديدة مفعّل منذ أول ربط، فطلبك القادم من المتجر يذهب إلى Ecomanager دون أي خطوة أخرى.

استعمال صفحة التكامل

العدادات

في أعلى الصفحة أربع خانات: إجمالي الطلبات وطلبات مرسلة وبانتظار المزامنة وآخر مزامنة. خانة بانتظار المزامنة تحسب كل طلب ليس له مرجع في Ecomanager، بما فيها الطلبات الملغاة، بينما القائمة التي تحتها لا تعرض الطلبات الملغاة.

طلبات بانتظار الإرسال

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

إذا فشل إرسال مجموعة، أرسل الطلبات واحداً واحداً بالزر الموجود في كل سطر. والرسالة تخبرك بما رفضه Ecomanager، مثل منتج لم يتمكن من إنشائه.

طلبات مرسلة

تعرض هذه القائمة آخر 20 طلباً مُرسلاً جرى تحديثها، مع رقم الطلب ومرجع Eco (مرجع الطلب في Ecomanager) والزبون وحالة الطلب في DZBuild. زر تحديث الحالة في كل سطر يقرأ الحالة الحالية للطلب في Ecomanager، ثم يحدّث حالة الطلب في DZBuild ورقم تتبعه.

إعدادات المزامنة

خيار مزامنة الطلبات الجديدة يشغّل الإرسال التلقائي أو يوقفه. اضغط حفظ بعد تغييره. أما سطر تحديث حالة الطلبات الذي تحته فليس مفتاح تشغيل: يكتب "تحديثات تلقائية عبر Webhooks"، لأن الحالات تعود عبر الـ webhooks.

Webhooks

زر تسجيل Webhooks ينشئ أربعة webhooks في حسابك على Ecomanager: واحد لتغييرات الحالة، وواحد لتغييرات حالة الشحن، وواحد لتغييرات حالة التأكيد، وواحد للطلبات المحذوفة. أسماؤها في Ecomanager تبدأ بـ DZBuild -. وبعد تسجيلها تُظهر البطاقة مسجّل ويصبح الزر إعادة التسجيل.

معلومات الاتصال

تعرض هذه البطاقة رابط متجرك وآخر ستة أحرف من المفتاح والحالة نشط. زر إلغاء الربط يطلب تأكيداً، ثم يوقف إرسال الطلبات واستقبال الحالات؛ والطلبات المرسلة سابقاً تبقى في Ecomanager. وعندما تربط من جديد، يعود خيار مزامنة الطلبات الجديدة مفعّلاً وعليك الضغط على تسجيل Webhooks مرة أخرى، لأن الـ webhooks الخاصة بالربط السابق لم تعد مقبولة.

عندما يحدث خطأ

تعرض الصفحة السبب في رسالة. وأكثرها شيوعاً:

• الرابط يجب أن يكون بصيغة https://slug.ecomanager.dz: خانة رابط المتجر فيها أكثر من الـ slug، مثل العنوان الكامل. اكتب الـ slug وحده، بحروف لاتينية وأرقام وشرطات فقط.
• مفتاح API غير صالح أو منتهي الصلاحية: انسخ المفتاح من جديد من Shop Configuration وأعد الربط.
• تجاوز حد الطلبات: Ecomanager يحدّ من عدد الاتصالات لبعض الوقت، فانتظر قليلاً وأعد المحاولة.
• خطأ في خادم Ecomanager: لم يُجب Ecomanager بشكل صحيح، فحاول لاحقاً.
• تعذّر إنشاء منتج: الرسالة تذكر اسم المنتج والسبب الذي أعاده Ecomanager.

إذا أبلغ Ecomanager أن حسابك موقوف، مثلاً بعد انتهاء الاشتراك أو بسبب فواتير غير مدفوعة، يلغي DZBuild الربط من تلقاء نفسه. وعندما يعود حسابك في Ecomanager نشطاً، اربطه من جديد وسجّل الـ webhooks. والطلبات التي لم تُرسل تبقى في طلبات بانتظار الإرسال، جاهزة للإرسال.

الأسئلة الشائعة

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

هل يمكن أن يصل طلب إلى Ecomanager مرتين؟ يحفظ DZBuild مرجع Ecomanager لكل طلب يرسله ويتخطى ذلك الطلب في الإرسالات اللاحقة، فالضغط على إرسال الكل مرة أخرى لا ينسخه.

غيّرت حالة طلب في DZBuild. لماذا ما زال Ecomanager يعرض الحالة القديمة؟ DZBuild لا يرسل تغييرات الحالة إلى Ecomanager. غيّر الحالة في Ecomanager بدلاً من ذلك: مع تسجيل الـ webhooks، تعود الحالة الجديدة إلى DZBuild.

تغيّرت حالة طلب في DZBuild دون أن ألمسه. لماذا؟ تغيّرت حالة الطلب في Ecomanager وطبّقها webhook. حالات Ecomanager تحلّ محل حالة DZBuild، كما في الجدول أعلاه.

أين أجد مفتاح API؟ في حسابك على Ecomanager، في صفحة Shop Configuration، تحت API Token.

هل يمكنني ربط Ecomanager على الخطة المجانية؟ لا. البطاقة تتطلب خطة Pro أو Unlimited أو Enterprise. المنصات الخارجية الأخرى مذكورة في كتالوج الإضافات، وFlash Manager يُربط على كل الخطط.