دليل شركات التوصيل

إضافة المناديب وإدارتهم في لوحة الشركة

كيف تضيف شركة التوصيل مندوباً وتحدد عمولته ومناطقه وحد طروده، وكيف توقفه أو تشترط اتصاله، وما الذي يفعله المندوب بعد ذلك في تطبيق الجوال.

آخر تحديث 22 أكتوبر 2026 · آخر تحقق 22 أكتوبر 2026

الغرض#

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

من يستخدمه#

حسابات أدمن الشركة والمسؤول والفرع تستخدم المناديب والعمولات من القائمة الجانبية. والتاجر الذي يدير شركة توصيل خاصة به يجد الصفحة نفسها في لوحة التاجر. أما بند القائمة الأقدم رجل التوصيل فيحتاج إلى صلاحيات الدور delivery_man_* (قراءة وإنشاء وتعديل وحذف).

المتطلبات#

  • رقم موبايل لا يستخدمه أي حساب آخر على المنصة.
  • اشتراك فعّال للشركة، ومكان متاح ضمن حد المناديب في باقتها؛ وبعض الشركات معفاة. عند بلوغ الحد يصبح زر مندوب جديد معطَّلاً وتظهر ملاحظة: «باقة شركتك تسمح بـ N مندوب، وعندك M. رقّي الباقة.»
  • أما شركة التوصيل الخاصة بتاجر فيُحدَّد عدد مناديبها بحسب باقة التاجر بدلاً من ذلك: «ما عندك اشتراك فعّال بباقة تجار — اشترك أو جدّد لتضيف مناديب.» أو «باقتك تسمح بـ N مندوب، وعندك M. رقّي الباقة لإضافة مناديب أكثر.»
  • اختيارياً: ارسم مناطق التوزيع أولاً من صفحة مناطق التوزيع.

إضافة مندوب#

  1. افتح صفحة المناديب

    من القائمة الجانبية اختر المناديب والعمولات (عنوان الصفحة مناديب شركتي).

  2. اضغط «مندوب جديد» واملأ البيانات

    • الاسم ورقم الموبايل (كلاهما مطلوب؛ أرقام فقط من 9 إلى 15 رقماً، وفريد على المنصة كلها).
    • البريد (اختياري، ويجب أن يكون فريداً إن كُتب).
    • كلمة المرور: مطلوبة للمندوب الجديد وبحد أدنى 6 أحرف. زر المفتاح يولّد كلمة مرور وزر العين يُظهرها.
    • حد الطرود معه: أكبر عدد طرود لم تُسلَّم يمكن أن تكون معه في وقت واحد؛ 50 إذا تُرك فارغاً.
    • الحالة: «فعّال — بيستلم طرود» أو «موقوف — ما بيظهر بالتوزيع».
  3. حدد العمولة

    اختر نسبة % أو مبلغ ثابت واكتب القيمة. النسبة تُحسب من أجرة التوصيل ولا تزيد على 100. اترك القيمة فارغة لتُطبَّق عليه النسبة الافتراضية لشركتك، واكتب 0 ليكون بلا عمولة. أما أجرة المحاولة الفاشلة (اختيارية) فتُضاف إلى عمولة المندوب عندما يُسجَّل فشل التوصيل نهائياً (حالة «فشل التوصيل — راجع للشركة») لطرد معه. ولا تُدفع إذا أُجِّل الطرد فقط أو أُعيد إلى المستودع.

  4. اختر مناطق التوزيع

    حدد المناطق التي يغطيها المندوب. إذا لم توجد مناطق بعد يظهر في النموذج «ما في مناطق لسا — ارسمها على الخريطة».

  5. احفظ وسلّم بيانات الدخول

    بعد الحفظ تعرض بطاقة المندوب رقم دخول من 6 أرقام. يدخل المندوب إلى تطبيق المندوب بهذا الرقم أو برقم الموبايل أو بالبريد، مع كلمة المرور.

إدارة المناديب وعمولاتهم (بيانات تجريبية)

النتيجة المتوقعة#

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

