O que integrar para a Ruptura
O que o módulo de Ruptura precisa do seu ERP para achar o produto que falta na gôndola, e o que você recebe de volta.
A Ruptura encontra o produto que está no estoque mas não está na gôndola. O BIX olha a venda: um produto que parou de vender muito antes do normal para o giro dele, ou que ficou dias sem vender, vira uma ruptura provável. A loja recebe uma tarefa no app, confere na gôndola e responde. O que faltou pode virar uma tarefa de reposição.
sequenceDiagram
participant ERP as Seu ERP
participant BIX as BIX
participant Loja as Loja (app)
ERP->>BIX: produtos, estrutura, saldo da loja e do CD
ERP->>BIX: venda, com o perfil por hora (uma vez ao dia, a cada intervalo ou em tempo real)
BIX->>BIX: rupturas prováveis (não venda)
BIX->>Loja: tarefa de auditoria na gôndola
Loja->>BIX: ruptura confirmada ou não
BIX-->>ERP: itens auditados e rupturas prováveis
O que enviar
| Dado | Precisa? | Recurso | Para quê |
|---|---|---|---|
| Produtos | Obrigatório | POST/products |
A tarefa lista o produto pelo código interno |
| Estrutura mercadológica | Recomendado | POST/categories |
Separar as tarefas por departamento e deixar departamentos de fora |
| Saldo por loja | Obrigatório | POST/stock-prices |
Sem saldo positivo não é ruptura de gôndola, é falta de estoque |
| Saldo do CD | Recomendado | POST/stock-prices na loja do CD |
Diz se dá para repor |
| Curva ABC | Opcional | curve no POST/stock-prices ou sales_curve no produto |
Ordena a tarefa pelo mais importante |
| Venda do dia, com o perfil | Obrigatório | POST/sales/daily |
É de onde sai a ruptura provável |
O que ler
| Dado | Recurso |
|---|---|
| O que a loja achou em cada produto auditado | GET/rupture/items |
| As rupturas prováveis apontadas pela venda | GET/rupture/signals |
Com os eventos e webhooks, o BIX vai avisar o seu sistema quando a auditoria terminar
(task.finished) ou quando uma ruptura for confirmada na gôndola (rupture.changed), sem você
precisar consultar: Eventos e webhooks.