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

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

🎬 فيديو

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

الشركة	المعرف	ملاحظات
Yalidine	yalidine	API ناضج؛ الولايات والبلديات والمكاتب تأتي من حسابك أنت لدى Yalidine
عائلة EcoTrack	81 بطاقة شركة (dhd، conexlog، msmgo، rocketdelivery، andersondelivery، speeddelivery، worldexpress …) بالإضافة إلى customecotrack	لا يوجد معرّف اسمه ecotrack تختاره. فـ EcoTrack هو API مشترك بمصادقة Bearer Token، لذلك تختار بطاقة شركتك أنت
ZR Express	zrexpressnew	بطاقة واحدة مدمجة. الصق أي من زوجَي البيانات — تتعرّف DZBuild وحدها إن كنت على المنصة الجديدة أو على API Procolis الكلاسيكي
Maystro Delivery	maystro	API بحقل توكن واحد
Noest Express	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 من لوحة التحكم
Stop Desk	نوع توصيل + إضافة	استلام الزبون من مكتب شركة التوصيل، يعمل مع أي مزوّد مربوط

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

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

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

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

• ربط شركة: اضغط ربط على بطاقتها، أدخل البيانات، ثم احفظ.
• إدارة شركة مربوطة أصلاً: يتحوّل زر البطاقة إلى إدارة.
• تعيين شركة مربوطة كشركة افتراضية للمتجر (تعيين كشركة افتراضية).
• إيقاف شركة مؤقتاً أو إلغاء الربط في أي وقت دون فقدان الطلبات السابقة.

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

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

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

ملاحظة

صفحات الشحن غير موجودة في متاجر المنتجات الرقمية (يعيد الثيم الرقمي توجيه الصفحتين إلى لوحة التحكم). ويحتاج أعضاء الفريق إلى صلاحية 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 دج لسلة ثقيلة.

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

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

1. افتح /dashboard/link-shipping وابحث عن شركتك في شبكة البطاقات.
2. اضغط ربط على بطاقتها.
3. الصق البيانات التي زوّدتك بها الشركة (توكن، ID، GUID — حسب كل شركة، انظر الصفحات المخصّصة).
4. اضغط اختبار الاتصال.
5. اضغط ربط وحفظ. واختيارياً فعّل تعيين كشركة افتراضية.
6. انتقل إلى /dashboard/shipping لمزامنة أسعار الولايات من المزوّد أو لضبطها يدوياً.

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

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

1. اسأل شركتك إن كانت تعمل على منصّة EcoTrack. نسبة كبيرة من شركات التوصيل الجزائرية تعمل عليها، و81 منها لها بطاقتها الجاهزة في الشبكة. وإذا كانت شركتك مستأجرة على EcoTrack بلا بطاقة خاصّة، فبطاقة Custom EcoTrack تأخذ رابط API الخاص بها مع Bearer Token وتعمل بنفس الطريقة. راجع صفحة EcoTrack.
2. اشحن يدوياً في هذه الأثناء. أكّد الطلب، سلّم الطرد للشركة، ثم علّم الطلب shipped من /dashboard/orders. تفقد التتبع الآلي فقط، ولا يتغيّر أي شيء آخر في الطلب.
3. أرسل لنا الطلب. افتح تذكرة دعم تتضمّن اسم الشركة ورابط وثائق API الخاصة بها. رابط الوثائق هو الجزء المهمّ، لأنه بلا API عمومي لا يوجد ما نبني عليه. ولا نستطيع الوعد بتاريخ لأي شركة بعينها.

أسئلة شائعة

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

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

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

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