Noest Express شركة توصيل جزائرية لها API مستقل خاص بها — وهي ليست مستأجراً على EcoTrack. ولدى DZBuild تكامل مخصّص لـ Noest، فيكفيك قيمتان اثنتان لربطها.
ما تحتاجه
API Token
User GUID
كلاهما من لوحة تحكم Noest للتجار. يميّز الـ GUID متجرك داخل Noest، والتوكن يصادق طلبات API.
ربط Noest في DZBuild
افتح
/dashboard/link-shippingواعثر على بطاقة Noest.اضغط ربط.
الصق API Token في الحقل الأول و User GUID في الثاني.
اضغط اختبار الاتصال. تتحقّق DZBuild من البيانات مباشرة.
اضغط ربط وحفظ.
أما أسعار الولايات فتُحرَّر في الصفحة المنفصلة /dashboard/shipping.
التأكيد التلقائي — اقرأ هذا قبل أول إرسال
تحتوي نافذة البيانات على مفتاح تأكيد تلقائي خاص بـ Noest وحدها، وهو مُطفأ افتراضياً.
وهو مُطفأ، يُنشَأ الطلب الذي ترسله DZBuild إلى Noest كـ مسودة قابلة للتعديل. ولا يراه فريق اللوجستيك في Noest إطلاقاً حتى تفتح لوحة Noest وتؤكّده بنفسك.
وإن شغّلت المفتاح، أكّدت DZBuild كل طلب فور إنشائه (بوسم «تم التأكيد تلقائياً»). وإن فشل نداء التأكيد هذا، يبقى الطلب مُنشأً وتضع DZBuild عليه وسم «يحتاج تأكيد يدوي من لوحة NOEST» — فأكّده بنفسك من لوحة Noest. والمقابل: الطلب المؤكَّد لم يعد قابلاً للتعديل في Noest.
ما الذي يُسحب
قائمة الولايات التي تخدمها Noest.
البلديات لكل ولاية، مطابَقةً مع قائمة بلديات Noest المُزامَنة.
أسعار البيت + المكتب لكل ولاية: مزامنة الأسعار تملأ سعر البيت وسعر المكتب لكل ولاية. ويبقى بإمكانك تجاوز أي ولاية يدوياً في
/dashboard/shipping.قائمة المكاتب، مع اسم كل مكتب وعنوانه وهاتفه ورابط خريطته — وكلها تعرضها إضافة Stop Desk. ولكل مكتب رمز يدل رقمه على الولاية، مثلاً
16Aفي الولاية 16.
ماذا يحدث عند شحن طلب
تُرسل DZBuild الطلب إلى Noest بالاسم ورقم الهاتف (يصل إلى Noest رقم هاتف واحد فقط — أما الرقم الثاني للزبون فيُحفَظ على الطلب في DZBuild ولا يُمرَّر) والعنوان والولاية والبلدية الوجهة وملخص المنتجات ومرجع طلبك، إضافة إلى:
montant— مجموع الطلب (المنتجات مع الشحن) لا المجموع الفرعي.poids— الوزن بالكيلوغرامات الصحيحة، وقيمته الافتراضية 1.can_open— يُضبَط بحيث يُسمح للزبون بفتح الطرد قبل الدفع.type_id— 1 لتوصيل عادي، و 2 للتبديل، و 3 للاسترجاع. والاسترجاع يفرض مبلغ COD على 0 حسب مواصفات Noest.لتوصيل المكتب:
stop_desk: 1معstation_code(رمز المكتب لدى Noest، مثل16A) يُستخرَج من قائمة المكاتب المُزامَنة. أماcommune_idفهو حقل منفصل يُرسَل عند معرفته — وليس هو مرجع المكتب.
وإن لم يُعثر على أي محطة في الولاية يُرفَض الإرسال برسالة «لا توجد نقطة استلام (Stop Desk) متاحة في ولاية …» بدل أن يُخفَّض إلى توصيل بيت.
يجري تحديد البلدية أولاً مقابل قائمة بلديات Noest المُزامَنة، ثم بمطابقة مباشرة عبر API. وإن لم يطابق أيّ منهما، يُرفَض الإرسال — وتحصل على رسالة خطأ بالعربية تسمّي البلدية مع خمس بلديات قريبة مقترحة كحد أقصى، ولا يُنشَأ أي رقم تتبع. تُفضّل DZBuild الرفض على مخاطرة التسليم إلى بلدية خاطئة.
تُرجع Noest رقم تتبع. ويوجد على API Noest رابط لتنزيل البوردرو، لكن لا يفتحه أي زر في لوحة تحكم DZBuild — والضغط على طباعة الملصق في طلب Noest يطبع وصل DZBuild الخاص بصيغة HTML. أما ملصق Noest الرسمي فاطبعه من لوحة Noest.
وتحدّ Noest من المعدل بصرامة، لذلك تُنظَّم عمليات الإرسال بالجملة زمنياً وتُعاد المحاولة تلقائياً عندما يُرجع API استجابة تجاوز الحد.
أخطاء شائعة وحلولها
العَرَض | السبب المحتمل | الحل |
«فشل اختبار الاتصال» | توكن خاطئ أو GUID خاطئ أو الاثنان | أعد نسخ كل قيمة من لوحة Noest؛ من السهل تبديل الحقلين. |
«البلدية … غير موجودة في قاعدة بيانات NOEST» | Noest لا تعرف كتابة تلك البلدية | اختر إحدى البلديات المقترحة المعروضة مع الخطأ، أو اضغط تحديث البيانات على بطاقة Noest لإعادة مزامنة قائمة البلديات ثم أعد الإرسال. |
«لا توجد نقطة استلام (Stop Desk) متاحة في ولاية …» | لا يوجد مكتب Noest في ولاية الزبون | حدّث بيانات المزوّد، أو غيّر الشركة، أو حوّل الطلب إلى توصيل بيت. |
الطرد لا يظهر أبداً في واجهة اللوجستيك لدى Noest | التأكيد التلقائي مُطفأ ولم تُؤكَّد المسودة أبداً | أكّدها من لوحة Noest، أو شغّل التأكيد التلقائي في نافذة البيانات. |
نصائح
احسم أمر التأكيد التلقائي قبل أول إرسال بالجملة — فمن السهل أن تفوتك دفعة كاملة من المسودات غير المؤكَّدة.
تعتمد مطابقة البلديات على قائمة بلديات Noest المُزامَنة. فإن كنت تبيع في بلدية أضافتها Noest حديثاً، اضغط تحديث البيانات على البطاقة بدل انتظار التحديث اليومي التلقائي.
طرود Noest لا تحمل قيمة معلنة ولا حقل تأمين — فتلك خاصة بعائلة Yalidine فقط.