تخط وانتقل إلى المحتوى الرئيسي

نظرة عامة على شركات التوصيل

اربط شركات التوصيل الجزائرية بـ DZBuild لتنتقل الطلبات وأرقام التتبع ونقاط الاستلام تلقائياً بين متجرك وواجهة برمجة التطبيقات (API) الخاصة بالشركة.

بقلم: Support

تدعم DZBuild كبرى شركات التوصيل في الجزائر. بمجرد ربط شركة توصيل في لوحة التحكم، تستطيع DZBuild إرسال الطلبات الجديدة إلى API الشركة، إعادة أرقام التتبع للزبون، وسحب التسعيرات وقائمة نقاط الاستلام مباشرة من المزوّد.

🎬 فيديو

شركات التوصيل المدعومة

الشركة

المعرف

ملاحظات

yalidine

جميع الـ 58 ولاية، شبكة واسعة من نقاط الاستلام، API ناضج

37 بطاقة شركة (dhd، conexlog، msmgo، rocketdelivery، andersondelivery، speeddelivery، worldexpress …) بالإضافة إلى customecotrack

لا يوجد معرّف اسمه ecotrack تختاره — EcoTrack هو API مشترك بمصادقة Bearer Token، لذلك تختار بطاقة شركتك أنت

zrexpressnew

بطاقة واحدة مدمجة. الصق أي من زوجَي البيانات — تتعرّف DZBuild وحدها إن كنت على المنصة الجديدة أو على API Procolis الكلاسيكي

maystro

تغطية وطنية قوية، API بحقل توكن واحد

noest

API Token + User GUID، تغطية مركّزة على الجزائر

Abex Express

abexexpress

نفس بنية API Procolis المستعملة في ZR Express الكلاسيكي، لكن بـ Token و Key خاصّين بها

Zimou Express

zimou

API مستقل لشركة Zimou Express بتغطية وطنية

Colivraison

colivraison

API مستقل لشركة Colivraison

Ecom Delivery

ecomdelivery

API مستقل لشركة Ecom Delivery

Elogistia

elogistia

حقل API Key واحد فقط، وهي واحدة من عائلتين فقط تُطبع وصولاتها (bordereau) الرسمية بصيغة PDF من لوحة التحكم

نوع توصيل + إضافة

استلام الزبون من مكتب شركة التوصيل، يعمل مع أي مزوّد مربوط

خدمة Yalidine في DZBuild تعمل أيضاً مع Yalitec وGuepex وEasy & Speed — كلها تشترك في نفس بنية API وتظهر تحت معرفاتها الخاصة في لوحة التحكم.

كل من DHD و Conexlog هما مستأجران على منصة EcoTrack وليسا تكاملين منفصلين — الفرق الوحيد أنهما يعملان على نطاقيهما الخاصين (platform.dhd-dz.com و app.conexlog-dz.com) بدل *.ecotrack.dz. راجع صفحة EcoTrack للقائمة الكاملة المكوّنة من 37 شركة.

أين تربط شركة التوصيل

تُربط شركات التوصيل من /dashboard/link-shipping — في القائمة الجانبية: إعدادات التوصيل ← «ربط شركة التوصيل». الصفحة عبارة عن شبكة بطاقات قابلة للبحث. من هناك تستطيع:

  • ربط شركة: اضغط ربط على بطاقتها، أدخل البيانات، ثم احفظ.

  • إدارة شركة مربوطة أصلاً: يتحوّل زر البطاقة إلى إدارة.

  • تعيين شركة مربوطة كشركة افتراضية للمتجر (تعيين كشركة افتراضية).

  • إيقاف شركة مؤقتاً أو إلغاء الربط في أي وقت دون فقدان الطلبات السابقة.

الشارات الملوّنة على البطاقة تعكس حالة الربط فقط، وليست فحصاً مباشراً للبيانات: الشارة الخضراء تعني أن الشركة مربوطة / افتراضية / نشطة / موقوفة. أما شارة بيانات API منتهية الحمراء فلا تظهر إلا بعد تكرار فشل المصادقة خلال آخر 30 يوماً. للتحقق من البيانات الآن، افتح البطاقة واضغط اختبار الاتصال.

أما الصفحة المنفصلة /dashboard/shipping («أسعار الشحن») فهي جدول أسعار الشحن لكل ولاية. هناك تجد:

  • سعر التوصيل إلى البيت وسعر المكتب لكل ولاية من الولايات الـ 58، مع مفتاح تفعيل التوصيل للمكتب لكل ولاية.

  • مزامنة الأسعار — تسحب أسعار البيت والمكتب لكل ولاية من الشركة المربوطة.

📝 ملاحظة

