EcoTrack هو API شحن مشترك يشغّل عائلة كبيرة من شركات التوصيل في الجزائر. ولا توجد بطاقة باسم «EcoTrack» تختارها — بل تختار بطاقة شركتك أنت، وتتحدث DZBuild معها عبر API EcoTrack بتوكن Bearer واحد. وهناك 37 شركة لها بطاقاتها الخاصة:

DHD، Conexlog، MSM Go، Rex Livraison، RB Livraison، Speed Delivery، Areex، Prest، Rocket Delivery، WorldExpress، BA Consult، Packers، 48Hr Livraison، Mono Hub، Anderson Delivery، GOLIVRI، Coyote Express، Salva Delivery، Distazero، FRET.Direct، TSL Express، Negmar Express، Ultra Express، OM Express، Med Express، Allo Livraison، Assil Delivery، Expedia Chrono، HHD Express، Imir Logistics، Navex Delivery، Swift Express، Univer Delivery، Colireli، FZ Delivery، Delivromail، PDEX.

إن كانت شركتك في هذه القائمة، اختر بطاقتها — لا حاجة لتكامل خاص.

اثنتان منها لا تعملان على نطاقات *.ecotrack.dz لكنهما مستأجرتان على EcoTrack رغم ذلك: DHD (platform.dhd-dz.com) و Conexlog (app.conexlog-dz.com). ولا واحدة منهما تكامل مباشر منفصل.

أما Mono Hub فحالة خاصة: البطاقة موجودة، لكن نطاقها mono.ecotrack.dz يُرجع حالياً 404 ويبدو أن المستأجر أُوقف. فإن كانت Mono Hub هي شركتك، اطلب منها رابط API الحالي واستعمل Custom EcoTrack.

ما تحتاجه

قيمة واحدة فقط من لوحة تحكم شركتك المبنيّة على EcoTrack:

API token (يُسمّى أحياناً "Bearer token" أو "API key" أو "clé API").

بعض اللوحات تفصلها بين شاشتين (account → API → generate). إن لم تجدها، اطلب من المسؤول تفعيل وصول API لحسابك.

ربط شركة EcoTrack في DZBuild

افتح /dashboard/link-shipping وابحث عن اسم شركتك في شبكة البطاقات (مثل DHD، Conexlog، MSM Go، …).
اضغط ربط على بطاقتها.
الصق API token في حقل البيانات الوحيد. شركات EcoTrack تستخدم حقلاً واحداً فقط.
اضغط اختبار الاتصال. تتصل لوحة التحكم بالشركة مباشرةً وتؤكّد صلاحية التوكن.
اضغط ربط وحفظ.

أما أسعار الولايات فتُحرَّر في الصفحة المنفصلة /dashboard/shipping.

Custom EcoTrack

إذا لم تكن شركتك في شبكة البطاقات لكنها مبنيّة على EcoTrack، اختر Custom EcoTrack وأدخل:

API URL الخاص بنسخة EcoTrack لشركتك — النطاق الأساسي فقط، مثل https://yourcourier.ecotrack.dz. تضيف DZBuild /api/v1 بنفسها.
اسماً ظاهراً. وما تكتبه هو ما يظهر في كل أنحاء لوحة التحكم لتلك الشركة.
توكن Bearer.

يجب أن يبدأ الرابط بـ https:// وأن يشير إلى نطاق عام؛ أما العناوين الداخلية وعناوين الاسترجاع (loopback) والعناوين المحجوزة فتُرفض لأسباب أمنية. ويحتفظ كل رابط مخصّص ببيانات بلدياته ومكاتبه وأسعاره المُزامَنة الخاصة، لذا فتغيير الرابط يبدأ مزامنة جديدة من الصفر. وفضّل دائماً البطاقة الأصلية إن وُجدت لشركتك.

ما الذي يُسحب

قائمة الولايات والبلديات التي تخدمها الشركة.
أسعار التوصيل للبيت لكل ولاية.
أسعار نقاط الاستلام لكل ولاية.
قائمة نقاط الاستلام لكل ولاية (تستعملها إضافة Stop Desk).

ماذا يحدث عند شحن طلب

عند تأكيد طلب يخص متجراً مرتبطاً بشركة EcoTrack، تُرسل DZBuild الطرد إلى نقطة EcoTrack الخاصة بالشركة بـ:

