> ## 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.

# مزامنة الطلبات بين متجري سلة وزد وتتبع حالاتها

> زامن طلباتك بين سلة وزد تلقائياً وتتبّع تحديثات الحالة، وتأكد من عدم تكرار أي طلب أو فقدانه مع خيارات مرنة لضبط حالات الطلبات.

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

## المتطلبات المسبقة

<Note>
  تأكد من استيفاء ما يلي قبل إعداد مزامنة الطلبات:

  * ربط حساب سلة وزد بالتطبيق. ([دليل ربط المتجر](/getting-started/connect-store))
  * إتمام الإعداد الأول للتطبيق. ([دليل الإعداد الأول](/getting-started/first-setup))
  * تفعيل مزامنة المنتجات أولاً لضمان تطابق المنتجات بين المنصتين قبل مزامنة الطلبات.
  * التأكد من أن طرق الدفع وخيارات الشحن مُعدَّة في كلتا المنصتين.
</Note>

## خطوات إعداد مزامنة الطلبات

<Steps>
  <Step title="افتح إعدادات مزامنة الطلبات">
    من لوحة تحكم التطبيق، انتقل إلى **المزامنة** ← **الطلبات**. ستظهر لك لوحة الإعدادات الرئيسية لمزامنة الطلبات مع ملخص سريع لآخر عمليات المزامنة.
  </Step>

  <Step title="حدّد نطاق مزامنة الطلبات">
    يغطّي التطبيق الأنواع التالية من أحداث الطلبات، ويمكنك تفعيل كل نوع أو تعطيله باستقلالية:

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

    فعّل الأنواع التي تحتاجها ثم اضغط **حفظ**.
  </Step>

  <Step title="اضبط قواعد مزامنة الطلبات">
    قبل تفعيل المزامنة، حدّد كيف يتصرف التطبيق عند استلام طلبات جديدة:

    <Tabs>
      <Tab title="طلبات سلة في زد">
        عند ورود طلب جديد في سلة، يقوم التطبيق بإنشاء طلب مقابل في زد تلقائياً. تأكد من الإعدادات التالية:

        * **ربط طرق الدفع:** تأكد من أن طريقة الدفع المستخدمة في سلة لها نظير في زد، وإلا سيتم تعيين طريقة الدفع الافتراضية.
        * **ربط خيارات الشحن:** حدّد كيف تُترجَم خيارات شحن سلة إلى خيارات شحن زد.
        * **البيانات المنقولة:** اسم العميل، عنوان الشحن، المنتجات المطلوبة، الكميات، الأسعار، رمز الكوبون (إن وجد).
      </Tab>

      <Tab title="طلبات زد في سلة">
        عند ورود طلب جديد في زد، يُنشئ التطبيق طلباً مقابلاً في سلة. تأكد من الإعدادات التالية:

        * **ربط طرق الدفع:** طريقة الدفع في زد لها ما يقابلها في سلة.
        * **ربط خيارات الشحن:** ترجمة خيارات شحن زد إلى خيارات شحن سلة بشكل صحيح.
        * **البيانات المنقولة:** جميع بيانات الطلب تُنقل بالكامل بما في ذلك الملاحظات الخاصة بالطلب إن وجدت.
      </Tab>
    </Tabs>
  </Step>

  <Step title="اضبط جدول تعيين حالات الطلبات">
    كل منصة لها مسمياتها الخاصة لحالات الطلبات. يتيح لك التطبيق تحديد كيفية ترجمة الحالات بين المنصتين:

    | حالة في سلة  | الحالة المقابلة في زد |
    | ------------ | --------------------- |
    | طلب جديد     | طلب معلّق             |
    | قيد المعالجة | جارٍ التجهيز          |
    | تم الشحن     | في الطريق             |
    | تم التسليم   | مُسلَّم               |
    | ملغي         | ملغي                  |
    | مُسترد       | مُسترد                |

    يمكنك تعديل هذا الجدول من إعدادات **تعيين الحالات** وتخصيصه وفق احتياجاتك. اضغط على أي حالة لتغيير مقابلها في المنصة الأخرى ثم اضغط **حفظ الجدول**.

    <Tip>
      خصّص جدول تعيين الحالات بعناية في البداية، لأن الترجمة الخاطئة للحالات قد تُربك عملاءك الذين يتابعون حالة طلباتهم من مكانَيْن مختلفَيْن.
    </Tip>
  </Step>

  <Step title="فعّل آلية منع تكرار الطلبات">
    هذه الخطوة بالغة الأهمية لمنع إنشاء طلبات مكررة عند مزامنة الطلبات في الاتجاهين:

    1. انتقل إلى **إعدادات متقدمة** داخل صفحة مزامنة الطلبات.
    2. فعّل خيار **منع الطلبات المكررة**.
    3. يعتمد التطبيق على **رقم الطلب الأصلي** كمعرّف فريد لتتبع الطلبات عبر المنصتين ومنع تكرارها.
    4. اضغط **حفظ**.

    <Warning>
      لا تُعطّل خيار منع الطلبات المكررة إلا إذا طُلب منك ذلك من فريق الدعم لغرض محدد. تعطيله قد يؤدي إلى إنشاء طلبات مضاعفة ويُرهق فريق إدارة الطلبات لديك.
    </Warning>
  </Step>

  <Step title="شغّل مزامنة يدوية للطلبات الفائتة">
    إذا كان لديك طلبات قديمة لم تُزامَن بعد (مثلاً قبل تفعيل التطبيق)، يمكنك مزامنتها يدوياً:

    1. انتقل إلى **المزامنة** ← **الطلبات** ← **مزامنة يدوية**.
    2. حدّد نطاق زمني للطلبات التي تريد مزامنتها (مثلاً: آخر 30 يوماً).
    3. اختر المنصة المصدر للطلبات.
    4. اضغط **بدء المزامنة** وانتظر حتى تكتمل العملية.

    <Tip>
      عند مزامنة الطلبات القديمة لأول مرة، ابدأ بنطاق زمني صغير (أسبوع واحد) وتحقق من النتائج قبل توسيع النطاق لتجنب أي تعارضات غير متوقعة.
    </Tip>
  </Step>

  <Step title="راجع سجل الطلبات المزامَنة">
    للاطلاع على سجل كامل لجميع عمليات مزامنة الطلبات:

    1. انتقل إلى **المزامنة** ← **السجل** ← **الطلبات**.
    2. استخدم الفلاتر لتصفية السجل: حسب التاريخ، حالة المزامنة، رقم الطلب، أو المنصة المصدر.
    3. اضغط على أي سجل لعرض التفاصيل الكاملة: رقم الطلب، وقت المزامنة، الحالة، وأي رسائل خطأ إن وجدت.
    4. في حالة فشل مزامنة طلب معين، يمكنك إعادة محاولة المزامنة مباشرة من صفحة التفاصيل بالضغط على **إعادة المحاولة**.
  </Step>
