# 10. 🔄 Movimentações de Estoque

**Histórico detalhado de movimentações** Rastreabilidade completa de todas as operações de estoque. **Tipos de movimento:**

* Entradas (compras, ajustes, devoluções)
* Saídas (vendas, transferências, perdas)
* Transferências entre depósitos
* Inventários e acertos de estoque

## Lista movimentações de estoque

> Retorna lista de movimentações de estoque com filtros

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"10. 🔄 Movimentações de Estoque","description":"**Histórico detalhado de movimentações**\nRastreabilidade completa de todas as operações de estoque.\n**Tipos de movimento:**\n- Entradas (compras, ajustes, devoluções)\n- Saídas (vendas, transferências, perdas)\n- Transferências entre depósitos\n- Inventários e acertos de estoque"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/estoque/movimentacoes":{"get":{"summary":"Lista movimentações de estoque","tags":["10. 🔄 Movimentações de Estoque"],"description":"Retorna lista de movimentações de estoque com filtros","parameters":[{"name":"data_inicio","in":"query","schema":{"type":"string","format":"date"},"description":"Data de início","required":false},{"name":"data_fim","in":"query","schema":{"type":"string","format":"date"},"description":"Data de fim","required":false},{"name":"tipo","in":"query","required":false,"schema":{"type":"integer","enum":[0,1]},"description":"Tipo da movimentação de estoque (0 = saída, 1 = entrada)"},{"name":"motivo","in":"query","required":false,"schema":{"type":"integer","enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"description":"Código do motivo da movimentação de estoque"},{"name":"page","in":"query","description":"Número da página","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de movimentações","content":{"application/json":{"schema":{"type":"object","properties":{"movimentacoes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID da movimentação"},"numero_cupom":{"type":"string","nullable":true,"description":"Número do cupom"},"numero_nota_fiscal":{"type":"string","nullable":true,"description":"Número da nota fiscal"},"quantidade":{"type":"string","description":"Quantidade movimentada"},"preco_unitario":{"type":"number","format":"float","description":"Preço unitário"},"tipo":{"type":"string","description":"Tipo da movimentação (Entrada/Saída)"},"status":{"type":"string","description":"Status da movimentação"},"dthr_confirmacao":{"type":"string","format":"datetime","nullable":true,"description":"Data e hora da confirmação"},"observacao":{"type":"string","nullable":true,"description":"Observações"},"produto":{"type":"object","properties":{"id":{"type":"integer","description":"ID do produto"},"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"preco_unitario":{"type":"string","description":"Preço unitário do produto"},"quantidade":{"type":"string","description":"Quantidade em estoque"}}}}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Exibe movimentação específica

> Retorna detalhes de uma movimentação específica

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"10. 🔄 Movimentações de Estoque","description":"**Histórico detalhado de movimentações**\nRastreabilidade completa de todas as operações de estoque.\n**Tipos de movimento:**\n- Entradas (compras, ajustes, devoluções)\n- Saídas (vendas, transferências, perdas)\n- Transferências entre depósitos\n- Inventários e acertos de estoque"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/estoque/movimentacoes/{id}":{"get":{"summary":"Exibe movimentação específica","tags":["10. 🔄 Movimentações de Estoque"],"description":"Retorna detalhes de uma movimentação específica","responses":{"200":{"description":"Movimentação encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"ID da movimentação"},"numero_cupom":{"type":"string","nullable":true,"description":"Número do cupom"},"numero_nota_fiscal":{"type":"string","nullable":true,"description":"Número da nota fiscal"},"quantidade":{"type":"string","description":"Quantidade movimentada"},"preco_unitario":{"type":"number","format":"float","description":"Preço unitário"},"tipo":{"type":"string","description":"Tipo da movimentação (Entrada/Saída)"},"status":{"type":"string","description":"Status da movimentação"},"dthr_confirmacao":{"type":"string","format":"datetime","nullable":true,"description":"Data e hora da confirmação"},"observacao":{"type":"string","nullable":true,"description":"Observações"},"produto":{"type":"object","properties":{"id":{"type":"integer","description":"ID do produto"},"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"preco_unitario":{"type":"string","description":"Preço unitário do produto"},"quantidade":{"type":"string","description":"Quantidade em estoque"}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Movimentação não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```