الفرع والمناطق#

  • يُربط المندوب الجديد تلقائياً بأول فرع في الشركة، ولا يوجد حقل للفرع هنا. أما نموذج «رجل التوصيل» الأقدم ففيه حقل إلزامي للمركز يظهر في الواجهة العربية بعنوان «المركز رئيسي» (Hub)، وحقول أجور ورصيد قديمة لا تحدد العمولة الموضحة أعلاه.
  • في صفحة توزيع الطرود، عندما تكون مناطق التوزيع معرَّفة ويقع موقع المستلم على الخريطة داخل إحداها، تظهر أولاً مناديب تلك المنطقة في قائمة الطرد؛ أما نافذة التعيين الأقدم ضمن كل الطرود فلا ترتّب المناديب بحسب المنطقة. ويعطي التوزيع التلقائي كل طرد جاهز داخل منطقة لمندوب تلك المنطقة الأقل طرداً ممن لم يبلغوا الحد؛ والطرود التي لا منطقة لها لا تُوزَّع تلقائياً.
  • في صفحة توزيع الطرود يُرفض تعيين طرد لمندوب وصل إلى الحد برسالة يسبقها رقم تتبع الطرد: «المندوب “الاسم” وصل للحد (a / b طرد ما انسلّموا)». أما في نافذة التعيين الأقدم ضمن كل الطرود فتستبعد قائمة البحث المناديب الذين بلغوا الحد، ولا يعيد الخادم فحص الحد هناك.

متصل وغير متصل#

يتيح مفتاحُ تبديلٍ في صفحة المناديب أن تشترط الشركة أن يضبط المندوب حالته على “متصل” في التطبيق قبل أن يستلم طروداً. وما دام الشرط مفعّلاً تعرض صفحة توزيع الطرود المندوب «غير المتصل» معطّلاً فلا يمكن اختياره، ويتجاوزه التوزيع التلقائي. أما في نافذة التعيين الأقدم ضمن كل الطرود فتستبعده قائمة البحث، ويرفض الخادم تعيين طرد له. وعنوان المفتاح هو: «شرط “متصل” لاستلام الطرود».

الإيقاف والحذف#

  • اضبط الحالة على «موقوف» لإيقاف التوزيع. لا يستطيع المندوب تسجيل الدخول (يُرفض برسالة «حساب المندوب موقوف — تواصل مع شركتك.»)، وتُرفض طلبات جلساته القائمة برسالة «الحساب موقوف (status = 0).»، ويختفي من قوائم التوزيع. أما الطرود التي معه فتبقى معيّنة له حتى تعيد توزيعها.
  • لا يوجد زر حذف في هذه الصفحة؛ الحذف موجود فقط في قائمة «رجل التوصيل» الأقدم. وحذف المندوب يحذف معه سجلاته وأحداثه في سجل الطرود، لذا يُفضَّل الإيقاف.

ماذا يفعل المندوب في التطبيق#

  • يسجّل الدخول (بحد أقصى 10 محاولات في الدقيقة) ويرى الطرود المعيّنة له.
  • يسجّل الطرد مُسلَّماً، أو مُسلَّماً جزئياً مع المبلغ الذي حصّله فعلاً، ولا يجوز أن يتجاوز مبلغ التحصيل للطرد.
  • يبدّل بين متصل وغير متصل، ويرسل موقعه إذا كان تتبع المناديب مسموحاً في باقتك.

تُضاف المبالغ المحصّلة إلى كاش معه حتى تسجّل تسوية، وتُضاف العمولة إلى عمولته عن كل طرد يُسلَّم.

أخطاء شائعة#

  • «رقم الموبايل مستخدم لحساب آخر على المنصة.»
  • «النسبة لازم تكون بين 0 و 100.» أو «حد الطرود لازم يكون 1 على الأقل.»
  • مندوب لا يستطيع الدخول: راجع رقم الدخول أو الموبايل وكلمة المرور وحالة «موقوف».

الحدود والصلاحيات#

  • المناديب محصورون دائماً بشركتك؛ فمن يحاول التعامل مع مندوب شركة أخرى تظهر له الرسالة «المندوب غير موجود أو لا يتبع لشركتك.»

API

  • POST /api/v10/deliveryman/login