v1

latestOpenAPI 3.0.02026-07-26376212496.4 KB
Promoções - Combos

Criar combo de produtos

Cria um novo combo de produtos

post/{alias}/pricing/combos

Path parameters

aliasstring required

Alias da loja

Request body

activeboolean required

Status do combo

accumulateboolean

Indica se o desconto acumula com outras promoções

namestring required

Nome do combo

products_idsinteger[] required

IDs dos produtos que compõem o combo

discount_type'p' | 'v' required

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

discount_valuenumber float required

Valor do desconto

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,
  "accumulate": true,
  "name": "Combo Verão 2025",
  "products_ids": [
    123456,
    789012
  ],
  "discount_type": "p",
  "discount_value": 10,
  "start_at": "2025-06-01 00:00:00",
  "end_at": "2025-07-31 23:59:59"
}

Response

Combo de produtos criado com sucesso

idinteger
activeboolean
accumulateboolean
namestring
descriptionstring
products_idsinteger[]

IDs dos produtos que possuem essa customização

discount_type'p' | 'v'

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

discount_valuenumber float
expiredboolean
total_productsinteger
created_atstring date-time
updated_atstring date-time

Example response

{
  "name": "Combo test",
  "discount_value": 10
}