فهرس رسائل الخطأ الشائعة

الغرض#

يسرد هذا الفهرس أكثر الرسائل شيوعاً التي يراها المستخدمون، مجمّعةً بحسب المجال. يعرض كل بند الرسالة كما تظهرها المنصة تماماً، ومعناها، وأول خطوة للحل، والدليل الذي تقرأه بعد ذلك. وتظهر الأجزاء المتغيرة من حالة إلى أخرى بحروف كبيرة، مثل N وX وDATE وERROR.

كيف تستخدمه#

ابحث عن الرسالة في المجال الذي ظهرت فيه. تُورَد كل رسالة بلغة الواجهة التي تقرأ بها هذه الصفحة. وبعضها موجود بلغة واحدة فقط، ويذكر البند ذلك. أما رسائل واجهة التاجر (الـ API) فتتبع ترويسة Accept-Language: العربية افتراضياً، والإنجليزية عندما تبدأ بـ en؛ وواجهة الجوال الخاصة بالمندوب لا تقرأ هذه الترويسة وتردّ بلغة الخادم الافتراضية.

إنشاء الطرد#

• اختر مكان الاستلام (الشحن). / اختر نوع التوصيل. — اختيار مطلوب فارغ في «طرد جديد». أول خطوة: اخترْه. وتستخدم واجهة الـ API مكان الاستلام الافتراضي عندما لا يُرسَل مكان.
• اكتب اسم المستلم. / اكتب هاتف المستلم. / حدد عنوان المستلم من الخريطة (اضغط على الخريطة أو ابحث عن العنوان). — حقل مطلوب من بيانات المستلم فارغ. أول خطوة: املأ الحقل المذكور في الرسالة.
• صيغة customer phone غير صالحة. — يجب أن يتألف الهاتف من 6 إلى 30 خانة: أرقام و+ ومسافات وشرطات وأقواس. وتعرض الرسالة العربية اسم الحقل دون ترجمة. أول خطوة: أعد كتابته، مثل 09xxxxxxxx.
• اشتراك التاجر بباقة التجار منتهي أو غير موجود — جدّد الاشتراك لإنشاء طرود. / اشتراك الشركة التابع إلها التاجر منتهي — لازم الشركة تجدد اشتراكها لتنشئ طرود. — لا توجد باقة تجار فعّالة (الرسالة الأولى)، أو لا يوجد اشتراك فعّال للشركة التي يتبع لها التاجر (الثانية). أول خطوة: جدّد من «الباقة والاشتراك»، أو اطلب من الشركة التجديد.
• وصلت لحد باقتك: N طرد خلال مدة الاشتراك (لحد DATE)، واستعملت M. رقّي باقتك أو جدّد الاشتراك لتكمّل. — تحدّد الباقة حداً أقصى لعدد الطرود وقد استُنفد. أول خطوة: رقِّ الباقة أو جدّد الاشتراك.
• شركة التوصيل المختارة غير متاحة لك / الفرع المختار لا يتبع لك / ما عندك أي مكان استلام مسجّل — أضف مكان استلام (فرع) من صفحة "المتاجر/الفروع" أولاً. — الشركة غير معروضة لحسابك، أو مكان الاستلام ليس لك أو غير موجود. وتقول الرسالة الأخيرة «المتاجر/الفروع» بينما اسم الصفحة «أماكن الاستلام». أول خطوة: اختر شركة من القائمة، أو أضف مكان استلام من «أماكن الاستلام».
• «X» بتقبل طرود لحد N كغ — وزن الطرد W كغ. / «X» بتقبل المبالغ بـ: LIST — غيّر عملة الطرد. — تجاوز الطرد أقصى وزن تقبله الشركة، أو عملته غير مقبولة عندها. أول خطوة: خفّض الوزن أو غيّر عملة الطرد أو اختر شركة أخرى.
• شركة التوصيل "X" ما حددت سعر لمحافظة Y — حدده من صفحة "تسعير التوصيل" أو اختر شركة تانية. / شركة التوصيل تحسب حسب المحافظة: ما قدرنا نعرف محافظة المستلم من العنوان "ADDRESS" — اختر المحافظة من القائمة. / شركة التوصيل تحسب حسب المسافة: حدد موقع المستلم على الخريطة. — ليس للشركة سعر لتلك المحافظة (فهي لا توصّل إليها)، أو تنقص المحافظة أو موقع الخريطة اللذان يحتاجهما السعر. أول خطوة: اختر المحافظة من القائمة، أو حدّد الموقع على الخريطة، أو اختر شركة أخرى.

