> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adrkha.com/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل رسائل الأخطاء الشائعة في التطبيق مع خطوات الإصلاح

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

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

***

## خطأ في الاتصال

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "خطأ في الاتصال" أو "Connection Error"

    يعني هذا الخطأ أن التطبيق لم يتمكن من إنشاء اتصال بخوادم سلة أو زد. قد يكون السبب انقطاعاً في الإنترنت، أو توقفاً مؤقتاً في خوادم المنصة، أو حجباً من جدار الحماية (Firewall) على شبكتك.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="تحقق من اتصالك بالإنترنت">
    افتح أي موقع آخر في متصفحك للتأكد من أن الإنترنت يعمل. إذا كان الاتصال ضعيفاً، جرّب التبديل إلى شبكة أخرى.
  </Step>

  <Step title="تحقق من حالة خوادم المنصة">
    زر صفحة حالة خوادم سلة أو زد للتحقق من وجود أي أعطال أو صيانة مجدولة تؤثر على الخدمة.
  </Step>

  <Step title="تحقق من إعدادات جدار الحماية">
    إذا كنت على شبكة مؤسسية، قد يحجب جدار الحماية اتصال التطبيق. تواصل مع مسؤول الشبكة للتحقق من السماح بالاتصال.
  </Step>

  <Step title="أعد المحاولة بعد دقائق">
    إذا كان المشكلة من خوادم المنصة، انتظر 5-10 دقائق ثم أعد المحاولة من جديد.
  </Step>
</Steps>

***

## انتهت مهلة الطلب

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "انتهت مهلة الطلب" أو "Request Timeout"

    يعني هذا الخطأ أن التطبيق أرسل طلباً إلى الخادم لكن الخادم لم يستجب خلال الوقت المحدد. عادةً ما يحدث ذلك عند البطء الشديد في الاتصال، أو عند تنفيذ عمليات كبيرة مثل مزامنة آلاف المنتجات دفعةً واحدة.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="تحقق من سرعة الاتصال">
    اختبر سرعة الإنترنت لديك. إذا كانت بطيئة، انتظر حتى يتحسن الاتصال أو انتقل إلى شبكة أسرع.
  </Step>

  <Step title="قلّل حجم العملية">
    إذا كنت تجري مزامنة كبيرة، قسّمها إلى دفعات أصغر بدلاً من مزامنة كل شيء دفعةً واحدة.
  </Step>

  <Step title="أعد المحاولة في وقت أقل ازدحاماً">
    حاول تنفيذ العملية في وقت أقل ازدحاماً على الخوادم، مثل ساعات الصباح الباكر.
  </Step>

  <Step title="تواصل مع الدعم إذا تكررت">
    إذا تكرر هذا الخطأ بانتظام حتى مع الاتصال الجيد، فقد يكون هناك مشكلة في الخادم وتحتاج للإبلاغ عنها.
  </Step>
</Steps>

***

## بيانات غير صالحة

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "بيانات غير صالحة" أو "Invalid Data"

    يعني هذا الخطأ أن البيانات التي يحاول التطبيق إرسالها أو معالجتها لا تستوفي الشروط المطلوبة. مثلاً: حقل إلزامي فارغ، سعر سالب، أو تنسيق تاريخ غير صحيح.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="راجع تفاصيل الخطأ">
    في أغلب الأحيان تكون رسالة الخطأ مصحوبة بتفاصيل تُحدّد الحقل الإشكالي. اقرأ الرسالة كاملةً لمعرفة الحقل الذي يحتوي بيانات غير صالحة.
  </Step>

  <Step title="تحقق من الحقول الإلزامية">
    تأكد من أن جميع الحقول الإلزامية في المنتج أو الطلب المتأثر مكتملة وغير فارغة (الاسم، السعر، الكمية، إلخ).
  </Step>

  <Step title="تحقق من تنسيق البيانات">
    تأكد من أن الأرقام صحيحة (لا حروف في حقل السعر)، والتواريخ بالتنسيق الصحيح، والحقول النصية ضمن الحد المسموح من الأحرف.
  </Step>

  <Step title="صحّح البيانات وأعد المحاولة">
    بعد تصحيح البيانات الخاطئة في المتجر، أعد تشغيل العملية التي أنتجت الخطأ.
  </Step>
