v1

latestOpenAPI 3.0.02026-07-26376212496.4 KB

Promoções - Produtos

Criar promoção

Cria uma nova promoção

post/{alias}/pricing/promotions

Path parameters

aliasstring required

Alias da loja

Request body

activeboolean required

Status da promoção

all_productsboolean required

Aplicar em todos os produtos

utm_onlyboolean required

Exclusivo para UTM

highlight_on_menuboolean

Destacar no menu

accumulateboolean

Permite acumular com outras promoções

price_attribute'price_sale' | 'price_discount' required

Atributo de preço para aplicar desconto

namestring required

Nome da promoção

valuenumber float required

Valor do desconto

utm_sourcestring

Origem UTM

utm_campaignstring

Campanha UTM

start_atstring date-time required

Data e hora de início

end_atstring date-time required

Data e hora de término

collections_idsinteger[]

IDs das coleções

brands_idsinteger[]

IDs das marcas

categories_idsinteger[]

IDs das categorias

banners_idsinteger[]

IDs dos banners

Example request

{
  "active": true,
  "all_products": true,
  "utm_only": true,
  "highlight_on_menu": true,
  "accumulate": true,
  "price_attribute": "price_discount",
  "name": "Black Friday 2025",
  "value": 123,
  "utm_source": "google",
  "utm_campaign": "black_friday",
  "start_at": "2025-11-25 00:00:00",
  "end_at": "2025-11-30 23:59:59",
  "collections_ids": [
    1,
    2
  ],
  "brands_ids": [
    1,
    2
  ],
  "categories_ids": [
    1,
    2
  ],
  "banners_ids": [
    1,
    2
  ]
}

Response

Promoção criada com sucesso

idinteger

activeboolean

all_productsboolean

utm_onlyboolean

highlight_on_menuboolean

accumulateboolean

price_attributestring

namestring

expiredboolean

urlstring uri

slugstring

valuenumber float

utm_sourcestring

utm_campaignstring

Example response

{
  "name": "Promoção relâmpago",
  "url": "https://www.domain.com/promocoes/test",
  "utm_source": "google",
  "utm_campaign": "adwords"
}