Skip to main content
POST
Criar desconto progressivo

Authorizations

User-Token
string
header
required
User-Secret-Key
string
header
required

Path Parameters

alias
string
required

Alias da loja

Body

application/json

Representa uma requisição de desconto progressivo

min_value
number<float>
required

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

Example:

0

max_value
number<float>
required

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

Example:

100

percent
number<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.

Example:

5

start_at
string<date-time>
required

Data e hora de início

Example:

"2025-06-01 00:00:00"

end_at
string<date-time>
required

Data e hora de término

Example:

"2025-08-10 00:00:00"

active
boolean

Define se o desconto progressivo está ativo.

Example:

true

restrictions
object

Restrições de aplicação do desconto progressivo.

exclude
object

Produtos, marcas, coleções e categorias em que o desconto não se aplica.

Response

Desconto progressivo criado com sucesso

Representa um desconto progressivo

id
integer

ID do desconto progressivo.

active
boolean

Indica se o desconto progressivo está ativo.

min_value
number<float>

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

max_value
number<float>

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

Example:

100

percent
number<float>

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

Example:

5

min_quantity
integer

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

accumulate
boolean

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

expired
boolean

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