getDiscountByMarker

Obteniendo un único objeto de descuento por su identificador textual (marcador).

Descripción

Este método recupera un único objeto de descuento por su identificador textual (marcador). Devuelve una Promesa que se resuelve en un objeto IDiscountEntity.

Descuentos.getDiscountByMarker(

marker*, langCode

);

Esquema de parámetros

Esquema

marker(requerido): string
Identificador textual del objeto de almacenamiento de descuento
ejemplo: "discount_storage"

langCode: string
Código de idioma. Predeterminado: "en_US"
ejemplo: "en_US"

Ejemplos

Ejemplo mínimo

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

Ejemplo con atributos

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

Ejemplo de respuesta

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

Esquema de respuesta

Esquema: IDiscountsEntity

id: number
El identificador único del descuento.

attributeSetId: number
El identificador del descuento.

localizeInfos: ILocalizeInfo
El nombre del descuento.

version: number
La versión del descuento.

identifier: string
El identificador del descuento.

type: IDiscountType
El tipo de descuento.

startDate: string
La fecha de inicio del descuento.

endDate: string
La fecha de finalización del descuento.

discountValue: IDiscountValue
El valor del descuento, incluyendo su tipo y límites de cantidad.

discountValue.applicability: 'TO_PRODUCT' | 'TO_ORDER'
A qué se aplica el descuento.
ejemplo: "TO_PRODUCT"

discountValue.discountType: 'FIXED_AMOUNT' | 'PERCENT'
Cómo se interpreta el valor del descuento.
ejemplo: "FIXED_AMOUNT"

discountValue.value: number
Cantidad del descuento (unidades monetarias para FIXED_AMOUNT, puntos porcentuales para PERCENT).
ejemplo: 10

discountValue.maxAmount: number
Límite opcional sobre el descuento absoluto aplicado.
ejemplo: 5

conditionLogic: string
La lógica del descuento. Los valores posibles son "AND" | "OR".

conditions: IDiscountCondition[]
Las condiciones del descuento.

conditions.type: string
El tipo de condición de descuento.

conditions.value: string
El valor asociado con la condición de descuento.

exclusions: Record<string, unknown> | null
Las exclusiones del descuento.

gifts: Record<string, unknown> | null
Los regalos del descuento.

giftsReplaceCartItems: boolean
Si los regalos reemplazan los artículos del carrito.

userGroups: Record<string, unknown> | null
Los grupos de usuarios del descuento.

userExclusions: Record<string, unknown> | null
Las exclusiones de usuarios del descuento.

attributeValues: IAttributeValues
Los valores de atributos del descuento.

attributeSetIdentifier: string
El identificador del conjunto de atributos.

bonusEvent: Record<string, unknown>
Configuración del evento de bonificación.

position: number
Número de posición para ordenar.
ejemplo: 1

total: number | string
Total de entradas relacionadas.
ejemplo: "1"

---