Rebaixa de preço por validade

Busque as rebaixas que o BIX calculou, crie a promoção no seu ERP e confirme quando ela entrou no PDV.

O BIX calcula a rebaixa de cada produto perto do vencimento, pela regra do cliente (o percentual de cada cor). A etiqueta é impressa na loja, e o preço precisa ir para o caixa. É aqui que o seu ERP entra: ele busca a rebaixa, cria a promoção e confirma.

stateDiagram-v2
    [*] --> aguardando_impressao: rebaixa calculada (e aprovada)
    aguardando_impressao --> aguardando_pdv: etiqueta impressa
    aguardando_pdv --> ativa: ERP confirma "applied"
    ativa --> encerrada: venceu, vendeu, mudou de cor
    encerrada --> [*]: ERP confirma "removed"

1. Buscar as rebaixas

GET/markdowns

curl "https://demonstracao.appbix.com.br/external-api/v1/markdowns?status=aguardando_pdv,encerrada&updated_since=2026-11-10T00:00:00-03:00" \
  -H "Authorization: Bearer $BIX_API_KEY"

Cada rebaixa vem no formato padrão do BIX para publicar rebaixa em um ERP, o contrato bix.markdown.publication/v1:

Bloco	O que tem
`markdown`	`percent`, `full_price` (o "de"), `reduced_price` (o "por"), `quantity`, vigência `starts_on` a `ends_on`, `expiry_date`
`store`	A loja, com o código de integração e o CNPJ
`product`	`internal_code`, `ean`, `description`

A vigência termina na véspera da próxima cor (verde e amarela) ou no último dia da rebaixa (vermelha): crie a promoção com essas datas.

2. Confirmar

POST/markdowns/publications

{"items": [{"markdown_id": 4410, "result": "applied", "external_code": "PROMO-77812"}]}

`result`	Quando	O que muda no BIX
`applied`	A promoção entrou no PDV	`aguardando_pdv` → `ativa`, como no botão "Aplicado no PDV" do Painel de Rebaixas do BIX
`error`	O ERP não conseguiu criar a promoção	`publication_status: erro`, com a mensagem no histórico da rebaixa
`removed`	A promoção de uma rebaixa encerrada saiu do PDV	`publication_status: encerrada_erp`

Repetir a mesma confirmação não muda nada (volta skipped).

De onde vem o preço

O preço cheio da rebaixa é o price_regular do POST/stock-prices; sem ele, o price; sem ele, o preço do cadastro do produto. Mande o price_regular (o preço sem oferta) sempre que tiver.

O BIX também pode publicar

Esta página é a forma em que o seu ERP busca as rebaixas. Se o ERP tem API de promoção, o BIX pode publicar a rebaixa direto nele: O que o ERP precisa ter para a rebaixa. Use uma forma ou a outra, nunca as duas para o mesmo cliente, para a mesma promoção não ser criada duas vezes.