أخطاء التحقق عند إنشاء الطرد وكيفية حلّها

ما الذي يعنيه الخطأ#

عند حفظ طرد جديد، من صفحة «طرد جديد» أو عبر الـ API أو بالاستيراد من Excel، يجري الخادم سلسلة فحوص أولاً. إذا فشل أي فحص فلا يُنشأ طرد ولا يُخصم أي مبلغ، وتظهر رسالة تشرح السبب. في صفحة «طرد جديد» تُعرض الأسباب في قائمة تحت العنوان «ما انحفظ الطرد بسبب:». وتظهر قائمة «ما انحفظ الطرد، ناقص:» بأسماء الحقول المطلوبة الفارغة.

من تخصّه هذه الرسائل#

التجار، في لوحتهم أو عبر مفتاح الـ API الخاص بهم. والـ API لتجار المنصة فقط، فالتاجر الذي أنشأته شركة توصيل يُرفض طلبه بالرمز api_not_allowed (HTTP 403) قبل فحوص الباقة والطرد. تاجر المنصة يحتاج اشتراكاً فعّالاً في باقة التجار (إذا كانت باقات التجار مفعّلة)، والتاجر الذي أنشأته شركة توصيل يعتمد على اشتراك شركته. وعند تفعيل الباقات يحتاج الاستيراد من Excel والـ API أيضاً إلى ميزتَي الاستيراد والـ API في الباقة، وإلا يُرفض الطلب قبل أي فحص للطرد (في الـ API: plan_feature مع HTTP 403).

الأسباب المحتملة#

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

الحقول المطلوبة وصيغتها

الصفوف الخمسة الأولى هي رسائل صفحة «طرد جديد». أما الـ API والاستيراد من Excel فيعيدان نص التحقق القياسي لاسم المستلم وهاتفه وعنوانه فقط، ولا يشترطان تحديد مكان الاستلام (يُستعمل مكان الاستلام الافتراضي) ولا نوع التوصيل.

الباقة والشركة ومكان الاستلام

• «اشتراك التاجر بباقة التجار منتهي أو غير موجود ...». وللتاجر التابع لشركة تظهر بدلها «اشتراك الشركة التابع إلها التاجر منتهي ...».
• «وصلت لحد باقتك: N طرد خلال مدة الاشتراك (لحد التاريخ)، واستعملت M. ...» ولا تظهر هذه الرسالة إلا إذا حددت الباقة عدداً أقصى للطرود.
• «شركة التوصيل المختارة غير متاحة لك»: الشركة ليست ضمن الشركات المعروضة لحسابك.
• «الفرع المختار لا يتبع لك»، أو «ما عندك أي مكان استلام مسجّل — أضف مكان استلام (فرع) من صفحة "المتاجر/الفروع" أولاً». والمقصود صفحة «أماكن الاستلام» في قسم «الإعدادات» بالقائمة الجانبية، وإن ذكرت الرسالة اسماً آخر.

التغطية وحدود الشركة وشركة الشحن

• رفض التغطية: «X ما بتوصّل لمحافظة ... (المستلم). المحافظات المدعومة: ...». التفاصيل في المقال المرتبط، وتظهر أسماء المحافظات في الرسالة بالعربية.
• «X بتقبل طرود لحد N كغ — وزن الطرد W كغ.» أو «X بتقبل المبالغ بـ: ... — غيّر عملة الطرد.»
• «شركة الشحن X غير مفعّلة حالياً». وتظهر كإشعار منبثق وليس في القائمة.

حساب السعر

• «شركة التوصيل تحسب حسب المحافظة: ما قدرنا نعرف محافظة المستلم من العنوان "..." — اختر المحافظة من القائمة.»
• «شركة التوصيل "X" ما حددت سعر لمحافظة ... — حدده من صفحة "تسعير التوصيل" أو اختر شركة تانية.» أي أن الشركة لا تسعّر تلك المحافظة ولا توصّل إليها.
• «شركة التوصيل تحسب حسب المسافة، ومكان الاستلام "..." ما إله موقع على الخريطة ...»، أو «شركة التوصيل تحسب حسب المسافة: حدد موقع المستلم على الخريطة.» أي أن إحدى النقطتين بلا موقع على الخريطة.
• مع شركة شحن خارجية يظهر عند فشل طلب السعر نص الخطأ كما أرسلته الشركة (أو «تعذّر حساب سعر الشحن»)، وذلك كإشعار منبثق.

