getBonusHistory

الحصول على تاريخ معاملات المكافآت للمستخدم الحالي. 🔐 تتطلب هذه الطريقة التفويض.

الوصف

تسترجع هذه الطريقة تاريخ معاملات المكافآت للمستخدم المصادق عليه حاليًا مع تصفية حسب النوع، ونطاق التاريخ، والخصم، والوحدة، وعلم المسؤول. تعيد وعدًا (Promise) يتم حله إلى مصفوفة من كائنات IBonusTransactionEntity.

خصومات.getBonusHistory(

type, dateFrom, dateTo, discountId, moduleId, isAdmin

);

مخطط المعلمات

المخطط

type: IBonusTransactionType
تصفية نوع المعاملة

dateFrom: string
تصفية تاريخ البدء

dateTo: string
تصفية تاريخ الانتهاء

discountId: number
تصفية معرف الخصم

moduleId: number
تصفية معرف الوحدة

isAdmin: boolean
تصفية المسؤول

أمثلة

مثال بسيط

const response = await Discounts.getBonusHistory();

مثال مع الخصائص

const response = await Discounts.getBonusHistory(
  'ACCRUAL',
  '2026-01-01T00:00:00.000Z',
  '2026-12-31T23:59:59.000Z'
);

مثال على الاستجابة

{
  "items": [],
  "total": 0
}

مخطط الاستجابة

المخطط: IBonusTransactionEntity[]

balanceId: number
معرف الرصيد.

amount: number
مبلغ المعاملة.

type: IBonusTransactionType
نوع المعاملة.

discountId: number
معرف الخصم.

moduleId: number
معرف الوحدة.

entityIdentifier: string
معرف الكيان.

comment: string
تعليق.

isAdmin: boolean
علم المسؤول.

remainingAmount: number
المبلغ المتبقي.

triggerType: 'EVENT' | 'SCHEDULED'
نوع الزناد.

expiresAt: string
تاريخ الانتهاء.

createdAt: string
تاريخ الإنشاء.

---