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

# مرجع الخصومات

> الآليات الكاملة وراء الخصومات في Upcart: كل شرط تفعيل ونوع مكافأة، وكيف تتراكم تركيبات الخصومات عند الدفع، وسلوك تضمين التطبيق، والعرض في واجهة المتجر وخصائص القوالب المخصصة، والأسئلة الشائعة.

هذه الصفحة هي مرجع الآليات الكامل لميزة [الخصومات](/ar/upcart/discounts) في Upcart: كل شرط تفعيل ونوع مكافأة يمكنك اختياره، وكيف تتراكم تركيبات الخصومات عند الدفع، وكيف تتصرف الخصومات بالنسبة لتضمين التطبيق، والعرض في واجهة المتجر وخصائص القوالب المخصصة، والأسئلة الشائعة. لمعرفة كيفية إنشاء قاعدة خصم وإدارتها، راجع [دليل الخصومات](/ar/upcart/discounts).

<div id="trigger-conditions">
  ## شروط التفعيل
</div>

يمكن أن تحتوي كل قاعدة على ما يصل إلى **مشغّلين اثنين**. تستخدم جميع الشروط **منطق AND** - يجب أن يتحقق كلاهما لتفعيل المكافأة.

<AccordionGroup>
  <Accordion title="منتجات محددة (Specific Products)">
    يُفعَّل عندما يكون أي منتج أو متغير محدد في السلة.

    * يدعم المنتجات الكاملة أو متغيرات محددة
    * تستخدم التحديدات المتعددة منطق OR
    * حتى **20 متغيرًا** لكل مشغّل
    * حدّد حدًا أدنى لكمية المطابقة (القيمة الافتراضية 1)

    استخدم هذا لمشغّلات من نوع "أضف iPhone 15 Pro" أو "أضف أي عنصر مميز".
  </Accordion>

  <Accordion title="مجموعات محددة (Specific Collections)">
    يُفعَّل عندما ينتمي أي عنصر في السلة إلى مجموعة محددة.

    * يدعم مجموعات متعددة، حتى **20** لكل مشغّل
    * منطق OR عبر المجموعات
    * حدّد حدًا أدنى لكمية المطابقة (القيمة الافتراضية 1)

    مثالي للعروض الترويجية القائمة على المجموعات مثل "اشترِ من تخفيضات الشتاء".
  </Accordion>

  <Accordion title="إجمالي السلة (Cart total)">
    يُفعَّل عندما يبلغ إجمالي السلة قبل الخصم مبلغًا محددًا. يُحسب الحد قبل تطبيق أي خصومات (بما في ذلك قواعد الخصم الأخرى).

    <Note>
      يدعم هذا المشغّل العملة الرئيسية لمتجرك فقط. ولا يُجري تحويلًا تلقائيًا للعملات للأسواق الدولية. تُقيَّم الحدود دائمًا بالعملة الأساسية لمتجرك بغض النظر عن عملة الدفع لدى العميل.
    </Note>

    رائع لمكافآت مثل "أنفق \$100، واحصل على هدية مجانية".
  </Accordion>

  <Accordion title="كمية السلة (Cart quantity)">
    يُفعَّل عندما يصل إجمالي عدد العناصر (وليس وحدات SKU الفريدة) في السلة إلى عدد محدد. على سبيل المثال، قطعتان من منتج وقطعة من منتج آخر تساوي 3 عناصر إجمالًا.

    مثالي لعروض ترويجية مثل "اشترِ 4 عناصر أو أكثر، واحصل على خصم 20%".
  </Accordion>

  <Accordion title="اشتراك (Subscription)">
    يُفعَّل عندما تتضمن السلة أي عنصر باشتراك (يتحقق من وجود معرّف خطة بيع في Shopify).

    مفيد لمكافآت مثل "شحن مجاني مع أي اشتراك" أو "هدية مجانية للمشتركين".
  </Accordion>

  <Accordion title="العميل مسجّل الدخول (Customer is logged in)">
    يُفعَّل عندما يكون العميل مسجّل الدخول. يدعم تسجيل الدخول بالبريد الإلكتروني/كلمة المرور وتسجيل الدخول عبر الشبكات الاجتماعية.

    رائع للمكافآت المخصصة للأعضاء أو مزايا الولاء.
  </Accordion>
