YAyampi
Promoções - Combos

Criar combo de produtos

Changed on

Cria um novo combo de produtos

post/{alias}/pricing/combos

Request

  • Base URL
    https://api.dooki.com.br/v2
  • URL
    https://api.dooki.com.br/v2/{alias}/pricing/combos
  • 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 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

ID do combo.

activeboolean

Indica se o combo está ativo.

accumulateboolean

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

namestring

Nome do combo, com até 100 caracteres.

descriptionstring

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

products_idsinteger[]

IDs dos produtos que compõem o combo.

discount_type'p' | 'v'

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

discount_valuenumber float

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

expiredboolean

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

total_productsinteger

Quantidade de produtos vinculados ao combo.

Example response

{
  "name": "Combo test",
  "discount_value": 10,
  "start_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "end_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "created_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "updated_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  }
}

Changes

  • bbafb577e11cRevision changes
    • breaking

      the response's property type changed from string to object, and format from date-time to no format for status

    • breaking

      the / response's property format changed from date-time to no format for status

    • breaking

      the / response's property format changed from date-time to no format for status

    • breaking

      the response's property type changed from string to object, and format from date-time to no format for status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      the response optional property became not read-only for the status

    • info

      the response optional property became not read-only for the status