nom_client و telephone و telephone_2 و adresse.
code_wilaya + commune.
montant — مجموع الطلب (المنتجات + الشحن − الخصم)، أي ما يدفعه الزبون عند الاستلام. ولا تستعمل المجموع الفرعي إلا طرود عائلة Yalidine، لأن Yalidine تحاسب على رسوم التوصيل بشكل منفصل.
produit (ملخص المنتجات) و remarque (ملاحظتك) و weight و reference (رقم طلبك في DZBuild).
type — 1 للتوصيل، و 2 للتبديل.
stop_desk — 0 أو 1. ولا يوجد حقل delivery_type ولا stopdesk_id: يُعبَّر عن طرد المكتب بإرسال بلدية المكتب في commune مع stop_desk = 1.
fragile = 1، فقط عندما يكون المنتج مؤشَّراً كقابل للكسر.

تُرجع الشركة رقم تتبّع.

راية القابل للكسر (Fragile)

تأشير المنتج كـ Fragile يضيف fragile = 1 إلى طرود EcoTrack — وإلى طرود EcoTrack وحدها. فلا تستقبله أي عائلة شركات أخرى (وAPI الخاص بـ Yalidine يرفض المعاملات غير المعروفة رفضاً تاماً).

حد وصف المنتج

ملخص المنتجات المُرسَل إلى EcoTrack محدود بـ 255 حرفاً. والطلب الطويل متعدد المنتجات يُختصر على مراحل: القائمة الكاملة، ثم نفس القائمة بعد حذف لواحق المتغيّرات بين قوسين، ثم أول بضعة منتجات مع +N، وأخيراً ملخّص من نوع x8 ORD-12345.

طباعة بوردرو الشركة الرسمي

EcoTrack واحدة من عائلتين فقط (والأخرى Elogistia) يُطبع بوردروها الرسمي بصيغة PDF مباشرةً من DZBuild. فالضغط على طباعة الملصق في طلب EcoTrack ينزّل ملصق الشركة الرسمي كملف PDF — بما في ذلك نسخ Custom EcoTrack، اعتماداً على رابط API الذي حفظته.

كما تحصل طلبات EcoTrack على زر تأكيد الشحن الخاص بـ EcoTrack وحدها في لوحة تفاصيل الطلب، لتأكيد الشحنة لدى الشركة.

أخطاء شائعة وحلولها

العَرَض	السبب المحتمل	الحل
اختبار الاتصال يُرجع "unauthorized"	توكن خاطئ أو منتهٍ	أعد توليد التوكن من لوحة الشركة والصقه.
«يرجى إدخال رابط API» (في Custom EcoTrack)	حقل API URL فارغ	الصق النطاق الأساسي لشركتك.
«يرجى إدخال رابط صحيح يبدأ بـ https://» (في Custom EcoTrack)	الرابط ليس `https://`	أعد إدخاله ببروتوكول `https://`.
«يرجى إدخال رابط عام صحيح (لا يُسمح بعناوين داخلية)» (في Custom EcoTrack)	الرابط يشير إلى عنوان خاص أو loopback أو محجوز	استعمل النطاق العام للشركة. أما النطاق العام لكن الخاطئ فيظهر بدلاً من ذلك كفشل في اختبار الاتصال آتٍ من API الشركة نفسها.
الطلب أُنشئ بدون رقم تتبع	العنوان مرفوض من الشركة	تحقّق من العنوان على الطلب؛ غالباً بلدية ناقصة أو غير معروفة.
«لا يوجد مكتب استلام (Stop Desk) متاح في هذه الولاية لشركة …»	لا يوجد أي مكتب في تلك الولاية إطلاقاً	حوّل الطلب إلى توصيل بيت، أو اضغط تحديث البيانات على البطاقة إن كنت تظن أن قائمة المكاتب قديمة.

توجيه شحنات المكتب

شحنة المكتب في EcoTrack لا تُخفَّض أبداً إلى توصيل بيت. فإن لم يكن في بلدية الزبون أي مكتب، تعيد DZBuild توجيه الطرد إلى بلدية أخرى فيها مكتب داخل نفس الولاية، وتُبقي راية المكتب مفعّلة، وتكتب إعادة التوجيه في ملاحظة الطرد («مكتب الاستلام: X (بلدية الزبون: Y)»). ولا يفشل الإرسال إلا عندما لا تملك الولاية أي مكتب إطلاقاً، برسالة تطلب منك التحويل إلى توصيل بيت.

نصائح

لكثير من شركات EcoTrack تخصّصات إقليمية (مجموعة ولايات معيّنة). اسأل المسؤول عن أسرع المناطق قبل وعد التسليم في اليوم التالي.
عند تغيير الشركة داخل عائلة EcoTrack، يكفي ربط بطاقة الشركة الجديدة بتوكنها — الطلبات والعناوين وبيانات الزبائن تبقى كما هي.
استخدم Custom EcoTrack للشركات الجديدة التي لم تظهر بعد في لوحة DZBuild؛ تعمل ما دامت الشركة تكشف نقاط EcoTrack القياسية.

المقالات ذات الصلة