> ## 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="اختر نوع المزامنة: تلقائية أم يدوية">
    لديك خياران رئيسيان لطريقة تشغيل المزامنة:

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

    فعّل المفتاح المقابل للخيار الذي يناسبك ثم اضغط **حفظ**.

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

  <Step title="حدّد المنتجات التي تريد مزامنتها">
    لا يُلزمك التطبيق بمزامنة جميع منتجاتك. يمكنك اختيار نطاق المزامنة بدقة:

    * **جميع المنتجات:** مزامنة كامل كتالوج منتجاتك.
    * **حسب التصنيف:** اختر تصنيفاً واحداً أو أكثر لتُزامن منتجاتها فقط.
    * **حسب الوسم (Tag):** أضف وسماً مخصصاً مثل `sync-enabled` للمنتجات التي تريد مزامنتها فقط.

    اختر الخيار المناسب من القائمة المنسدلة **نطاق المزامنة**، ثم اضغط **تطبيق**.
  </Step>

  <Step title="اضبط اتجاه المزامنة">
    يتيح لك التطبيق تحديد من أين تأتي البيانات ومن أين تذهب:

    <Tabs>
      <Tab title="سلة ← زد (من سلة إلى زد)">
        في هذا الاتجاه، تُعدّ سلة هي **المصدر الرئيسي** للبيانات. أي تغيير تُجريه في سلة (سعر، وصف، صورة) سينعكس تلقائياً على متجرك في زد. هذا الخيار مناسب إذا كنت تدير منتجاتك أساساً من سلة.

        **ملاحظة خاصة بسلة:** تأكد من أن رمز المنتج (SKU) موحّد في سلة لجميع المنتجات لضمان التطابق الصحيح مع زد.
      </Tab>

      <Tab title="زد ← سلة (من زد إلى سلة)">
        في هذا الاتجاه، تُعدّ زد هي **المصدر الرئيسي** للبيانات. أي تغيير في زد سيُحدَّث في سلة. هذا الخيار مناسب إذا كنت تدير منتجاتك أساساً من زد.

        **ملاحظة خاصة بزد:** تحقق من أن حقول المنتجات في زد مكتملة (خاصة الباركود أو رمز المنتج) لأن التطبيق يعتمد عليها في مطابقة المنتجات.
      </Tab>

      <Tab title="ثنائي الاتجاه (سلة ↔ زد)">
        في هذا الوضع، تنتقل التغييرات في الاتجاهين. أي تعديل في أي من المنصتين سيظهر في الأخرى. هذا الخيار يتطلب ضبط **قواعد التعارض** بعناية (انظر الخطوة التالية).

        <Warning>
          المزامنة ثنائية الاتجاه تزيد من احتمالية التعارضات إذا كان فريقك يُجري تعديلات متزامنة على نفس المنتج في المنصتين. حدّد قواعد التعارض بوضوح لتجنب فقدان البيانات.
        </Warning>
      </Tab>
    </Tabs>
  </Step>

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

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

    اختر القاعدة من قائمة **عند حدوث تعارض** ثم اضغط **حفظ الإعدادات**.
  </Step>

  <Step title="شغّل مزامنة يدوية فورية (اختياري)">
    إذا أردت مزامنة منتجاتك الآن دون انتظار المزامنة التلقائية:

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

    ستظهر رسالة تأكيد عند انتهاء المزامنة مع ملخص بعدد المنتجات التي تمت مزامنتها بنجاح.
  </Step>

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

    1. انتقل إلى **المزامنة** ← **السجل**.
    2. اختر **المنتجات** من فلتر النوع.
    3. يمكنك تصفية السجل حسب التاريخ أو حالة المزامنة (ناجحة، فاشلة، بانتظار).
    4. اضغط على أي سجل لعرض تفاصيله الكاملة.

    في حالة فشل المزامنة، ستجد رسالة الخطأ وسببه في تفاصيل السجل.
  </Step>
</Steps>

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

<Warning>
  لا تُشغّل مزامنة يدوية كاملة (جميع المنتجات) أثناء فترات الذروة في متجرك، لأن ذلك قد يؤدي إلى بطء مؤقت في واجهة الإدارة. يُفضَّل تشغيلها في أوقات انخفاض حركة المرور.
</Warning>

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

بعد إعداد مزامنة المنتجات بنجاح، يجب أن تلاحظ ما يلي:

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

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

**المشكلة 1: المنتج لم يُزامَن رغم تفعيل المزامنة التلقائية**

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

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

***

**المشكلة 2: الأسعار أو المخزون غير متطابقَيْن بين المنصتين**

يحدث هذا عادةً بسبب تعارض في البيانات لم يُحلّ، أو عدم تحديد قاعدة تعارض واضحة في الإعدادات. لحل هذه المشكلة:

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

***

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

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

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

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

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

  <Accordion title="كم من الوقت تستغرق المزامنة التلقائية بعد التعديل؟">
    في الغالب تتم المزامنة التلقائية خلال **1 إلى 5 دقائق** من لحظة إجراء التعديل. في أوقات الذروة أو عند وجود عدد كبير من التغييرات المتزامنة، قد تصل إلى **15 دقيقة**. إذا تجاوزت 30 دقيقة، فتحقق من حالة المزامنة في السجل.
  </Accordion>

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

  <Accordion title="ماذا يحدث للمنتجات الموقوفة أو المحذوفة؟">
    عند حذف منتج أو إيقافه في المنصة المصدر، يعتمد التطبيق على إعداداتك: يمكنك اختيار إما **حذفه تلقائياً** من المنصة الوجهة، أو **إيقافه فقط** (إخفاؤه عن العملاء دون حذفه)، أو **تجاهل التغيير** والإبقاء عليه. يمكنك ضبط هذا الخيار من إعدادات المزامنة تحت بند **سلوك الحذف**.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="مزامنة الطلبات" icon="cart-shopping" href="/using-app/order-sync">
    تعلّم كيفية مزامنة طلباتك وتتبع حالاتها بين سلة وزد تلقائياً.
  </Card>

  <Card title="ضبط إعدادات التطبيق" icon="sliders" href="/using-app/configure-settings">
    استكشف جميع خيارات الإعداد المتاحة لتخصيص التطبيق وفق احتياجات متجرك.
  </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>