</Steps>

<Warning>
  انتبه بشكل خاص للمنتجات التي تم استيرادها من مصادر خارجية، حيث قد تحتوي على بيانات بتنسيقات مختلفة تتعارض مع متطلبات المنصة.
</Warning>

***

## المنتج غير موجود

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "المنتج غير موجود" أو "Product Not Found"

    يعني هذا الخطأ أن التطبيق يحاول الوصول إلى منتج معين لكن هذا المنتج لا يوجد في المتجر. يحدث هذا عادةً عند حذف منتج من المتجر دون حذفه من إعدادات المزامنة، أو عند تغيير بيانات المنتج الأساسية.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="تأكد من وجود المنتج في المتجر">
    افتح لوحة تحكم متجرك وتحقق من وجود المنتج المذكور في الخطأ. ابحث عنه باسمه أو رقمه.
  </Step>

  <Step title="أزل المنتج من قائمة المزامنة">
    إذا كان المنتج محذوفاً فعلاً، توجّه إلى إعدادات المزامنة وأزله من قائمة المنتجات المجدولة للمزامنة لتجنب تكرار الخطأ.
  </Step>

  <Step title="أعد إنشاء المنتج إذا لزم">
    إذا كان المنتج يجب أن يكون موجوداً، أعد إنشاءه في المتجر وأضفه مجدداً لقائمة المزامنة.
  </Step>

  <Step title="نظّف الروابط المعطّلة">
    في بعض التطبيقات، يمكنك تشغيل أداة "تنظيف الروابط المعطّلة" من إعدادات الصيانة لإزالة جميع الإشارات لمنتجات محذوفة دفعةً واحدة.
  </Step>
</Steps>

***

## تجاوز حد الطلبات

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "تجاوز حد الطلبات" أو "Too Many Requests"

    يعني هذا الخطأ أن التطبيق أرسل عمليات كثيرة جداً إلى منصة سلة أو زد في فترة زمنية قصيرة، متجاوزاً الحد المسموح به. المنصتان تفرضان قيوداً على عدد العمليات المتزامنة لحماية جودة الخدمة لجميع المتاجر.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="توقف مؤقتاً وانتظر">
    توقف عن أي عمليات مزامنة أو طلبات يدوية، وانتظر من 5 إلى 15 دقيقة حتى تعود الأمور إلى طبيعتها.
  </Step>

  <Step title="قلّل تكرار المزامنة">
    إذا كانت المزامنة التلقائية مضبوطة على فترات قصيرة جداً، زِد الفترة الزمنية بين كل عملية مزامنة لتقليل عدد العمليات المرسلة.
  </Step>

  <Step title="قلّل العمليات اليدوية المتزامنة">
    تجنّب تشغيل عمليات مزامنة يدوية متعددة في نفس الوقت. انتظر اكتمال كل عملية قبل بدء التالية.
  </Step>

  <Step title="راجع خطة الاشتراك">
    إذا كنت تواجه هذا الخطأ باستمرار، قد تحتاج إلى الترقية إلى خطة اشتراك أعلى تمنحك سعة أكبر للعمليات.
  </Step>
</Steps>

<Info>
  القيود على عدد العمليات هي ميزة تفرضها منصات سلة وزد لضمان جودة الخدمة لجميع المتاجر. التطبيق يحاول التعامل مع هذه الحدود تلقائياً، لكن العمليات الكبيرة أو المتزامنة قد تتجاوزها أحياناً.
</Info>

***

## خطأ في المصادقة

<AccordionGroup>
  <Accordion title="ما معنى هذا الخطأ؟">
    **رسالة الخطأ:** "خطأ في المصادقة" أو "Authentication Error"

    يعني هذا الخطأ أن التطبيق لا يستطيع التحقق من هويتك أو هوية متجرك. السبب الأكثر شيوعاً هو انتهاء صلاحية إذن الوصول الممنوح للتطبيق، أو إلغاء الصلاحيات من لوحة تحكم المنصة.
  </Accordion>
