Developers
Guias · Validade

O que integrar para a Validade

O que o módulo de Validade e a rebaixa por validade precisam do seu ERP, e o que você recebe de volta.

A Validade acompanha as datas de validade por loja, produto e lote, e avisa por cor (verde, amarelo, vermelho) conforme o vencimento se aproxima. Com a rebaixa ligada, o BIX calcula o desconto de cada produto perto do vencimento, imprime a etiqueta e pede que o preço vá para o caixa.

sequenceDiagram
    participant ERP as Seu ERP
    participant BIX as BIX
    participant Loja as Loja (app)
    ERP->>BIX: produtos, preço e saldo por loja
    ERP->>BIX: validades dos lotes recebidos
    Loja->>BIX: validades coletadas na gôndola e auditorias
    BIX->>BIX: alerta por cor e rebaixa calculada
    alt O ERP busca
        ERP->>BIX: busca as rebaixas a aplicar
        ERP->>BIX: confirma: aplicada no PDV
    else O BIX publica
        BIX->>ERP: cria a promoção e, no fim, encerra
    end

O que enviar

Dado Precisa? Recurso Para quê
Produtos Obrigatório POST/products A validade aponta para o produto do cadastro
Validades do ERP Opcional POST/expiries Sem elas, as validades vêm só da coleta na loja, pelo app
Preço por loja Para a rebaixa POST/stock-prices O preço cheio de que sai o preço rebaixado
Saldo por loja Recomendado POST/stock-prices A quantidade que a rebaixa considera
Venda Para a rebaixa POST/sales/daily Encerra a rebaixa quando o lote rebaixado é vendido

O que ler

Dado Recurso
Validades, com a cor do alerta GET/expiries
Rebaixas a aplicar e a retirar do PDV GET/markdowns

E o que confirmar: POST/markdowns/publications.

O que o ERP precisa ter

Para a rebaixa chegar ao caixa sem digitação, o ERP busca as rebaixas na API pública e confirma, ou expõe uma API de promoção que o BIX chama para criar e encerrar a oferta. A segunda forma está em O que o ERP precisa ter para a rebaixa.

Guias