# Maystro Delivery

Maystro Delivery شركة توصيل وطنية بحضور قوي في الولايات الجزائرية. التكامل من أبسط ما يكون: توكن API واحد فقط هو كل ما تحتاجه.

## ما تحتاجه[​](#ما-تحتاجه "رابط مباشر إلى ما تحتاجه")

* قيمة واحدة، اسمها **Authentication Token** في نافذة البيانات، تُصدر من لوحة تحكم Maystro للتجار. تصادق Maystro بالترويسة `Authorization: Token <value>` — وهي ليست توكن Bearer.

إن لم يتح حسابك وصول API، تواصل مع Maystro لتفعيله.

## ربط Maystro في DZBuild[​](#ربط-maystro-في-dzbuild "رابط مباشر إلى ربط Maystro في DZBuild")

1. افتح **[`/dashboard/link-shipping`](https://dzbuild.com/dashboard/link-shipping)** واعثر على بطاقة **Maystro**.
2. اضغط **ربط**.
3. الصق **Authentication Token** في حقل البيانات الوحيد.
4. اضغط **اختبار الاتصال**. تستدعي DZBuild Maystro مباشرةً وتؤكّد صلاحية التوكن.
5. اضغط **ربط وحفظ**.

أما أسعار الولايات فتُحرَّر في الصفحة المنفصلة [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping).

## ما الذي يُسحب[​](#ما-الذي-يُسحب "رابط مباشر إلى ما الذي يُسحب")

* قائمة **الولايات** التي تخدمها Maystro.
* **البلديات** لكل ولاية.
* **أسعار البيت + المكتب** لكل ولاية — انظر أدناه.
* **قائمة نقاط الاستلام** لـ[مُختار Stop Desk](https://dzbuild.com/ar/ar/docs/couriers/stop-desk.md).

### الأسعار[​](#الأسعار "رابط مباشر إلى الأسعار")

أسعار Maystro **قابلة** للمزامنة. فـ **مزامنة الأسعار** تقرأ تسعيرة التوصيل الخاصة بـ Maystro لكل ولاية وتملأ سعر البيت وسعر المكتب معاً.

مع تحفّظ واحد يستحق المعرفة: تُسعّر Maystro حسب **البلدية** لا حسب الولاية، لذلك تقارب DZBuild كل ولاية ببلدية مركزها. والولاية التي لا تُرجع بلدية مركزها أي تسعيرة تبقى على 0 — اضبطها يدوياً في [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping).

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

تُقرأ قائمة مكاتب Maystro من بلدية مركز كل ولاية. ولا تبحث DZBuild في باقي بلديات الولاية إلا عندما لا يكون في بلدية المركز أي مكتب. لذلك لا يظهر المكتب الموجود في بلدية طرفية إذا كان في بلدية مركز ولايته مكتب أصلاً، والضغط على **تحديث البيانات** لا يغيّر ذلك. ويبقى التوصيل للمكتب نفسه متاحاً في كل ولاية تُسعّر فيها Maystro المكتب.

ولا تُدرَج سوى مكاتب Maystro الخاصة؛ أما نقاط استلام الشركاء فغير مدعومة.

## ماذا يحدث عند شحن طلب[​](#ماذا-يحدث-عند-شحن-طلب "رابط مباشر إلى ماذا يحدث عند شحن طلب")

تُرسل DZBuild الطلب إلى Maystro بالاسم والهاتف والعنوان والولاية الوجهة والبلدية على شكل **معرّف البلدية الرقمي لدى Maystro** وقائمة المنتجات ورقم طلبك كـ `external_order_id` والقيمة `product_price` — وهي **مجموع الطلب** لا المجموع الفرعي.

أمران لا تستقبلهما Maystro:

* **الوزن** لا يُرسَل إلى Maystro إطلاقاً.
* **لا معرّف مكتب.** يُعبَّر عن التوصيل للمكتب بـ `delivery_type: 2` فقط (1 = بيت، 3 = نقطة استلام). ولا يقبل API الخاص بـ Maystro أي حقل للمكتب، لذلك حين يختار الزبون مكتباً تُرسل DZBuild بلدية ذلك المكتب مع راية المكتب، فيُوجَّه الطرد إلى بلدية فيها مكتب.

يُستخرَج معرّف البلدية من بيانات البلديات المُزامَنة في DZBuild ثم من بحث مباشر؛ وإن تعذّر استخراجه يفشل الإرسال برسالة «لم يتم العثور على البلدية …».

تُرجع Maystro **رقم تتبع** (يُحفظ على الطلب) ورابط ملصق.

طباعة ملصق Maystro

لا يوجد أي زر في لوحة التحكم يفتح رابط ملصق Maystro — والضغط على **طباعة الملصق** في طلب Maystro يطبع وصل DZBuild الخاص بصيغة HTML. أما بوردرو Maystro الرسمي فاطبعه من بوابة Maystro.

## أخطاء شائعة وحلولها[​](#أخطاء-شائعة-وحلولها "رابط مباشر إلى أخطاء شائعة وحلولها")

| العَرَض                                  | السبب المحتمل                                              | الحل                                                                                               |
| ---------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| اختبار الاتصال يفشل فوراً                | توكن خاطئ أو منتهٍ                                         | انسخ Authentication Token جديداً من Maystro وأعد لصقه.                                             |
| `لم يتم العثور على البلدية …`            | البلدية الموجودة على الطلب ليس لها معرّف بلدية لدى Maystro | صحّح البلدية على الطلب، أو اضغط **تحديث البيانات** على البطاقة لإعادة مزامنة قائمة بلديات Maystro. |
| بعض الولايات ما زالت بسعر 0 بعد المزامنة | لم تُرجع Maystro أي تسعيرة لبلدية مركز تلك الولاية         | اضبط تلك الولايات يدوياً في [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping).       |

## نصائح[​](#نصائح "رابط مباشر إلى نصائح")

* يقرأ اختبار الاتصال قائمة ولايات Maystro، لذلك يعمل حتى على حساب لا شحنات فيه بعد. يكفي أن تُظهر DZBuild أخضر لتعرف أن التوكن صالح.
* بعد مزامنة الأسعار، راجع الجدول في [`/dashboard/shipping`](https://dzbuild.com/dashboard/shipping) — فمقاربة بلدية المركز قد تكون أعلى أو أدنى قليلاً مما تدفعه فعلاً في البلديات الطرفية.
* Maystro خيار جيد كمكمّل لـ Yalidine حين تريد بديلاً لمناطق معيّنة.