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

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

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

## ماذا يفعل التكامل[​](#ماذا-يفعل-التكامل "رابط مباشر إلى ماذا يفعل التكامل")

* **يرسل الطلبات الجديدة.** الطلبات التي تصل من متجرك ومن [صفحات الهبوط](https://dzbuild.com/ar/ar/docs/selling/landing-pages.md) تذهب إلى Ecomanager في الخلفية ما دام خيار **مزامنة الطلبات الجديدة** مفعّلاً. وتصل إلى Ecomanager في حالة **En confirmation**.
* **يترك لك إرسال البقية يدوياً.** أي طلب آخر، مثل طلب تنشئه من صفحة [الطلبات](https://dzbuild.com/ar/ar/docs/selling/orders.md) أو طلب وصل قبل الربط، ينتظر في صفحة التكامل حتى ترسله.
* **يعيد الحالات.** بعد تسجيل الـ `webhooks`، كل تغيير في حالة الطلب على Ecomanager يحدّث حالة الطلب في DZBuild، ورقم التتبع الذي يعطيه Ecomanager يُنسخ إلى الطلب.
* **يتخطى الطلبات المرسلة.** الطلب الذي يحمل مرجعاً من Ecomanager لا يُرسل مرة ثانية.

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

## ماذا يستقبل Ecomanager[​](#ماذا-يستقبل-ecomanager "رابط مباشر إلى ماذا يستقبل Ecomanager")

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

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

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

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

## الحالات التي تعود من Ecomanager[​](#الحالات-التي-تعود-من-ecomanager "رابط مباشر إلى الحالات التي تعود من 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              | ملغي                      |

يتبع المخزون الحالة الجديدة بالقاعدة نفسها التي تُطبّق عندما تغيّر الحالة بنفسك (انظر [الطلبات](https://dzbuild.com/ar/ar/docs/selling/orders.md)). والتغيير الذي يصل عبر `webhook` يحدّث أيضاً سطر الطلب في [Google Sheets](https://dzbuild.com/ar/ar/docs/operations/google-sheets.md) إذا كان متجرك يستعمله، ويرسل لك تنبيه تحديث حالة الطلب نفسه الذي يصلك عندما تغيّر الحالة بنفسك (انظر [الإشعارات](https://dzbuild.com/ar/ar/docs/operations/notifications.md)).

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

## كم يكلّف[​](#كم-يكلّف "رابط مباشر إلى كم يكلّف")

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

## كيف تربطه[​](#كيف-تربطه "رابط مباشر إلى كيف تربطه")

1. في Ecomanager، سجّل الدخول إلى حسابك، وافتح **Shop Configuration** وانسخ **API Token**.
2. في DZBuild، افتح **لوحة التحكم → الإضافات** على [`/dashboard/addons`](https://dzbuild.com/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")

زر **تسجيل 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. المنصات الخارجية الأخرى مذكورة في [كتالوج الإضافات](https://dzbuild.com/ar/ar/docs/addons/overview.md)، و[Flash Manager](https://dzbuild.com/ar/ar/docs/addons/flash-manager.md) يُربط على كل الخطط.