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
تاريخ الإنشاء.

---