O que integrar para a Contagem

O que o módulo de inventário precisa do seu ERP para contar certo e mostrar a divergência contra o saldo.

Na Contagem (inventário), o operador conta a loja com o app, bipando os produtos, e o BIX compara o que foi contado com o saldo esperado. A diferença é a divergência, que vira recontagem, aprovação e ajuste.

Para isso, o BIX precisa reconhecer todo código que o operador bipar e saber quanto devia haver.

sequenceDiagram
    participant ERP as Seu ERP
    participant BIX as BIX
    participant App as App na loja
    ERP->>BIX: estrutura, produtos (todos os EANs)
    ERP->>BIX: preço e saldo por loja (e depósito)
    BIX->>App: tarefa de contagem com o catálogo da loja
    App->>BIX: contagens
    BIX->>BIX: divergência = contado − saldo
    BIX->>ERP: contagem final (abrir, enviar, encerrar)

A integração tem duas metades: o que o seu ERP envia para o BIX (esta página) e o que o ERP recebe do BIX quando a contagem termina (O que o ERP precisa ter).

O que enviar

Dado	Precisa?	Recurso	Para quê
Produtos, com todos os EANs	Obrigatório	POST`/products`	O operador bipa a unidade, a caixa, o fardo: código não cadastrado não é reconhecido
`multiplier` de cada EAN	Obrigatório	POST`/products`	Bipar uma caixa de 12 conta 12 unidades
Estrutura mercadológica	Recomendado	POST`/categories`	Contar por departamento, dividir a loja em seções e ver a divergência por seção
Preço e saldo por loja	Recomendado	POST`/stock-prices`	É o "esperado" da divergência e o valor em reais da diferença
Saldo por depósito	Se o ERP separa	POST`/stock-prices` com `warehouse`	Loja com estoque de loja e depósito separados: uma linha por depósito

Saldo: por depósito ou não?

O ERP tem um saldo só por loja: envie warehouse vazio. A divergência compara a loja inteira.
O ERP separa loja e depósito (ou vários depósitos): envie uma linha por depósito, com o mesmo código de depósito usado no BIX. A divergência sai por depósito.

A configuração da tarefa decide

O BIX usa o preço e saldo da loja na divergência quando a configuração da tarefa de contagem está com essa opção ligada. Combine com o administrador do BIX do cliente qual configuração as tarefas usam.

Quando enviar o saldo

O saldo que vale é o do momento da contagem. Mande a carga de saldo das lojas que vão ser contadas antes do início da tarefa e, de preferência, congele as movimentações no ERP durante o inventário. Saldo que chega no meio da contagem muda a divergência.

Depois da contagem

O resultado volta para o ERP sem digitação: o BIX abre o inventário no ERP quando a tarefa é criada, envia a quantidade final de cada produto e pede o encerramento. O que o ERP precisa expor para isso está em O que o ERP precisa ter.

Pronto para produção

[ ] Todo EAN vendido na loja está cadastrado, com o multiplier certo.
[ ] As lojas têm código de integração igual ao do ERP (GET/stores).
[ ] O saldo é enviado por loja (e por depósito, se o ERP separa) antes de cada inventário.
[ ] O preço de cada loja vai em price, para a divergência em reais.
[ ] O ERP expõe os endpoints de inventário para receber a contagem (O que o ERP precisa ter).