</AccordionGroup>

**خطوات الإصلاح:**

<Steps>
  <Step title="سجّل الخروج وأعد الدخول">
    سجّل الخروج من التطبيق تماماً، ثم أعد تسجيل الدخول باستخدام بيانات حسابك. هذا يُجدّد الاتصال في كثير من الحالات.
  </Step>

  <Step title="أعد ربط متجرك">
    توجّه إلى صفحة إعدادات الاتصال في التطبيق وأعد ربط متجرك (سلة أو زد) من خلال عملية التفويض من جديد.
  </Step>

  <Step title="تحقق من صلاحيات التطبيق في المنصة">
    في لوحة تحكم سلة أو زد، تحقق من أن التطبيق لا يزال مفوّضاً وأن صلاحياته لم تُلغَ. إذا أُلغيت، أعد منحها.
  </Step>

  <Step title="تحقق من بيانات تسجيل الدخول">
    تأكد من أنك تستخدم بيانات تسجيل الدخول الصحيحة للحساب المرتبط بالمتجر الذي تريد الوصول إليه.
  </Step>
</Steps>

<Tip>
  إذن الوصول الممنوح للتطبيق له عمر محدود لأسباب أمنية. إذا كنت تواجه هذا الخطأ بشكل متكرر، تحقق من إعدادات التطبيق لمعرفة إذا كان يدعم التجديد التلقائي للإذن وتأكد من تفعيل هذه الميزة.
</Tip>

***

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="كيف أشارك رسالة الخطأ مع فريق الدعم؟">
    عند ظهور رسالة الخطأ، التقط صورة من الشاشة توضح الرسالة كاملةً. كذلك يمكنك الاطلاع على سجل نشاط التطبيق من قسم "السجلات" أو "Logs" في لوحة تحكم التطبيق، ونسخ رسالة الخطأ من هناك ومشاركتها مع فريق الدعم.
  </Accordion>

  <Accordion title="هل رسائل الخطأ تُحفظ في سجل التطبيق؟">
    نعم، التطبيق يحتفظ بسجل نشاط يتضمن جميع رسائل الخطأ مع وقت حدوثها. يمكنك الوصول إليه من قسم "السجلات" أو "Logs" في لوحة تحكم التطبيق لمراجعة الأخطاء السابقة.
  </Accordion>

  <Accordion title="ماذا أفعل إذا ظهر خطأ غير موجود في هذه القائمة؟">
    إذا واجهت خطأ لم يُذكر هنا، التقط صورة من الشاشة ودوّن الوقت الذي ظهر فيه والإجراء الذي كنت تقوم به. ثم تواصل مع فريق الدعم بهذه المعلومات لنتمكن من مساعدتك في أسرع وقت.
  </Accordion>
</AccordionGroup>

***

## المقالات ذات الصلة

<CardGroup cols={2}>
  <Card title="حل مشكلات المزامنة" href="/troubleshooting/sync-issues" icon="arrows-rotate">
    إذا كانت أخطاؤك مرتبطة بعمليات المزامنة، راجع هذا الدليل للحلول التفصيلية.
  </Card>

  <Card title="حل مشكلات الصلاحيات" href="/troubleshooting/permission-issues" icon="lock">
    للأخطاء المتعلقة بالوصول والمصادقة، يرشدك هذا الدليل لإعادة ضبط الصلاحيات بشكل صحيح.
  </Card>
</CardGroup>

***

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

<Note>
  إذا واجهت خطأً لا يوجد ضمن هذه القائمة، أو جربت جميع الحلول المقترحة دون جدوى، لا تتردد في التواصل مع فريق الدعم عبر [صفحة الدعم الفني](/support/contact-support). أرفق معنا رسالة الخطأ كاملةً وسجل النشاط إن أمكن، وسيتولى فريقنا البحث في المشكلة وإيجاد الحل المناسب.
</Note>