انتقل إلى المحتوى الرئيسي

المقدمة

🎯 ماذا يفعل هذا الموديل؟​

يتيح لك موديل الخصومات إدارة وتطبيق الخصومات على المنتجات والطلبات - من العروض القائمة على النسبة المئوية إلى التخفيضات الثابتة - دعم رموز القسائم، وخصومات الفئات، والعروض الخاصة بالعملاء في جميع أنحاء متجرك الإلكتروني.

فكر في الأمر كأنه محرك العروض الخاص بك - حدد قواعد الخصم في لوحة إدارة OneEntry، وطبقها على المنتجات أو الطلبات الكاملة، تحقق من رموز القسائم عند الخروج، وأتمتة تعديلات الأسعار لعملائك.

📖 شرح بسيط​

تحتاج كل متاجر التجارة الإلكترونية إلى خصومات مرنة:

  • 🏷️ خصومات النسبة المئوية - خصم 10% على المنتجات المختارة
  • 💰 خصومات ثابتة - خصم 5 دولارات على الطلبات التي تزيد عن 50 دولارًا
  • 🎟️ رموز القسائم - رموز ترويجية لحملات محددة
  • 📦 خصومات الفئات - خصومات على فئات المنتجات الكاملة
  • 👤 خصومات العملاء - أسعار خاصة لعملاء أو مجموعات معينة
  • 📅 عروض محدودة الوقت - مبيعات مع تواريخ بدء وانتهاء محددة

المشاكل بدون إدارة الخصومات:

  • 🔒 أسعار غير مرنة - الحاجة إلى تغييرات في الكود لكل عرض
  • 📊 صعوبة التتبع - عدم وجود إدارة مركزية للخصومات
  • 🔄 عدم وجود أتمتة - تحديثات يدوية للأسعار لكل عملية بيع

حل الخصومات:

الفوائد:

  • 🔒 عروض مرنة - إنشاء وإدارة الخصومات في لوحة الإدارة
  • 📊 تحكم مركزي - جميع الخصومات في مكان واحد
  • 🔄 تطبيق تلقائي - تطبيق الخصومات تلقائيًا عند الخروج
  • 🎟️ تحقق من القسائم - تحقق من صحة رمز القسيمة في الوقت الحقيقي

✨ المفاهيم الأساسية​

ما هو الخصم؟​

الخصم هو قاعدة تسعير تقلل من تكلفة المنتجات أو الطلبات:

  • نوع الخصم - نسبة مئوية (مثل 20%) أو مبلغ ثابت (مثل 10 دولارات)
  • قيمة الخصم - المبلغ أو النسبة المئوية للتقليل
  • علامة - معرف فريد للتصفية والإشارة
  • فترة الصلاحية - تواريخ بدء وانتهاء اختيارية
  • رمز القسيمة - رمز ترويجي اختياري لخصومات العملاء

هيكل الخصم​

كل خصم له هذا الهيكل:

{
  id: 1,
  identifier: 'summer_sale',
  localizeInfos: {
    title: 'Summer Sale'
  },
  discountType: 'percentage',
  discountValue: 20,
  isActive: true,
  validFrom: '2025-06-01T00:00:00.000Z',
  validTo: '2025-08-31T23:59:59.999Z',
}

أنواع الخصومات​

النوعالوصفالمثال
نسبة مئويةتقليل السعر بنسبة مئويةخصم 20% على جميع عناصر الصيف
ثابتتقليل السعر بمبلغ ثابتخصم 10 دولارات على الطلبات التي تزيد عن 50 دولارًا

العمليات الشائعة للخصومات​

العمليةالوصفمثال على حالة الاستخدام
الحصول على جميع الخصوماتقائمة بجميع الخصومات المتاحةإدارة الخصومات من قبل المسؤول
الحصول على خصم بواسطة العلامةجلب خصم محددعرض شارة الخصم
التحقق من القسيمةالتحقق مما إذا كان رمز القسيمة صالحًاحقل القسيمة عند الخروج

لماذا تستخدم موديل الخصومات؟​