اقرأ بعد ذلك: «أخطاء التحقق عند إنشاء الطرد وكيفية حلّها».

استيراد الطرود من Excel#

• اختر ملف Excel أو CSV. / نوع الملف لازم يكون xlsx أو xls أو csv. / حجم الملف أكبر من 5 ميغا. — لا يوجد ملف، أو نوعه خطأ، أو حجمه فوق 5 ميغابايت. أول خطوة: أرفق ملف xlsx أو xls أو csv حجمه دون 5 ميغابايت.
• الملف فاضي أو ما فيه عمود "اسم المستلم" / "الموبايل" / "العنوان" بالسطر الأول. — السطر الأول لا يحوي عمود اسم المستلم أو الموبايل أو العنوان. أول خطوة: ابدأ من القالب الذي تقدمه صفحة الاستيراد وأبقِ عناوين أعمدته.
• الحد الأعلى 300 طرد بالملف الواحد (ملفك فيه N). قسّمه لأكتر من ملف. — الملف فيه أكثر من 300 سطر. أول خطوة: قسّمه إلى ملفات من 300 سطر فأقل.

اقرأ بعد ذلك: «أخطاء التحقق عند إنشاء الطرد وكيفية حلّها».

وجهة خارج التغطية#

• «X» ما بتشحن لـCOUNTRY. الدول المدعومة: LIST. / ما قدرنا نحدد محافظة المستلم — «X» بتوصّل بس لـ: LIST. اختار المحافظة بشكل صريح. / «X» ما بتوصّل لمحافظة Y (المستلم). المحافظات المدعومة: LIST. — بلد الوجهة (الأولى)، أو محافظة تعذّر تحديدها (الثانية)، أو محافظة خارج تغطية الشركة (الثالثة). وعندما يكون الفحص على مكان الاستلام تظهر كلمة «المرسل» بدل «المستلم». أول خطوة: اختر المحافظة بشكل صريح أو شركة تغطي الوجهة؛ والسوبر أدمن وحده يغيّر التغطية.

اقرأ بعد ذلك: دليل استكشاف الأخطاء الخاص برفض الطرد لوجهة خارج تغطية الشركة.

المحفظة والرصيد وطلبات السحب#

• رصيد المحفظة غير كافٍ. المطلوب: 12.50، المتاح: 3.00 — المبلغ المطلوب أكبر من الرصيد. والرقمان بالدولار الأمريكي. أول خطوة: اشحن «محفظتي» وأعد المحاولة.
• رصيدك عند «X» ما بيكفي لأجرة الطرد: المطلوب A، المتاح B — اطلب من الشركة تشحنلك رصيد. — تاجر تابع لشركة توصيل يدفع من الرصيد الذي تحتفظ به الشركة. أول خطوة: اطلب من الشركة شحن رصيدك.
• يجب أن تكون قيمة المبلغ 1 على الأقل. — طلب سحب أقل من 1 بالعملة المختارة. أول خطوة: اكتب 1 على الأقل وبحد أقصى مستحقات التحصيل.
• حسابك تابع لشركة توصيل — هالميزة لحسابات تجار المنصة بس (ربط المتاجر، الـ API، الويب هوك، باقات وشحن رصيد المنصة). طرودك ورصيدك عن طريق شركتك. (بالعربية فقط في كل لغات الواجهة) — تاجر تابع لشركة توصيل فتح صفحة خاصة بتجار المنصة (ربط المتاجر، الـ API، الويب هوك، باقات المنصة، الشحن، السحب). أول خطوة: لا شيء لإصلاحه: الشركة هي التي تسوّي حسابها معك.
• المبلغ أكبر من الكاش اللي مع المندوب. / المبلغ أكبر من مستحقات التاجر (X). / المبلغ أكبر من اللي على التاجر (X). / رصيد التاجر أقل من المبلغ اللي بدك تسحبه. — سجّل موظف الشركة تسوية أو سحباً أكبر من الرصيد. أول خطوة: اكتب مبلغاً لا يتجاوز الرصيد الظاهر.

اقرأ بعد ذلك: دليل استكشاف الأخطاء الخاص بفرق رصيد المحفظة عن كشف الحساب.

تسجيل الدخول ورمز OTP#

• الإيميل/الموبايل أو كلمة المرور غير صحيحة. — البيانات غير مطابقة. أما الرسائل التالية فلا تظهر إلا إذا كانت كلمة السر صحيحة. أول خطوة: أعد كتابتها، واستخدم «نسيت كلمة السر» عند الحاجة.
• الحساب لم يُفعَّل بعد (لم يتم تأكيد رمز التحقق OTP). / الحساب موقوف (الحالة: غير فعّال). فعّله من صفحة التجار/المستخدمين بلوحة الإدارة. — لم يُؤكَّد الرمز قط (الأولى) أو الحساب موقوف (الثانية). أول خطوة: أكّد الرمز، أو اطلب من أدمن شركتك تفعيل الحساب.
• هذا الحساب تابع لشركة تانية (رقم N)، ادخل من: DOMAIN — مو من دومين … / حساب السوبر أدمن يدخل من الدومين الرئيسي فقط، مو من دومين شركة. — أنت في الدومين الخطأ. وتنتهي الرسالة الأولى هنا بعد اسم الدومين. أول خطوة: سجّل الدخول من الدومين المذكور في الرسالة (الدومين الرئيسي للسوبر أدمن).
• تعذّر تسجيل الدخول لهذا الحساب على هذا الدومين. / رابط الدخول انتهت صلاحيته (صالح دقيقتين بس). سجّل دخول من جديد من هالصفحة. — سبب آخر مع كلمة سر صحيحة (الأولى)، أو انتهى رابط الدخول لمرة واحدة القادم من الدومين الرئيسي بعد دقيقتين أو استُخدم أو الحساب موقوف (الثانية، بالعربية فقط). أول خطوة: سجّل الدخول من جديد مباشرة من دومين شركتك؛ وإن استمر الأمر فتواصل مع الدعم.
• محاولات تسجيل دخول كثيرة جدًا. يرجى المحاولة مرة أخرى خلال: ثواني. — محاولات دخول فاشلة متكررة. ولا يتضمن النص العربي عدد الثواني. أول خطوة: انتظر دقيقة وأعد المحاولة.
• OTP غير صحيح / Invalid OTP (الإنجليزية فقط: الأخيرة) — رمز خطأ أو منتهٍ أو مستخدم. تعرض صفحات الويب النص الإنجليزي بكل اللغات، وترد واجهة الجوال بلغة الخادم الافتراضية (HTTP 401). أول خطوة: اضغط «Resend Code!» وأدخل الرمز الجديد.
• أوراق الاعتماد غير متطابقة / رقم الدخول (أو الموبايل) أو كلمة المرور غلط. / حساب المندوب موقوف — تواصل مع شركتك. / Invalid Api Key (الإنجليزية فقط: الأخيرة) — تسجيل دخول المندوب عبر واجهة الجوال: رقم أو كلمة سر خطأ (401) ومندوب موقوف (403)، وكلتاهما بالعربية فقط؛ أو حقل ناقص أو كلمة سر أقصر من 6 خانات (422)؛ أو ترويسة apiKey ناقصة أو خطأ (400، بالإنجليزية فقط). أول خطوة: راجع رقم المندوب أو الجوال وكلمة السر وترويسة apiKey، واسأل شركتك عن الإيقاف.

اقرأ بعد ذلك: «مشاكل تسجيل الدخول ورمز التحقق OTP».

ربط المتجر والمزامنة#

