Skip to main content
PUT
Atualizar combo de produtos
Envie somente os campos alterados, para reduzir validações desnecessárias. Caso não envie um campo, o mesmo será mantido com o valor atual.

Authorizations

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

Path Parameters

alias
string
required

Alias da loja

id
integer
required

ID do combo de produtos

Body

application/json

Dados para criação ou atualização de um combo de produtos

active
boolean
required

Status do combo

Example:

true

name
string
required

Nome do combo

Minimum string length: 3
Example:

"Combo Verão 2025"

products_ids
integer[]
required

IDs dos produtos que compõem o combo

Example:
discount_type
enum<string>
required

Tipo de desconto (p: percentual, v: valor fixo)

Available options:
p,
v
Example:

"p"

discount_value
number<float>
required

Valor do desconto

Example:

10

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-07-31 23:59:59"

accumulate
boolean

Indica se o desconto acumula com outras promoções

Example:

true

Response

Combo atualizado com sucesso

Conjunto de produtos que recebe desconto quando comprados juntos.

id
integer

ID do combo.

active
boolean

Indica se o combo está ativo.

accumulate
boolean

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

name
string

Nome do combo, com até 100 caracteres.

Example:

"Combo test"

description
string

Descrição do combo. Devolvida como nula quando não preenchida.

products_ids
integer[]

IDs dos produtos que compõem o combo.

discount_type
enum<string>

Tipo de desconto (p para percentual, v para valor)

Available options:
p,
v
discount_value
number<float>

Valor do desconto do combo: percentual quando discount_type for p, ou valor em reais quando for v.

Example:

10

expired
boolean

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

total_products
integer

Quantidade de produtos vinculados ao combo.

start_at
object

Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.

end_at
object

Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.

created_at
object

Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.

updated_at
object

Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.