> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/09.-movimentacoes-de-estoque.md). # 09. 🔄 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":"09. 🔄 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":["09. 🔄 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":"09. 🔄 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":["09. 🔄 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"}}}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://changelog.maino.com.br/api-reference-maino/09.-movimentacoes-de-estoque.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.