الفائدةالوصف
عروض مؤتمتةلا حاجة لتحرير الأسعار يدويًا لكل عملية بيع
إدارة القسائمإنشاء وتوزيع والتحقق من صحة الرموز الترويجية
قواعد مرنةخصومات بنسبة مئوية، ثابتة، فئات، أو عملاء
عروض محدودة الوقتجدولة الحملات مع تواريخ بدء/انتهاء
دعم متعدد اللغاتأسماء الخصومات محلية حسب اللغة

📋 ما تحتاج إلى معرفته​

تُنشأ الخصومات في لوحة الإدارة​

لا يمكنك إنشاء خصومات عبر SDK - يتم إنشاؤها في لوحة إدارة OneEntry.

عملية الإنشاء:

  • قدم اسمًا - تعيين الخصم (مطلوب)
  • قدم علامة - معرف فريد (مطلوب)
  • اختر نوع الخصم - نسبة مئوية أو مبلغ ثابت
  • حدد قيمة الخصم - مبلغ التخفيض
  • حدد فترة الصلاحية - تواريخ البدء والانتهاء (اختياري)

التحقق من القسيمة​

استخدم validateDiscountsCoupon() عند الخروج للتحقق من رموز القسائم في الوقت الحقيقي قبل تطبيقها على الطلب.

💡 ملاحظات مهمة​

تُنشأ الخصومات في لوحة الإدارة​

يدير موديل الخصومات:

  • ✅ جلب جميع الخصومات النشطة
  • ✅ استرجاع خصم محدد بواسطة العلامة
  • ✅ التحقق من رموز القسائم عند الخروج
  • ❌ لا ينشئ أو يعدل الخصومات (استخدم لوحة الإدارة)

مسؤوليتك:

  • عرض شارات الخصم على قوائم المنتجات
  • تطبيق حقول إدخال القسيمة عند الخروج
  • عرض إجماليات الخصم في ملخص السلة/الطلب

📊 جدول مرجعي سريع​

الطريقةالوصف
getAllDiscounts()الحصول على جميع الخصومات
getDiscountByMarker()الحصول على خصم واحد بواسطة العلامة
validateDiscountsCoupon()التحقق من صحة رمز قسيمة الخصم

❓ الأسئلة الشائعة (FAQ)​

كيف يمكنني تطبيق خصم عند الخروج؟​

احصل على الخصم باستخدام getDiscountByMarker() أو تحقق من رمز القسيمة باستخدام validateDiscountsCoupon(). استخدم قيمة الخصم المعادة لحساب السعر المخفض على جانب العميل قبل إنشاء الطلب.

هل يمكن أن يكون للخصم تاريخ انتهاء؟​

نعم! يمكن أن تحتوي الخصومات على حقول اختيارية validFrom وvalidTo. تحقق من هذه الحقول عند عرض الخصومات للتأكد من أنها نشطة حاليًا.

كيف يمكنني عرض شارات الخصم على المنتجات؟​

احصل على جميع الخصومات باستخدام getAllDiscounts()، ثم قم بمطابقة الخصومات مع المنتجات بناءً على منطق عملك. قم بعرض شارة باستخدام localizeInfos.title وdiscountValue للخصم.

ماذا يحدث إذا كان رمز القسيمة غير صالح؟​

تُرجع validateDiscountsCoupon() false إذا لم يكن رمز القسيمة موجودًا أو انتهت صلاحيته. اعرض رسالة خطأ مناسبة للعميل.

🎓 أفضل الممارسات​

  • تخزين الخصومات عند التحميل - تتغير بشكل نادر؛ تجنب المكالمات المتكررة لواجهة برمجة التطبيقات
  • التحقق من القسائم من جانب الخادم - تحقق دائمًا قبل تطبيقها على الطلب
  • عرض الخصم بوضوح - عرض الأسعار الأصلية والمخفضة معًا
  • التعامل مع الخصومات المنتهية - تحقق من validTo قبل عرض الخصم
  • استخدام علامات وصفية - summer_sale_2025، وليس discount1
  • محلية أسماء الخصومات - استخدم localizeInfos لدعم متعدد اللغات

مزيد من المعلومات حول واجهة مستخدم الموديل https://doc.oneentry.cloud/docs/category/discounts

تعريف موديل الخصومات​


const { Discounts } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة​