getAllDiscounts

Obtendo todos os objetos de desconto.

Descrição

Este método recupera todos os objetos de desconto. O método adicionará o idioma padrão ao corpo da solicitação. Se você quiser mudar o idioma, basta passá-lo como o primeiro argumento. Ele retorna uma Promise que resolve para um array de objetos IDiscountEntity.

Descontos.getAllDiscounts(

langCode, offset, limit, type

);

Esquema de parâmetros

Esquema

langCode: string
Código do idioma. Padrão: "en_US"
exemplo: "en_US"

offset: number
Parâmetro opcional para paginação. Padrão: 0
exemplo: 0

limit: number
Parâmetro opcional para paginação. Padrão: 30
exemplo: 30

type: string
Parâmetro opcional para filtrar descontos por tipo

Por padrão, você pode recuperar 10 objetos. Isso se deve ao limite de registro nas configurações de permissões do módulo.
Para que a paginação funcione corretamente, você precisa configurar as Permissões do módulo de acordo com suas necessidades na seção correspondente.

Exemplos

Exemplo mínimo

const response = await Discounts.getAllDiscounts();

Exemplo com atributos

const response = await Discounts.getAllDiscounts('en_US', 0, 30);

Exemplo de resposta

{
  "items": [
    {
      "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,
      "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": [],
      "position": 1
    }
  ],
  "total": 1
}

Esquema de resposta

Esquema: IDiscountEntity[]

items: IDiscountsEntity[]
Array de entidades de desconto.

items.id: number
O identificador único do desconto.

items.attributeSetId: number
O identificador do desconto.

items.localizeInfos: object
O nome do desconto.

items.version: number
A versão do desconto.

items.identifier: string
O identificador do desconto.

items.type: string
O tipo do desconto.

items.startDate: string
A data de início do desconto.

items.endDate: string
A data de término do desconto.

items.discountValue: Record<string, unknown>
O valor do desconto.

items.conditionLogic: string
A lógica do desconto. Os valores possíveis são "AND" | "OR".

items.conditions: IDiscountCondition[]
As condições do desconto.

conditions.type: string
O tipo da condição de desconto.

conditions.value: string
O valor associado à condição de desconto.

items.exclusions: object
As exclusões do desconto.

items.gifts: object
Os presentes do desconto.

items.giftsReplaceCartItems: boolean
Se os presentes substituem os itens do carrinho.

items.userGroups: object
Os grupos de usuários do desconto.

items.userExclusions: object
As exclusões de usuários do desconto.

items.attributeValues: object
Os valores dos atributos do desconto.

items.attributeSetIdentifier: string
O identificador do conjunto de atributos.

total: number
Número total de descontos.

---