الرصيد

• «رصيد المحفظة غير كافٍ. المطلوب: 12.50، المتاح: 3.00». يُقارَن المطلوب بـ«رصيد الشحن» (recharge)، والمبلغان بالدولار الأمريكي، وهو عملة الدفاتر. وتظهر كإشعار منبثق بعنوان «خطأ».
• التاجر التابع لشركة توصيل والذي يدفع من محفظته عندها يرى «رصيدك عند (اسم الشركة) ما بيكفي ...»: اطلب من الشركة شحن رصيدك.
• طلبات المتاجر المربوطة، وطلبات الـ API التي تحمل wait_for_balance=true، لا تُرفض عند نقص الرصيد. تُحفظ «بانتظار الرصيد» ويُكملها النظام تلقائياً عند توفره (يفحص كل ساعة)، ويُلغيها بعد 24 ساعة.

كيف تشخّص المشكلة#

• اقرأ كل البنود في القائمة؛ كل رسالة تسمّي الحقل أو الشرط الذي فشل. وأخطاء الرصيد وشركة الشحن تأتي كإشعارات منبثقة.
• يعرض مربع السعر في صفحة «طرد جديد» رفض التغطية والوزن والعملة ومشكلات حساب السعر قبل الحفظ. وهو يجري فحص التغطية وحدود الوزن والعملات لدى الشركة وفحص تفعيل شركة الشحن، ثم حساب السعر (أو عرض السعر من شركة الشحن الخارجية)، ويعرض أي خطأ ينتج عن هذه الخطوات. ولا يفحص الباقة، ولا إتاحة شركة التوصيل لك، ولا ملكيتك لمكان الاستلام، ولا الرصيد؛ فهذه لا تظهر إلا عند الحفظ.
• تعيد الـ API القيمتين success: false وerror.code: validation_failed (HTTP 422، والحقول في error.fields، وأخطاء الباقة تحت الحقل plan)، وinsufficient_balance (402)، وcarrier_error (422، ومنه تعطيل شركة الشحن أو فشل طلب السعر منها).
• في استيراد Excel يعرض جدول النتائج كل سطر على حدة، وتُفصل رسائل السطر الواحد بـ « — ». الحد الأقصى 300 سطر و5 ميغابايت.

خطوات الحل#

1. أصلح كل الأسباب المعروضة

   عدّل كل بند في القائمة ثم احفظ من جديد. وإن ظهرت رسالة مختلفة فمعناه أن الفحص السابق نجح وفشل الفحص التالي.

2. أكمل الحقول وصحّح قيمها

   اختر مكان الاستلام وشركة التوصيل ونوع التوصيل (ويكفي في الـ API والاستيراد من Excel تحديد شركة التوصيل)، واكتب اسم المستلم ورقم هاتفه بصيغة مقبولة (مثل 09xxxxxxxx)، وحدد العنوان من الخريطة.

3. عالج رفض التغطية

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

4. عالج رسالة حساب السعر

   إذا كانت الرسالة عن المحافظة فاختر المحافظة صراحةً أو اختر شركة أخرى. وإذا كانت عن الموقع على الخريطة فحدد موقع المستلم على الخريطة، وحدد موقعاً على الخريطة لمكان الاستلام من صفحة «أماكن الاستلام».

5. اشحن المحفظة

   افتح «محفظتي» من القائمة الجانبية، أو استخدم رابط «شحن» بجانب رصيدك تحت ملخص الطرد. بند «بينخصم من رصيدك الآن» في الملخص هو المبلغ الواجب توفره. ثم أعد الحفظ.

6. جدّد الباقة أو رقّها

   عند ظهور رسالة الباقة جدّد الاشتراك أو رقّ الباقة من صفحة الاشتراك. والتاجر التابع لشركة يطلب منها تجديد اشتراكها.

12345

1. اختر مكان استلام الطرد
2. اختر شركة التوصيل
3. اكتب اسم المستلم ورقمه
4. حدّد مبلغ التحصيل عند الاستلام
5. رقم فاتورتك لتتعرّف على الطرد لاحقاً

1234

1. نزّل نموذج الملف أولاً
2. اسحب الملف المعبّأ إلى هنا
3. اختر مكان الاستلام
4. ابدأ الاستيراد

متى تتواصل مع الدعم#

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