صفحات الشحن غير موجودة في متاجر المنتجات الرقمية (يعيد الثيم الرقمي توجيه الصفحتين إلى لوحة التحكم). ويحتاج أعضاء الفريق إلى صلاحية shipping.view لفتحهما و shipping.edit لتعديل أي شيء، كما يجب أن يكون اشتراك المتجر نشطاً.

إذا كان عملك يحتاج إلى أسعار شحن خاصة لكل منتج (بضائع ثقيلة، رسوم حسب الحجم، شحن مجاني لمنتجات محددة)، فعّل إضافة Custom Product Shipping. تتطلب هذه الإضافة خطة Pro أو أعلى (تفعيلها على الخطة المجانية يُرفض برسالة «هذه الإضافة تتطلب خطة pro»)، وهي غير متاحة على ثيم digital، ولها صفحتها الخاصة على /dashboard/addons/custom-shipping. تمنحك سعراً ثابتاً لكل منتج أو تسعيراً لكل ولاية، وشحناً مجانياً لكل منتج، واعتماد السعر الأعلى في السلال المختلطة، واختصاراً لـ«النسخ من أسعار المتجر».

ما الذي يُسحب من شركة التوصيل

البيانات

Yalidine

EcoTrack

ZR Express

Maystro

Noest

قائمة الولايات

البلديات لكل ولاية

أسعار البيت + نقطة الاستلام

قائمة نقاط الاستلام

المنصة الجديدة ✅ / الكلاسيكية: لا تنشر قائمة مكاتب

✅ (نقاط استلام)

لا يوجد مزوّد مربوط مستثنى من مزامنة الأسعار. تُسعّر Maystro حسب البلدية، لذلك تُقدَّر كل ولاية انطلاقاً من بلدية مركزها، بينما تُرجع Noest سعراً للبيت وسعراً للمكتب لكل ولاية.

منصة ZR Express الكلاسيكية (Procolis) لا تنشر قائمة مكاتب: لذلك تُعتبر الولاية كاملةً مؤهّلة للتوصيل للمكتب كلما كان سعر Stopdesk فيها أكبر من صفر، ويرى الزبون خياراً عاماً على مستوى البلدية باسم «وكالة ZR Express»، ثم تختار ZR نقطة الاستلام الفعلية عند الإرسال. أما منصة ZR الجديدة فتُرجع قائمة مراكز حقيقية.

تحديث بيانات المزوّد

كل ما سبق يُحدَّث تلقائياً مرة كل ليلة. ولفرض التحديث لشركة واحدة — وهو الحل لمشكلة «شركتي الجديدة لا تعرض أي مكاتب أو بلديات بعد» — افتح بطاقة الشركة في /dashboard/link-shipping واضغط تحديث البيانات داخل النافذة. لا يظهر هذا الزر إلا لشركة مربوطة أصلاً، وله مهلة انتظار 5 دقائق لكل شركة.

ماذا يحدث عند إرسال طلب إلى شركة التوصيل

  1. تؤكّد الطلب من /dashboard/orders.

  2. في نافذة الإرسال إلى التوصيل تختار الشركة المربوطة التي ستشحن الطلب، فتستدعي DZBuild API تلك الشركة بإرسال اسم الزبون ورقمه وعنوانه وقائمة المنتجات ومبلغ COD.

  3. تُرجع الشركة رقم تتبّع يُحفَظ على الطلب.

  4. ينتقل الطلب إلى حالة processing — لكن فقط إذا كان pending أو confirmed؛ أما الحالة الأبعد فتُترك كما هي. كما تحفظ DZBuild رقم التتبع واسم الشركة ووقت الإرسال.

  5. يصبح الطلب shipped تلقائياً بمجرد أن ترى مزامنة التتبع حالة استلام أو نقل، ثم delivered (أو returned / cancelled).

تختلف البيانات المرسلة حسب عائلة الشركة، وهذه أكثر نقطة يُخطئ فيها التجار:

ما الذي يُرسَل

عائلة Yalidine

عائلة EcoTrack

ZR Express (الكلاسيكي)

ZR Express (الجديد)

Maystro

Noest

مبلغ COD

price = المجموع الفرعي

montant = مجموع الطلب

Total = مجموع الطلب

amount = مجموع الطلب

product_price = مجموع الطلب

montant = مجموع الطلب

مرجع المكتب

is_stopdesk + stopdesk_id

stop_desk 0/1 (البلدية = بلدية المكتب)

TypeLivraison 0/1

deliveryType: "pickup-point" + hubId

delivery_type: 2

stop_desk: 1 + station_code

الوزن

لا يُرسَل

لا يُرسَل

لا يُرسَل

poids

القيمة المعلنة

عائلة Yalidine هي الوحيدة التي تستقبل قيمة معلنة و stopdesk_id، وهي الوحيدة التي يكون فيها مبلغ COD هو المجموع الفرعي بدل مجموع الطلب (لأن Yalidine تحاسب على رسوم التوصيل بشكل منفصل).

