> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gestio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Movimentações de entrada e saída, saldo e inventário de estoque

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`.

<Card title="Campos obrigatórios" horizontal>
  Só `codigoDaFilial` e `quantidade` são obrigatórios.
</Card>

**Exemplo:**

```json theme={null}
POST /v2/estoque/saida
{
  "codigoDaFilial": 1,             // obrigatório
  "quantidade": 10,                // obrigatório
  "idProd": 1234,                  // opcional - id. do produto
  "codigoDoAlmoxarifado": 2,       // opcional
  "codigoDaSecao": "A1",           // opcional
  "codigoDoCentroDeCusto": "001",  // opcional
  "codigoDoProjeto": 55            // opcional
}
```

**Resposta:**

```json theme={null}
{
  "success": true,
  "data": {
    "numeroDaSaida": 78210,
    "seq": 1,
    "codigoDaFilial": 1,
    "idProd": 1234,
    "quantidade": 10
  }
}
```

<Tip>
  Campos obrigatórios ausentes ou inválidos retornam `400` com o detalhe em `notifications`/`errors`.
</Tip>

## Registrar uma entrada de estoque

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

```json theme={null}
POST /v2/estoque/entrada
{
  "codigoDaFilial": 1,           // obrigatório
  "dataDaEntrada": "2026-07-29", // obrigatório
  "quantidade": 500,             // obrigatório
  "idProd": 1234                 // opcional
}
```

## Consultar saldo

<CardGroup cols={2}>
  <Card title="Saldo por produto" icon="package" horizontal>
    `GET /v2/estoque/produto/{id}` retorna o saldo consolidado de um produto específico.
  </Card>

  <Card title="Saldo por filial" icon="building" horizontal>
    `GET /v2/estoque/filial/{id}` retorna os saldos de todos os produtos de uma filial.
  </Card>
</CardGroup>

`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.

<Note>
  O **Endereçamento de Produto** (`/v2/estoque/enderecamento`) complementa o inventário, mapeando em qual seção/local físico cada produto está armazenado.
</Note>