</Steps>

<Warning>
  في حال تعطّل المزامنة لأي سبب، تأكد من مراجعة سجل الطلبات يومياً خلال الأسابيع الأولى من استخدام التطبيق. الطلبات التي لم تُزامَن ستظهر بحالة "فشل" في السجل وتحتاج إلى إعادة معالجة.
</Warning>

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

بعد إعداد مزامنة الطلبات بنجاح وتشغيلها، يجب أن تلاحظ ما يلي:

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

## استكشاف الأخطاء

**المشكلة 1: طلب جديد لم يظهر في المنصة الأخرى**

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

1. تأكد من أن **الطلبات الجديدة** مفعّلة ضمن نطاق مزامنة الطلبات في الإعدادات.
2. تحقق من أن جميع المنتجات المشمولة في الطلب موجودة ومزامَنة في كلا المنصتين.
3. ابحث عن رقم الطلب في سجل المزامنة وتحقق من حالته ورسالة الخطأ إن وجدت.
4. شغّل مزامنة يدوية للطلب مباشرةً من صفحة تفاصيله في السجل.

***

**المشكلة 2: حالة الطلب غير متطابقة بين المنصتين**

يحدث هذا غالباً بسبب خطأ في جدول تعيين الحالات بين المنصتين، أو لأن تحديث الحالة حدث قبل تفعيل خيار مزامنة تحديثات الحالة. لحل هذه المشكلة:

1. انتقل إلى **إعدادات مزامنة الطلبات** وراجع **جدول تعيين الحالات** وتحقق من صحة كل تعيين.
2. تأكد من أن **تحديثات الحالة** مفعّلة ضمن إعدادات نطاق المزامنة.
3. حدّث الحالة يدوياً في المنصة الوجهة لتطابق حالة المنصة المصدر.
4. شغّل مزامنة يدوية للطلب المعني من سجل المزامنة وراقب النتيجة.

***

**المشكلة 3: ظهور طلبات مكررة في إحدى المنصتين**

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

1. تحقق فوراً من أن خيار **منع الطلبات المكررة** مفعّل في قسم **إعدادات متقدمة** داخل مزامنة الطلبات.
2. احذف الطلب المكرر يدوياً من المنصة الوجهة مع الحرص على الاحتفاظ بالطلب الأصلي.
3. إذا استمر ظهور الطلبات المكررة، تواصل مع الدعم وأرفق أرقام الطلبات المكررة لتسريع المعالجة.

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

<AccordionGroup>
  <Accordion title="هل تُزامَن الملاحظات الخاصة بالطلب؟">
    نعم، يتم نقل ملاحظات العميل المضافة عند الطلب إلى المنصة الأخرى. أما الملاحظات الداخلية التي يضيفها فريقك بعد الطلب، فتبقى في المنصة التي أُضيفت فيها ولا تُزامَن تلقائياً.
  </Accordion>

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

  <Accordion title="ماذا يحدث إذا تغيّر سعر المنتج بعد إنشاء الطلب؟">
    لا تؤثر مزامنة الأسعار على الطلبات التي تم إنشاؤها مسبقاً. يحتفظ كل طلب بالسعر الذي كان مطبَّقاً وقت إنشائه. مزامنة الأسعار تؤثر فقط على الطلبات الجديدة.
  </Accordion>

  <Accordion title="هل يمكن استثناء بعض الطلبات من المزامنة؟">
    نعم، يمكنك إضافة وسم خاص "no-sync" على أي طلب في المنصة المصدر لمنع التطبيق من مزامنته. هذا مفيد للطلبات الاختبارية أو الطلبات الداخلية التي لا تريد تكرارها في المنصة الأخرى.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="مزامنة المنتجات" icon="box" href="/using-app/product-sync">
    أعدّ مزامنة المنتجات والمخزون بين سلة وزد قبل البدء بمزامنة الطلبات.
  </Card>

  <Card title="مزامنة العملاء" icon="users" href="/using-app/customer-sync">
    أبقِ بيانات عملائك موحّدة بين المنصتين لضمان تجربة طلب سلسة.
  </Card>

  <Card title="استكشاف أخطاء المزامنة" icon="wrench" href="/troubleshooting/sync-issues">
    حلول تفصيلية لأشيع مشكلات مزامنة الطلبات والمنتجات.
  </Card>

  <Card title="الأتمتة والمهام المجدولة" icon="robot" href="/using-app/automation">
    أتمتة معالجة الطلبات وجدولة المزامنة في أوقات مناسبة لعملك.
  </Card>
</CardGroup>

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

<Note>
  إذا واجهتَ مشكلة في مزامنة الطلبات ولم تجد لها حلاً في هذا الدليل، تواصل مع فريق الدعم. يُرجى إرفاق رقم الطلب المتأثر ورقم سجل المزامنة المرتبط به لتسريع المعالجة.

  [تواصل مع فريق الدعم ←](/support/contact-support)
</Note>
