getDiscountByMarker

الحصول على كائن خصم واحد بواسطة معرفه النصي (المؤشر).

الوصف

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

خصومات.getDiscountByMarker(

marker*, langCode

);

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

المخطط

marker(required): string
المعرف النصي لكائن تخزين الخصم
مثال: "discount_storage"

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

أمثلة

مثال بسيط

const response = await Discounts.getDiscountByMarker('summer_sale');

مثال مع السمات

const response = await Discounts.getDiscountByMarker('summer_sale', 'en_US');

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

{
  "id": 1,
  "type": "DISCOUNT",
  "attributeSetId": 31,
  "conditionLogic": "AND",
  "discountValue": {
    "value": 10,
    "maxAmount": 5,
    "discountType": "FIXED_AMOUNT",
    "applicability": "TO_PRODUCT"
  },
  "exclusions": null,
  "gifts": null,
  "giftsReplaceCartItems": false,
  "userGroups": null,
  "userExclusions": null,
  "localizeInfos": {
    "title": "Example discount"
  },
  "version": 0,
  "total": "1",
  "identifier": "example_discount",
  "startDate": "2026-03-14T14:55:19.928Z",
  "endDate": "2026-07-31T13:55:24.647Z",
  "attributeValues": {
    "example_discount": {
      "type": "string",
      "value": "test value",
      "isIcon": false,
      "position": 0,
      "additionalFields": {},
      "isProductPreview": false
    }
  },
  "conditions": [],
  "bonusEvent": null,
  "position": 1
}

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

المخطط: IDiscountsEntity

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

attributeSetId: number | null
معرف مجموعة السمات المرتبطة بالخصم، أو null عندما لا تكون هناك مجموعة مرتبطة.

localizeInfos: ILocalizeInfo
اسم الخصم.

version: number
إصدار الخصم.

identifier: string
معرف الخصم.

type: IDiscountType
نوع الخصم.

startDate: string
تاريخ بدء الخصم.

endDate: string
تاريخ انتهاء الخصم.

discountValue: IDiscountValue
قيمة الخصم، بما في ذلك نوعه وحدود المبلغ.

discountValue.applicability: 'TO_PRODUCT' | 'TO_ORDER'
ما ينطبق عليه الخصم.
مثال: "TO_PRODUCT"

discountValue.discountType: 'FIXED_AMOUNT' | 'PERCENT'
كيف يتم تفسير قيمة الخصم.
مثال: "FIXED_AMOUNT"

discountValue.value: number
مبلغ الخصم (وحدات العملة لـ FIXED_AMOUNT، نقاط النسبة المئوية لـ PERCENT).
مثال: 10

discountValue.maxAmount: number | null
حد الخصم المطلق المطبق، أو null عندما لا يوجد حد.
مثال: 5

conditionLogic: string
منطق الخصم. القيم الممكنة هي "AND" | "OR".

conditions: IDiscountCondition[]
شروط الخصم.

conditions.type: string
نوع شرط الخصم.

conditions.value: string
القيمة المرتبطة بشرط الخصم.

exclusions: Record<string, unknown> | null
استثناءات الخصم.

gifts: Record<string, unknown> | null
الهدايا المرتبطة بالخصم.

giftsReplaceCartItems: boolean
ما إذا كانت الهدايا تحل محل عناصر السلة.

userGroups: Record<string, unknown> | null
مجموعات المستخدمين المرتبطة بالخصم.

userExclusions: Record<string, unknown> | null
استثناءات المستخدمين المرتبطة بالخصم.

attributeValues: IAttributeValues
قيم السمات المرتبطة بالخصم.

attributeSetIdentifier: string
معرف مجموعة السمات.

bonusEvent: Record<string, unknown>
تهيئة حدث المكافأة.

position: number
رقم الموضع للفرز.
مثال: 1

total: number | string
إجمالي عدد الإدخالات ذات الصلة.
مثال: "1"

---