Preços programados

Toda faixa de preço aceita startDateTime e endDateTime. Publicar com antecedência é mais seguro do que depender de um job disparar no horário exato — se o job falhar, a promoção simplesmente não acontece; com janela de vigência, ela entra sozinha.

Publicar uma promoção futura


[
  {
    "skuExternalReference": "114970",
    "externalReference": "PRECO-114970-BLACKFRIDAY",
    "commercialPolicyId": "9c1f5a3e-7b2d-4c8e-9f01-2a3b4c5d6e7f",
    "listPrice": { "value": 10.49 },
    "basePrice": {
      "value": 6.99,
      "startDateTime": "2026-11-27T00:00:00",
      "endDateTime": "2026-11-27T23:59:59"
    }
  }
]

Nesse exemplo o item fica a R$ 6,99 durante a sexta-feira inteira no horário de Brasília, exibindo “de R$ 10,49 por R$ 6,99”, e volta ao normal sozinho.

O que acontece ao fim da janela

Quando endDateTime passa, o preço com janela deixa de valer e a vitrine volta ao valor sem janela daquele SKU. Se não existir um preço permanente configurado, o item fica sem preço — e some da vitrine.

Antes da campanha

Garanta que o SKU tem um basePrice sem janela — o preço “normal” ao qual ele retorna.

Durante a campanha

Publique o preço promocional com janela. Ele tem precedência enquanto vigente.

Depois

O preço sem janela volta a valer automaticamente. Nada a fazer.

O erro clássico é publicar só o preço com janela, sem o preço permanente. A promoção funciona lindamente e, no minuto seguinte ao fim, o item desaparece da loja.

Conferir o que está programado

Não há endpoint público de listagem de preços futuros na API de integração. Duas alternativas práticas:

Guardar no ERP o que foi publicado, com o operationId de cada lote — é a fonte de verdade mais confiável e não depende de consulta.
Consultar o painel administrativo, que mostra as faixas vigentes e programadas por SKU.

Antecedência recomendada

Tipo de campanha	Publicar com
Troca de tabela mensal	2 a 3 dias
Promoção de fim de semana	1 dia
Data comemorativa (Black Friday, Natal)	1 semana

Publicar cedo dá tempo de conferir na vitrine de homologação e corrigir sem pressa. O custo de publicar antes é zero — a janela cuida do resto.