• إعداد المتجر ناقص: … (بالعربية فقط في كل لغات الواجهة) — لا توجد للمتجر شركة شحن أو مكان استلام، أو لم يعد المختار متاحاً. ويتابع السبب بالعربية. أول خطوة: اخترهما في بطاقة المتجر واحفظ؛ وتُعاد محاولة الطلبات المتوقفة.
• المفاتيح مرفوضة من المتجر (CODE). تأكد من Consumer Key/Secret وأن الصلاحية "قراءة/كتابة". — ووكومرس: رفض المتجر اختبار الاتصال، والرقم CODE هو 401 أو 403. أول خطوة: اربط عنوان المتجر نفسه من جديد بمفاتيح جديدة بصلاحية قراءة/كتابة.
• تطبيقنا انشال من متجر زد — اربطه من جديد. / صلاحية الربط مع زد انتهت — اكبس «إعادة الربط بزد». / سلة رفضت تجديد الصلاحية — افتح تطبيقنا من لوحة سلة (التطبيقات المثبتة) ووافق على الصلاحيات من جديد. / طريقة الشحن مو Delivery Syria: «…» — لقبول كل الطلبات حط ZID_ONLY_OUR_SHIPPING=false بملف .env (بالعربية فقط في كل لغات الواجهة) — شريط صلاحية الربط في زد (التطبيق أُزيل أو انتهت الصلاحية) أو في سلة (رُفض التجديد)، وطلب زد بطريقة شحن غير شحن المنصة (المقبول افتراضياً شحن المنصة فقط). أول خطوة: اضغط «إعادة الربط بزد»، أو وافق على التطبيق من جديد في لوحة سلة. وقاعدة طريقة الشحن يضبطها مشغّل المنصة.
• رصيد المحفظة غير كافٍ — الطرد بانتظار شحن الرصيد وسيكتمل تلقائياً. — نقص الرصيد ليس فشلاً لطلب المتجر: ينتظر الطرد ويُلغى بعد 24 ساعة إذا لم يصل الرصيد. أول خطوة: اشحن رصيد الشحن.
• Invalid signature / Unknown store (الإنجليزية فقط: الأخيرتان) — رد المنصة على طلب ويب هوك قادم من متجر: توقيع خطأ (HTTP 401) أو رمز متجر غير معروف (404). أول خطوة: أعد تسجيل الويب هوك أو أعد ربط المتجر.

اقرأ بعد ذلك: دليلا استكشاف الأخطاء الخاصان بأخطاء ربط المتجر وبمشاكل مزامنة المتجر.

أخطاء الـ API#

• أرسل المفتاح بالهيدر: Authorization: Bearer <API key> — unauthenticated (HTTP 401): لم يُرسَل مفتاح Bearer. أول خطوة: أرسل الترويسة كما هي تماماً.
• المفتاح غير صحيح أو انلغى. ولّد مفتاح جديد من لوحة التاجر. — invalid_key (HTTP 401): جُدّد المفتاح أو أُلغي أو كُتب خطأً أو هو من نوع آخر. أول خطوة: ولّد المفتاح أو جدّده وحدّث نظامك.
• حساب التاجر موقوف أو غير موجود. / حسابك تابع لشركة توصيل — الـ API لحسابات تجار المنصة بس. — account_inactive وapi_not_allowed (HTTP 403). أول خطوة: اطلب ممن يدير الحساب إعادة تفعيله؛ والتاجر التابع لشركة توصيل يشحن عبر شركته.
• ما عندك اشتراك فعّال بباقة تجار — اشترك لتستعمل «NAME». / ميزة «NAME» مو ضمن باقتك الحالية — رقّي باقتك من صفحة الاشتراك. — plan_feature (HTTP 403): لا توجد باقة فعّالة أو ليست الميزة ضمن الباقة. أول خطوة: جدّد الباقة أو رقِّها.
• صار خطأ عندنا. إذا تكرر تواصل مع الدعم واذكر المرجع EXXXXXX. — server_error (HTTP 500) مع حقل reference يبدأ بالحرف E. أول خطوة: أعد المحاولة مرة ثم أرسل المرجع إلى الدعم.
• ما وصلت: ERROR — delivery_failed (HTTP 422): فشل طلب اختبار الويب هوك إلى رابطك، والسبب بعد النقطتين. أول خطوة: تأكد أن رابطك عام ويردّ بحالة 2xx؛ وإن فشل تحقق توقيعك فقارن X-DS-Signature.

اقرأ بعد ذلك: «مفاتيح الـ API مفقودة أو غير صالحة أو منتهية»، ودليل استكشاف الأخطاء الخاص بالتحقق من توقيع الويب هوك.

حدود الطلبات (HTTP 429)#

