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

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

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

بقلم: Support

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

🎬 فيديو

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

الشركة

المعرف

ملاحظات

yalidine

API ناضج؛ الولايات والبلديات والمكاتب تُزامَن من API الخاص بـ Yalidine نفسها

82 بطاقة شركة (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 و Leopard Express و Colilog Express و Flash Delivery

abexexpress، leopardexpress، colilog، flashdelivery

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

Zimou Express

zimou

API مستقل لشركة Zimou Express

Colivraison

colivraison

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

Ecom Delivery

ecomdelivery

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

MDM Express

mdm

حقل API Key واحد فقط؛ كل منتج في الطلب يُطابَق مع منتجاتك في حسابك لدى MDM حسب SKU أو الاسم؛ لا مزامنة للأسعار، اضبطها يدوياً

Near Delivery

neardelivery

API Key + API Secret؛ توصيل إلى نقاط الاستلام (المكتب) فقط، وطلبات التوصيل للبيت تُرفَض؛ لا مزامنة للأسعار، اضبطها يدوياً

Elogistia

elogistia

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

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

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

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

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

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

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

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

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

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

  • إيقاف شركة مؤقتاً (أطفئ مفتاح تفعيل إرسال الطلبات عبر API في نافذتها) أو إلغاء الربط في أي وقت دون فقدان الطلبات السابقة.

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

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

  • سعر التوصيل إلى البيت وسعر المكتب لكل ولاية، ولكلٍّ منهما مفتاح تفعيل مستقلّ، فتستطيع تعطيل التوصيل للبيت أو للمكتب أو الاثنين معاً في ولاية بعينها.

  • قائمة الولايات نفسها: 58 ولاية (القائمة المتوافقة مع شركات التوصيل) أو 69 ولاية (تضيف 11 ولاية أحدث مثل أفلو وبريكة وبوسعادة). ومنتقي النمط في أعلى الصفحة. واجهات شركات التوصيل لا تقبل هذه الولايات الأحدث، لذلك يظهر خيار الـ 69 معطّلاً ما دامت هناك شركة مربوطة. وربط شركة توصيل لا يُعيد إلى نمط الـ 58 متجراً هو أصلاً على نمط الـ 69: اضغط 58 بنفسك.

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

📝 ملاحظة

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

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

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

البيانات

Yalidine

EcoTrack

ZR Express

Maystro

Noest

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

✅

✅

✅

✅

✅

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

✅

✅

✅

✅

✅

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

✅

✅

✅

✅

✅

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

✅

✅

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

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

✅

كل شركة مربوطة تدعم مزامنة الأسعار ما عدا MDM Express و Near Delivery، اللتين تضبط أسعارهما يدوياً؛ والشركة الموقوفة تبقى خارج قائمة المزامنة حتى تعيد تفعيلها. تُسعّر Maystro حسب البلدية، لذلك تُقدَّر كل ولاية انطلاقاً من بلدية مركزها، بينما تُرجع Noest سعراً للبيت وسعراً للمكتب لكل ولاية.

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

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

كل ما في الجدول أعلاه يُحدَّث تلقائياً مرة كل ليلة. أما أسعارك أنت فليست جزءاً من ذلك: أسعار /dashboard/shipping تتغيّر حين تشغّل مزامنة الأسعار بزر مزامنة الأسعار هناك (أو بمفتاح المزامنة عند ربط شركة) أو حين تعدّلها يدوياً. ولفرض تحديث ولايات شركة واحدة وبلدياتها ومكاتبها (وهو الحل لمشكلة «شركتي الجديدة لا تعرض أي مكاتب أو بلديات بعد»)، افتح بطاقة الشركة في /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. وأي تغيير في الحالة لدى الشركة يظهر عادةً على طلبك خلال دقائق. إلغاء الطلب من طرف الشركة يُعيد المخزون فوراً. أما المرتجع فيُعيد المخزون حين تُبلغ الشركة أن الطرد عاد إليك، أو حين تضغط استلمت المرتجع على الطلب، أو بعد 15 يوماً من بداية الإرجاع، أيّها جاء أولاً.

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

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

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

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

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

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

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

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

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

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

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

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

  5. اضغط ربط وحفظ. واختيارياً فعّل تعيين كشركة افتراضية. أول شركة تربطها تصبح الافتراضية تلقائياً، ويكون مفتاح مزامنة الأسعار مع حساب شركة التوصيل مفعّلاً لها مسبقاً، فتُسحب أسعار ولاياتها في الخلفية مباشرة بعد الربط.

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

إذا لم تكن شركتك في القائمة

اتبع هذه الخطوات بالترتيب.

  1. اسأل شركتك إن كانت تعمل على منصّة EcoTrack. نسبة كبيرة من شركات التوصيل الجزائرية تعمل عليها، و82 منها لها بطاقتها الجاهزة في الشبكة. وإذا كانت شركتك مستأجرة على EcoTrack بلا بطاقة خاصّة، فبطاقة Ecotrack مخصص تأخذ اسم الشركة ورابط API الخاص بها (عنوان https:// ينتهي بـ .ecotrack.dz) مع Bearer Token وتعمل بنفس الطريقة. راجع صفحة EcoTrack.

  2. اشحن يدوياً في هذه الأثناء. أكّد الطلب، سلّم الطرد للشركة، ثم علّم الطلب shipped من /dashboard/orders. تفقد التتبع الآلي فقط، ولا يتغيّر أي شيء آخر في الطلب.

  3. أرسل لنا الطلب. افتح تذكرة دعم تتضمّن اسم الشركة ورابط وثائق API الخاصة بها. رابط الوثائق هو الجزء المهمّ، لأنه بلا API عمومي لا يوجد ما نبني عليه. ولا نستطيع الوعد بتاريخ لأي شركة بعينها.

أسئلة شائعة

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

س: كيف يصلني مال COD؟ ج: تجمع شركة التوصيل المبلغ عند التسليم وتدفعه لك مباشرة، حسب جدولها هي وبالشروط التي اتفقت معها عليها. DZBuild لا تمسّ هذا المال ولا تدخل في التسوية أصلاً. انظر الدفع عند الاستلام.

س: شركتي ليست في القائمة، هل ما زلت أستفيد من DZBuild؟ ج: نعم. راجع القسم السابق مباشرة للخطوات الثلاث.

س: ولاية تخدمها شركتي غائبة عن جدول الأسعار. ج: هذا الجدول يعكس ما يُرجعه حسابك أنت لدى الشركة، وليس قائمة من DZBuild، لذلك يتغيّر كلّما غيّرت الشركة تغطية حسابك. اضغط مزامنة الأسعار في /dashboard/shipping لسحب أسعارك من جديد؛ أما تحديث البيانات على بطاقة الشركة فيُحدّث البلديات والمكاتب لا أسعارك. وإذا بقيت الولاية غائبة، افتح تذكرة دعم تتضمّن نصّ رسالة الخطأ ورقم الطلب، وأدخل ذلك الطلب مباشرة في منصّة الشركة نفسها ريثما نفحص الأمر.

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