Kardex
Módulo: Estoque Caminho na aplicação: Menu > Estoque > Kardex (/estoque/kardex) Última atualização: 20/04/2026
Para que serve
Exibe o extrato cronológico e imutável de movimentações de um produto em um depósito específico. Para cada linha mostra o saldo posicional e o custo médio antes e depois da movimentação, permitindo rastrear toda a vida do produto no estoque. Funciona como relatório de consulta — nenhuma edição é possível.
Quem pode usar
Todos os usuários com acesso ao módulo Estoque.
Como usar (passo a passo)
- Acesse Menu > Estoque > Kardex.
- Selecione o Produto (campo obrigatório com busca por nome).
- Selecione o Depósito (campo obrigatório).
- Se o produto controla lote, o campo Lote aparece automaticamente — deixe em branco para ver todos os lotes ou selecione um específico.
- Opcionalmente, informe o Período (data de / data até) para restringir o intervalo.
- Clique em Consultar.
- O painel de resumo exibe produto, depósito, saldo atual e custo médio atual.
- A tabela abaixo lista todas as movimentações em ordem cronológica.
- Clique em Limpar para reiniciar a consulta.
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Produto | Sim | Pesquisar e selecionar | Lista todos os produtos cadastrados |
| Depósito | Sim | Selecionar da lista | Exibe código e descrição |
| Lote | Não | Selecionar da lista | Aparece somente se o produto controlar lote; exibe situação de validade |
| Período (de / até) | Não | Intervalo de datas no formato DD/MM/AAAA | Sem preenchimento retorna todo o histórico |
Colunas da tabela de movimentações
| Coluna | Descrição |
|---|---|
| Data | Data e hora da movimentação (DD/MM/AAAA HH:mm) |
| Tipo | Entrada, Saída, Ajuste, Reserva, Liberação ou Estorno |
| Documento | Número do documento de origem quando disponível |
| Quantidade | Valor com sinal: + entrada/ajuste, − saída/liberação, ± reserva |
| Custo unit. | Custo unitário registrado na movimentação (R$) |
| Custo total | Custo total da movimentação (R$) |
| Saldo ant. | Saldo antes da movimentação (4 casas decimais) |
| Saldo atual | Saldo após a movimentação (4 casas decimais) |
| Médio ant. | Custo médio antes da movimentação (R$) |
| Médio atual | Custo médio após a movimentação (R$) |
| Lote | Número do lote com indicador de validade |
| Origem | Sistema de origem da movimentação (pedido, NF-e, ajuste, inventário) |
| Usuário | Nome do usuário responsável |
| Observações | Texto livre registrado na movimentação |
Validações e regras
- Produto e Depósito são obrigatórios para executar a consulta.
- O kardex é imutável — nenhuma movimentação pode ser editada ou excluída por esta tela.
- Movimentações de tipo Reserva afetam a quantidade reservada, não a quantidade física.
- O saldo posicional de cada linha reflete o estado do estoque imediatamente após aquele evento.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione produto e deposito" | Tentativa de consultar sem preencher os campos obrigatórios | Selecione produto e depósito antes de clicar em Consultar |
| "Erro ao carregar kardex" (ou mensagem retornada pela API) | Falha de comunicação com o servidor | Aguarde e tente novamente |
| "Erro ao carregar produtos" | Falha ao buscar lista de produtos | Recarregue a página |
| "Erro ao carregar depositos" | Falha ao buscar lista de depósitos | Recarregue a página |
Integrações e dependências
- Usa o cadastro de Depósitos.
- Usa o cadastro de Lotes para produtos que controlam lote.
- Movimentações são geradas por pedidos de venda, NF-e de entrada e Movimentações de Estoque (ajustes manuais).
Dúvidas frequentes
Por que o campo Lote não aparece? O campo só aparece quando o produto selecionado tem "Controla lote" ativado em seu cadastro.
O saldo atual no resumo difere do que vejo na tela de Saldos. Verifique o período informado — sem filtro de período, o kardex retorna todo o histórico e o saldo final deve coincidir. Se o filtro de período estiver ativo, o saldo exibido é o do último movimento do intervalo.
Posso corrigir uma movimentação errada? Não — o kardex é imutável. Para corrigir, registre uma nova movimentação de ajuste em Movimentações de Estoque.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |