getDiscountByMarker

Lấy một đối tượng giảm giá duy nhất bằng cách sử dụng định danh văn bản của nó (marker).

Mô tả

Phương thức này truy xuất một đối tượng giảm giá duy nhất bằng cách sử dụng định danh văn bản của nó (marker). Nó trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng IDiscountEntity.

Giảm giá.getDiscountByMarker(

marker*, langCode

);

Sơ đồ tham số

Sơ đồ

marker(bắt buộc): string
Định danh văn bản của đối tượng lưu trữ giảm giá
ví dụ: "discount_storage"

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

Ví dụ

Ví dụ tối thiểu

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

Ví dụ với các thuộc tính

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

Ví dụ phản hồi

{
  "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
}

Sơ đồ phản hồi

Sơ đồ: IDiscountsEntity

id: number
Định danh duy nhất của giảm giá.

attributeSetId: number
Định danh của giảm giá.

localizeInfos: ILocalizeInfo
Tên của giảm giá.

version: number
Phiên bản của giảm giá.

identifier: string
Định danh của giảm giá.

type: IDiscountType
Loại giảm giá.

startDate: string
Ngày bắt đầu của giảm giá.

endDate: string
Ngày kết thúc của giảm giá.

discountValue: IDiscountValue
Giá trị của giảm giá, bao gồm loại và giới hạn số tiền.

discountValue.applicability: 'TO_PRODUCT' | 'TO_ORDER'
Giảm giá áp dụng cho cái gì.
ví dụ: "TO_PRODUCT"

discountValue.discountType: 'FIXED_AMOUNT' | 'PERCENT'
Cách hiểu giá trị giảm giá.
ví dụ: "FIXED_AMOUNT"

discountValue.value: number
Số tiền giảm giá (đơn vị tiền tệ cho FIXED_AMOUNT, điểm phần trăm cho PERCENT).
ví dụ: 10

discountValue.maxAmount: number
Giới hạn tùy chọn cho số tiền giảm giá tuyệt đối áp dụng.
ví dụ: 5

conditionLogic: string
Logic của giảm giá. Các giá trị có thể là "AND" | "OR".

conditions: IDiscountCondition[]
Các điều kiện của giảm giá.

conditions.type: string
Loại điều kiện giảm giá.

conditions.value: string
Giá trị liên quan đến điều kiện giảm giá.

exclusions: Record<string, unknown> | null
Các trường hợp loại trừ của giảm giá.

gifts: Record<string, unknown> | null
Các món quà của giảm giá.

giftsReplaceCartItems: boolean
Liệu các món quà có thay thế các mặt hàng trong giỏ hàng hay không.

userGroups: Record<string, unknown> | null
Các nhóm người dùng của giảm giá.

userExclusions: Record<string, unknown> | null
Các trường hợp loại trừ người dùng của giảm giá.

attributeValues: IAttributeValues
Các giá trị thuộc tính của giảm giá.

attributeSetIdentifier: string
Định danh của bộ thuộc tính.

bonusEvent: Record<string, unknown>
Cấu hình sự kiện thưởng.

position: number
Số thứ tự để sắp xếp.
ví dụ: 1

total: number | string
Tổng số lượng các mục liên quan.
ví dụ: "1"

---