</AccordionGroup>

<div id="reward-types">
  ## أنواع المكافآت
</div>

بمجرد استيفاء شروط التفعيل، تُطبَّق إحدى المكافآت التالية تلقائيًا.

<AccordionGroup>
  <Accordion title="خصم السلة (Cart Discount)">
    يطبّق خصمًا على السلة بأكملها. يدعم:

    * خصومات النسبة المئوية (مثل خصم 20%)
    * خصومات المبلغ الثابت (مثل خصم \$5)

    الحد الأقصى: 100% أو \$9,999.99 لكل قاعدة.
  </Accordion>

  <Accordion title="هدية مجانية (Free Gift)">
    يضيف تلقائيًا منتجًا محددًا إلى السلة بخصم 100% عند استيفاء الشروط.

    المتطلبات:

    * يجب أن يكون منتج الهدية **Active** أو **Unlisted** ومتاحًا عبر Online Store (وليس **Draft** أو **Archived**)
    * يجب أن يكون المنتج متوفرًا في المخزون
    * يُطبَّق الخصم فقط على المنتج أو المتغير المحدد بالضبط

    <Note>
      إذا أزال العميل الهدية المجانية من سلته، يُزال الخصم أيضًا.
    </Note>
  </Accordion>

  <Accordion title="شحن مجاني (Free Shipping)">
    يزيل تكلفة الشحن عن طريق خصم أرخص طريقة شحن متاحة إلى \$0. لا يلزم أي تكوين إضافي.
  </Accordion>
</AccordionGroup>

<div id="discount-combinations">
  ## تركيبات الخصومات
</div>

تتحكم تركيبات الخصومات في كيفية تراكم خصومات Upcart مع الخصومات الأخرى عند الدفع. تُضبط في صفحة **Discounts**، أسفل جدولي Live وDraft - **وليس** في قاعدة فردية.

<Warning>
  هذا إعداد واحد على مستوى المتجر بأكمله. ينشئ Upcart خصم تطبيق تلقائيًا واحدًا في Shopify لمتجرك، وتكوّن مربعات الاختيار هذه ذلك الخصم الواحد، لذا فإن أي خيار تختاره هنا ينطبق على **كل** قواعد خصم Upcart دفعة واحدة. لا يمكنك السماح لقاعدة بالدمج مع خصومات الطلب ومنع قاعدة أخرى من ذلك.
</Warning>

الأنواع الثلاثة جميعها **متوقفة** افتراضيًا. أنواع التركيبات المتاحة هي:

* **Product discounts** - يُطبَّق إلى جانب خصومات أخرى على مستوى المنتج لعناصر مختلفة. إذا استهدف خصمان المنتج نفسه، فلا يُطبَّق إلا الخصم الأفضل.
* **Order discounts** - يُطبَّق مع الخصومات على مستوى الطلب. تُطبَّق خصومات المنتج أولًا، ثم الخصومات على مستوى الطلب على المجموع الفرعي.
* **Shipping discounts** - يُطبَّق مع الشحن المجاني أو خصومات الشحن الأخرى للحصول على أكبر خصم شحن مؤهل.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/discounts-combinations-options.gif?s=1dc31d8a4d1799f84e02a95b9d98ee6e" alt="خيارات تركيبات الخصومات مع تحديد خصومات Product وOrder وShipping" width="3808" height="1080" data-path="images/upcart/discounts-combinations-options.gif" />

<div id="discounts-and-app-embed-status">
  ## الخصومات وحالة تضمين التطبيق
</div>

تُطبَّق الخصومات عبر نظام الخصومات في Shopify، وليس عبر درج سلة Upcart. هذا يعني:

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

لإيقاف تطبيق خصم بالكامل، انقر على **Unpublish** في القاعدة الفردية لنقلها إلى Drafts. إذا أردت إزالتها نهائيًا، فاحذفها من جدول Drafts بعد ذلك - لا يمكن حذف قاعدة مباشرة بشكل مباشر.

<div id="storefront-display-and-custom-templates">
  ## العرض في واجهة المتجر والقوالب المخصصة
