YAyampi
Promoções - Desconto progressivo

Criar desconto progressivo

Cria um novo desconto progressivo

post/{alias}/pricing/progressive-discounts

Request

  • Base URL
    https://api.dooki.com.br/v2
  • URL
    https://api.dooki.com.br/v2/{alias}/pricing/progressive-discounts
  • Auth
    API key in header User-Token and API key in header User-Secret-Key

Path parameters

aliasstring required

Alias da loja

Request body

activeboolean

Define se o desconto progressivo está ativo.

min_valuenumber float required

Valor mínimo do subtotal do carrinho, em reais, para a faixa de desconto valer.

max_valuenumber float required

Valor máximo do subtotal do carrinho, em reais, para a faixa de desconto valer.

percentnumber float required

Percentual de desconto aplicado ao subtotal do carrinho, de 0 a 100. A criação é recusada quando a loja já tem um desconto do tipo buy_x_pay_y.

start_atstring date-time required

Data e hora de início

end_atstring date-time required

Data e hora de término

Example request

{
  "active": true,
  "max_value": 100,
  "percent": 5,
  "start_at": "2025-06-01 00:00:00",
  "end_at": "2025-08-10 00:00:00"
}

Response

Desconto progressivo criado com sucesso

idinteger

ID do desconto progressivo.

activeboolean

Indica se o desconto progressivo está ativo.

min_valuenumber float

Valor mínimo do subtotal do carrinho, em reais, para a faixa de desconto valer.

max_valuenumber float

Valor máximo do subtotal do carrinho, em reais, para a faixa de desconto valer.

percentnumber float

Percentual de desconto aplicado ao subtotal do carrinho quando a faixa é atendida.

min_quantityinteger

Quantidade mínima de itens no carrinho para a faixa valer, usada quando o desconto é por quantidade.

accumulateboolean

Indica se o desconto pode ser acumulado com outras promoções da loja.

expiredboolean

Indica se a data de término do desconto já passou.

Example response

{
  "max_value": 100,
  "percent": 5
}

Changes

No recorded changes to this operation across all 3 revisions of this API.