Skip to main content
O módulo de Estoque registra as movimentações que alteram o saldo de produtos (entradas e saídas) e permite consultar o saldo consolidado por produto ou filial.

Registrar uma saída de estoque

Use POST /v2/estoque/saida.

Campos obrigatórios

Só codigoDaFilial e quantidade são obrigatórios.
Exemplo:
Resposta:
Campos obrigatórios ausentes ou inválidos retornam 400 com o detalhe em notifications/errors.

Registrar uma entrada de estoque

POST /v2/estoque/entrada segue a mesma lógica, acrescentando dataDaEntrada como campo obrigatório:

Consultar saldo

Saldo por produto

GET /v2/estoque/produto/{id} retorna o saldo consolidado de um produto específico.

Saldo por filial

GET /v2/estoque/filial/{id} retorna os saldos de todos os produtos de uma filial.
GET /v2/estoque/movimentacoes/produto/{id} retorna o histórico de entradas e saídas de um produto — útil para conferir a origem de uma divergência de saldo.

Inventário

O módulo também suporta o ciclo completo de Inventário de Estoque (/v2/estoque/inventario): abertura do inventário, cadastro de contagens por produto, validação e, por fim, processamento — que ajusta o saldo em estoque conforme as quantidades contadas.
O Endereçamento de Produto (/v2/estoque/enderecamento) complementa o inventário, mapeando em qual seção/local físico cada produto está armazenado.