• وصلت لحد باقتك: 60 طلب بالدقيقة. استنى 42 ثانية أو رقّي باقتك. — rate_limited (HTTP 429): حد باقتك للـ API بالدقيقة أو باليوم. أول خطوة: انتظر عدد الثواني في Retry-After وخفّف الطلبات أو اطلب باقة أعلى.
• Too Many Attempts. (الإنجليزية فقط: الأخيرة) — حد كل عنوان IP في الـ API، ويُرَدّ عليه بصيغة JSON مع HTTP 429. والنص إنجليزي بكل اللغات. أول خطوة: انتظر عدد الثواني في Retry-After وخفّف الطلبات من عنوان IP العام الخاص بك.
• طلبات كثيرة بوقت قصير — انتظر دقيقة. / Too Many Requests received. Please try again later. (الإنجليزية فقط: الأخيرة) — صفحة 429 العادية: نصها الإنجليزي الثابت (الثاني)، وفي مربع السبب فيها السطر بلغة الصفحة (الأول). أول خطوة: انتظر دقيقة وأعد تحميل الصفحة.
• سجّلت حسابات كتيرة من هالجهاز اليوم — جرّب بكرا أو تواصل مع الدعم. — صفحة «سجّل كتاجر» تحدّ عدد الحسابات لكل جهاز. أول خطوة: جرّب غداً أو تواصل مع الدعم.
• طلبات كتيرة من جهازك — جرّب بعد N دقيقة. / طلبات كتيرة — استنى دقيقة وجرّب. — صفحة «اشحن طردك بدون ما تعمل حساب»: حد نموذج الطلب (الأولى) ونص صندوق السعر (الثانية). أول خطوة: انتظر المدة المذكورة.

اقرأ بعد ذلك: «أخطاء 429 وحدود الطلبات».

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

• ما عندك صلاحية لهالصفحة أو العملية. / هذا الإجراء مسموح لـ: ROLES. الحساب المستخدم: #ID (TYPE، شركة N). — صفحة 403 عنوانها «403 Access Forbidden» (بالإنجليزية في كل اللغات). ويبدأ مربع «سبب الخطأ» فيها بالرسالة الأولى، ويتابع في الصفحات المقيّدة بنوع الحساب بالرسالة الثانية، ثم يعرض مسار الطلب وحسابك ومرجعاً. أما غياب صلاحية القائمة فيعيدك إلى الصفحة الرئيسية بلا رسالة. أول خطوة: سجّل الدخول بنوع حساب مسموح، أو راجع دورك.
• الحساب موقوف (status = 0). — HTTP 401 على مسار مقيّد بنوع الحساب: حساب موقوف ما زالت جلسته أو رمزه قائماً. أول خطوة: أعد تفعيل الحساب.
• باقة شركتك بتسمح بـ N تاجر، ووصلت للحد. رقّي الباقة لتضيف تجار أكتر. — حاولت شركة إضافة تجار أكثر مما تسمح به باقتها. أول خطوة: رقِّ باقة الشركة.
• ما عندك شركة توصيل خاصة. / هالصفحة لمشرفي المستودعات بس. / حسابك مو مربوط بمستودع — تواصل مع الإدارة. — صفحات «شركتي للتوصيل» تحتاج تاجراً يملك شركة؛ ولوحة المستودع لحسابات المشرفين المرتبطة بمستودع (ورسالتاها بالعربية فقط). أول خطوة: استخدم نوع الحساب الصحيح، أو اطلب من المنصة ربط الحساب.

اقرأ بعد ذلك: دليل استكشاف الأخطاء الخاص بصلاحيات موظف الشركة والصفحات التي لا تستطيع فتحها.

الحدود والملاحظات#

• لا يضم الفهرس إلا رسائل وُجدت حرفياً في ملفات اللغة أو الشيفرة. والرسائل المركّبة من أجزاء معروضة مجمّعة.
• قد تعرض رسائل التحقق التي تستخدم اسم حقل هذا الاسم دون ترجمة، كما في رسالة صيغة الهاتف.
• الصفحات التي تعرض مرجعاً مثل H1A2B3C أو E1A2B3C تكتب المرجع نفسه في سجل الخادم: اذكره عند التواصل مع الدعم.