EcoTrack

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

DHD، Conexlog، MSM Go، Rex Livraison، RB Livraison، Speed Delivery، Areex، Prest، Rocket Delivery، Worldexpress، BaConsult، Packers، 48hr Livraison، MonoHub، Anderson Delivery، Golivri، Coyote Express، Salva Delivery، Distazero، Fretdirect، TSL Express، Negmar Express، Ultra Express، OM Express، MedExpress، Allo Livraison، Assil Delivery، Expedia Chrono، HHD Express، Imir، Navex Delivery، Swift Express، Univer Delivery، Colireli، FZ Delivery، Delivromail، Pdex.

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

ما تحتاجه

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

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

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

ربط شركة EcoTrack في DZBuild

1. افتح /dashboard/shipping.
2. اضغط Link provider واختر شركتك بالاسم (مثل DHD، Conexlog، MSM Go، …).
3. الصق API token في الحقل الوحيد. شركات EcoTrack تستخدم حقلاً واحداً فقط.
4. اضغط Test API. تتصل لوحة التحكم بالشركة مباشرةً وتؤكّد صلاحية التوكن.
5. احفظ.

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

• API URL الخاص بنسخة EcoTrack لشركتك (مثل https://yourcourier.ecotrack.dz).
• اسماً ظاهراً للشركة.
• التوكن.

ما الذي يُسحب

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

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

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

• اسم الزبون ورقمه وعنوانه.
• رمز الولاية الوجهة والبلدية.
• المجموع الفرعي كمبلغ COD.
• الوزن وملخص المنتجات.
• delivery_type = home أو stopdesk، مع stopdesk_id صحيح لتوصيل المكتب.

تُرجع الشركة رقم تتبّع و(في معظم نسخ EcoTrack) رابط ملصق/بوردرو للطباعة وإلصاقه على الطرد.

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

العَرَض	السبب المحتمل	الحل
Test API يُرجع "unauthorized"	توكن خاطئ أو منتهٍ	أعد توليد التوكن من لوحة الشركة والصقه.
"API URL not reachable" (في Custom EcoTrack)	النطاق خاطئ	تحقق من URL — أغلب نسخ EcoTrack على https://<name>.ecotrack.dz.
الطلب أُنشئ بدون رقم تتبع	العنوان مرفوض من الشركة	اطّلع على سجل الطلب؛ غالباً بلدية ناقصة أو غير معروفة.
شحنة المكتب تتحول إلى توصيل بيت	لم يُختر stopdesk_id	اطلب من الزبون اختيار مكتب أو حوّل إلى توصيل بيت.

نصائح

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