</div>

يتحدّث درج سلة Upcart ديناميكيًا عند استيفاء الشروط. تظهر المكافآت فورًا بناءً على التقييم الفوري للسلة.

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

للتحكم الكامل في التخطيط، تدعم الوحدة [**القوالب المخصصة**](/ar/upcart/setting_up_a_custom_template_in_upcart) باستخدام كود قائم على React. لاستخدامها، حدد أولًا **Access custom templates** ضمن **Settings > Cart settings > Advanced Settings** في Cart Editor - يتطلب الإعداد الإصدار 2.0 من الوحدة. بمجرد التفعيل، يظهر قسم Custom Template داخل وحدة الخصومات. الخصائص المتاحة على المستوى الأعلى هي: `rules` و`showSection` و`onToggleSection`. لكل عنصر داخل `rules` حقوله الخاصة `id` و`title` و`description`.

<Note>
  يتطلب تطوير القوالب المخصصة معرفة بـ React. يدعم Aftersell الميزات المدمجة لكنه لا يقدّم المساعدة في البرمجة المخصصة.
</Note>

<div id="frequently-asked-questions">
  ## الأسئلة الشائعة
</div>

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

  <Accordion title="هل يؤدي إيقاف تضمين تطبيق Upcart إلى تعطيل خصوماتي؟">
    لا. إيقاف تضمين التطبيق يخفي فقط درج سلة Upcart من واجهة متجرك. ستستمر قواعد الخصم النشطة في التطبيق عند الدفع.
  </Accordion>

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

  <Accordion title="هل يمكنني إيقاف خصم مؤقتًا دون حذفه؟">
    نعم. انقر على **Unpublish** لنقل القاعدة إلى Drafts. يؤدي ذلك إلى إيقافها مؤقتًا دون حذف التكوين، ويمكن إعادة نشرها في أي وقت.
  </Accordion>

  <Accordion title="لماذا لا يوجد زر حذف في خصمي المباشر؟">
    لا يتوفر الحذف إلا لقواعد المسودة. انقر على **Unpublish** أولًا لنقل القاعدة إلى Drafts، ثم احذفها من هناك.
  </Accordion>

  <Accordion title="هل يمكنني استخدام كود ترويجي مع قاعدة خصم؟">
    لا. تحتوي كل قاعدة على حقل Discount Code إلزامي (حتى 25 حرفًا)، لكن هذا هو عنوان/تسمية خصم التطبيق التلقائي في Shopify الذي يتم إنشاؤه، وليس كودًا يكتبه المتسوقون عند الدفع. تُفعَّل القواعد دائمًا من شروط السلة (المشغّلات)، وليس أبدًا من إدخال العميل لكود.
  </Accordion>

  <Accordion title="مشغّل Cart Total Threshold لا يعمل مع عملائي الدوليين. لماذا؟">
    يدعم مشغّل Cart Total Threshold العملة الرئيسية لمتجرك فقط. ولا يُجري تحويلًا تلقائيًا للعملات للأسواق الدولية. تُقيَّم الحدود دائمًا بالعملة الأساسية لمتجرك بغض النظر عن عملة الدفع لدى العميل.
  </Accordion>

  <Accordion title="هديتي المجانية لا تظهر. لماذا؟">
    الأسباب الأكثر شيوعًا هي:

    * منتج الهدية مضبوط على **Draft** أو **Archived**، أو غير متاح عبر Online Store
    * المنتج غير متوفر في المخزون
    * شروط التفعيل لا تُستوفى فعليًا

    تحقق من الأسباب الثلاثة جميعها قبل التواصل مع الدعم.
  </Accordion>

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

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

  <Accordion title="ما الفرق بين الخصومات والمكافآت المشروطة (Triggered Rewards)؟">
    إنهما الميزة نفسها. الخصومات هي النسخة المُعاد تسميتها من المكافآت المشروطة، وتظهر الآن كقسم رئيسي في التطبيق لمزيد من الوضوح. تم ترحيل جميع المكافآت المشروطة الحالية تلقائيًا والوظيفة متطابقة.
  </Accordion>
</AccordionGroup>