الخصومات الإلزامية في ڤاريونس والأتمتة الترويجية
الخصومات الإلزامية عروض تلقائية تُدار من /dashboard/mandatory-discounts بمعزل عن الكوبونات العادية، وتُطبَّق على السلة المؤهلة دون كود عبر POST /api/mandatory-discounts/public/get-active، وتُحفظ في الطلب كسطر isMandatory.
آخر تحقق: 2026-09-19
تُفتح القائمة من /dashboard/mandatory-discounts مع الإحصاءات والحذف، والإنشاء من /dashboard/mandatory-discounts/create بإدخال Title واختيار Type مثل Percentage وFixed Amount وFree Shipping وMandatory Gift وإدخال Value وتواريخ البداية والنهاية والحالة Active أو Paused، والتعديل من /dashboard/mandatory-discounts/[id]/edit.
وتستخدم نفس موديل Coupon مع data.isMandatory: true، وتُدار عبر GET/POST وGET/PUT/DELETE وGET stats بصلاحيات mandatory-discounts.view وcreate وedit وdelete. والأنواع المدعومة percentage وfixed وfree_shipping وfree_product وbuy_x_get_y، حيث يضيف free_product وbuy_x_get_y سطر هدية إلى السلة عبر useDiscounts.
وعند تغيّر السلة يجلب useDiscounts الخصومات النشطة، ويجمع useCheckoutTotals خصم mandatory مع الكوبون والولاء في grandTotal، ويعرض PricingBreakdown السطور، ثم يبني buildOrderPayload مصفوفة discounts[] مع isMandatory وfreeProductId، فيحفظ POST /api/orders/create السطور ويحدث analytics وredemptions. والحذف يوقف التطبيق فوراً عن السلات الجديدة دون المساس بالطلبات القديمة.
خطوات الإعداد في ڤاريونس
افتح الخصومات الإلزامية
من لوحة التحكم افتح /dashboard/mandatory-discounts وراجع القائمة والإحصاءات.
أنشئ خصماً إلزامياً
اضغط Create أو New Mandatory Discount وأدخل Title واختر Type وأدخل Value عند الحاجة.
اضبط النطاق والتواريخ والحالة
عيّن تواريخ البداية والنهاية والحالة Active أو Paused ثم احفظ فيظهر الخصم في القائمة.
جرّب السلة بدون كود
افتح المتجر وأضف منتجاً مؤهلاً وتأكد أن الخصم طُبق تلقائياً وظهر سطره وخط الهدية عند free_product.
عدّل أو احذف عند الحاجة
للتعديل افتح /dashboard/mandatory-discounts/[id]/edit، وللإيقاف الفوري استخدم Delete.
أسئلة شائعة
ما الفرق بين الكوبون والخصم الإلزامي؟
الكوبون يُدار من /dashboard/discounts وقد يحتاج كوداً، أما الإلزامي فيُدار من /dashboard/mandatory-discounts ويُطبَّق تلقائياً دون كود ما لم يُستثنَ.
ما أنواع الخصم الإلزامي؟
نسبة مئوية ومبلغ ثابت وشحن مجاني وهدية إجبارية free_product واشتري X واحصل على Y.
هل يحتاج العميل لإدخال كود؟
لا، يُطبَّق تلقائياً على السلة المؤهلة عبر get-active ويظهر كخصم مفروض.
أين يظهر الخصم الإلزامي في الطلب؟
كسطر في data.discounts[] مع isMandatory: true وfreeProductId للهدايا، وينعكس في data.totals.discountTotal.
ماذا يحدث عند حذف خصم إلزامي؟
يتوقف فوراً عن السلات الجديدة، وتبقى الطلبات القديمة بسطورها الأصلية.
استكشاف الأخطاء
1) إذا لم يُطبَّق الإلزامي، تأكد من الحالة Active ومن أهلية السلة ومن أن النوع free_product له منتج هدية صحيح. 2) إذا ظهر خصم غير متوقع، راجع /dashboard/mandatory-discounts لأنها تُطبَّق ما لم تُستثنَ. 3) إذا لم تظهر الهدية، راجع سطر الهدية في السلة وتأثير المخزون. 4) إذا احتجت إيقافاً فورياً، استخدم Delete بدل الانتظار لانتهاء التواريخ.
حدود مهمة
• تُطبَّق ما لم تُستثنَ صراحة فراجعها قبل تغيير الأسعار. • الهدايا free_product وBxGy تؤثر على المخزون. • الحذف فوري على السلات الجديدة ولا يعدّل الطلبات القديمة.