طباعة الملصقات

زر طباعة الملصق يجلب وصل (bordereau) الشركة الرسمي بصيغة PDF فقط لشركات عائلة EcoTrack ولـ Elogistia (التي يأتي وصلها بثلاثة مقاسات — 15×20 و 10×15 و 10×10 سم، والافتراضي 10×15). أما بقية الشركات فيُطبع لها وصل DZBuild الخاص بصيغة HTML. روابط ملصقات Yalidine و Maystro و Noest تُلتقط وتُحفَظ على الطلب، لكن لا يوجد اليوم أي زر في لوحة التحكم يفتحها — اطبعها من بوابة الشركة نفسها.

مزامنة التتبع

تستعلم DZBuild تلقائياً من كل شركة مربوطة عن الطلبات الجارية لديها وتنقلها بنفسها: processing → shipped → delivered، أو returned / cancelled. وأي تغيير في الحالة لدى الشركة يظهر عادةً على طلبك خلال دقائق. عمليات الإرجاع والإلغاء تُعيد المخزون تلقائياً.

نقطتان تستحقان الانتباه:

  • أي حالة من الشركة لا تتعرّف عليها DZBuild تترك الطلب دون تغيير.

  • الطرد الذي لا تجده الشركة لا يُلغى أبداً تلقائياً — يُترك كما هو ويُعاد فحصه في الدورة التالية. لا يُلغى الطلب إلا بحالة cancelled صريحة من الشركة.

رسم الوزن الإضافي

الطرود التي يتجاوز وزنها 5 كغ تضيف رسماً فوق سعر الولاية عند الدفع: 50 دج لكل كيلوغرام إضافي، ترتفع إلى 100 دج لكل كيلوغرام إضافي في ولايات الجنوب الكبير الـ 13 (أدرار، بشار، تمنراست، البيّض، إليزي، تندوف، النعامة، تيميمون، برج باجي مختار، بني عباس، عين صالح، عين قزام، جانت) عندما تكون الشركة Yalidine أو Yalitec أو Guepex. أما Easy & Speed فهي مستثناة عمداً من سعر الجنوب الكبير.

يُحسب هذا الرسم من أوزان منتجاتك ويُضاف إلى ما يدفعه الزبون — ولا يظهر كسطر في جدول أسعار الشحن، لذلك قد تُسعَّر ولاية سعرها 600 دج بأكثر من 600 دج لسلة ثقيلة.

خطوات الربط (نظرة سريعة)

  1. افتح /dashboard/link-shipping وابحث عن شركتك في شبكة البطاقات.

  2. اضغط ربط على بطاقتها.

  3. الصق البيانات التي زوّدتك بها الشركة (توكن، ID، GUID — حسب كل شركة، انظر الصفحات المخصّصة).

  4. اضغط اختبار الاتصال.

  5. اضغط ربط وحفظ. واختيارياً فعّل تعيين كشركة افتراضية.

  6. انتقل إلى /dashboard/shipping لمزامنة أسعار الولايات من المزوّد أو لضبطها يدوياً.

أسئلة شائعة

س: هل أستطيع ربط أكثر من شركة توصيل؟ ج: نعم — اربط ما شئت من الشركات، وعيّن واحدة منها كافتراضية للمتجر. وعند إرسال طلب (فردياً أو بالجملة) تختار الشركة من قائمة منسدلة في نافذة الإرسال إلى التوصيل، فتشحنه DZBuild عبر API تلك الشركة. لا شيء مضطر لأن يُشحن يدوياً. أما في طلبات المكتب، فالشركات التي لا تملك مكتباً في بلدية الزبون تظهر معطّلة في تلك القائمة بوسم «لا يوجد مكتب».

س: كيف يصلني مال COD؟ ج: تجمع شركة التوصيل المبلغ عند التسليم وتُسوّيه إلى حسابك البنكي/CCP حسب جدولها (أسبوعياً عادة). DZBuild لا تتولى مرحلة المال. انظر الدفع عند الاستلام.

س: شركتي ليست في القائمة — هل ما زلت أستفيد من DZBuild؟ ج: نعم. اشحن يدوياً: أكّد الطلب، سلّم الطرد للشركة، ثم علّم الطلب shipped من /dashboard/orders. لن تحصل على تتبع آلي، لكن باقي الأمور تعمل. وقبل أن تفترض حاجتك لتكامل خاص، اسأل شركتك إن كانت تعمل على منصة EcoTrack — فهناك 37 شركة EcoTrack لها بطاقاتها الجاهزة، وبطاقة Custom EcoTrack تغطي أي مستأجر EcoTrack آخر إن كان لديك رابط API الخاص به.

هل أجاب هذا عن سؤالك؟