Cadastro de Lote
Módulo: Estoque Caminho na aplicação: Menu > Estoque > Lotes > "Novo lote" ou ícone Editar em um lote Última atualização: 20/04/2026
Para que serve
Permite criar e editar lotes de produtos que possuem controle de lote ativado. Um lote registra a rastreabilidade de um conjunto de unidades do mesmo produto, incluindo datas de fabricação, validade e entrada, além de status de disponibilidade e vínculo com fornecedor e documento fiscal.
Quem pode usar
Todos os usuários com acesso ao módulo Estoque.
Como usar (passo a passo)
Criar um novo lote
- Acesse Menu > Estoque > Lotes e clique em Novo lote.
- Na seção Identificação, selecione o Produto e informe o Número do lote.
- Na seção Datas e validade, preencha as datas de fabricação, validade e entrada conforme disponível.
- Um alerta de validade é exibido automaticamente ao preencher a data de validade.
- Na seção Status e origem, defina o Status (padrão: Ativo), o fornecedor e o documento de entrada.
- Se o status for Bloqueado ou Quarentena, o campo Motivo torna-se obrigatório.
- Clique em Criar.
- O sistema salva o lote e redireciona para a tela de edição do registro criado (a URL passa a refletir o ID do novo lote).
Editar um lote existente
- Na Lista de Lotes, clique no ícone Editar (lápis) na linha desejada.
- Faça as alterações necessárias. O campo Produto não pode ser alterado após a criação.
- Clique em Salvar.
- O sistema atualiza o registro e recarrega os dados sem fechar a tela.
Campos da tela
Seção: Identificação
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Produto | Sim | Selecionar da lista | Apenas produtos com "Controla lote" ativado aparecem; não editável após criação |
| Número do lote | Sim | Código alfanumérico até 50 caracteres | Exemplo: "LOT-2026-001" |
Seção: Datas e validade
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Data de fabricação | Não | DD/MM/AAAA | Data em que o produto foi fabricado |
| Data de validade | Não | DD/MM/AAAA | Ao preencher, exibe alerta com dias restantes e classificação |
| Data de entrada | Não | DD/MM/AAAA | Padrão: data atual na criação |
Alerta de validade (exibido automaticamente)
| Classificação | Cor do alerta | Condição |
|---|---|---|
| Validade ok | Verde | Dentro do prazo normal |
| Atenção | Azul | — |
| Crítico | Amarelo | — |
| Vencido | Vermelho | Data de validade ultrapassada |
Seção: Status e origem
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Status | Sim | Ativo, Bloqueado ou Quarentena | Padrão: Ativo |
| Motivo | Sim (condicional) | Texto até 255 caracteres | Obrigatório quando status é Bloqueado ou Quarentena |
| Fornecedor | Não | Selecionar da lista | Fornecedor de origem do lote |
| Documento de entrada | Não | Texto até 50 caracteres | Exemplo: "NF 1234", "OC 567" |
| Observações | Não | Texto livre até 500 caracteres | Informações adicionais |
Validações e regras
- O Produto é obrigatório e somente aceita produtos com "Controla lote" ativado.
- O Produto não pode ser alterado após a criação do lote.
- O Número do lote é obrigatório e limitado a 50 caracteres
- Quando o status é Bloqueado ou Quarentena, o campo Motivo torna-se obrigatório.
- Ao salvar na criação, o sistema navega para a rota de edição (
/estoque/lotes/:id/editar) sem criar um novo registro ao recarregar a página. - Ao salvar na edição, o sistema recarrega os dados do backend e mantém o usuário na mesma tela.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione o produto" | Produto não selecionado | Selecione um produto com controle de lote |
| "Obrigatorio" | Número do lote em branco | Preencha o número do lote |
| "Obrigatorio para status nao-ativo" | Status Bloqueado ou Quarentena sem motivo | Preencha o campo Motivo |
| "Lote atualizado" | Edição salva com sucesso | — |
| "Lote criado" | Criação bem-sucedida | — |
| "Erro ao carregar lote" | Falha ao buscar o registro para edição | Recarregue a página |
| Mensagem retornada pela API | — | Leia a mensagem e corrija os dados |
Integrações e dependências
- Depende do cadastro de produtos com "Controla lote" ativado.
- Depende do cadastro de Fornecedores
- Lotes criados aqui ficam disponíveis para seleção em Movimentações de Estoque (ajuste manual) e no Kardex.
- A posição de estoque por lote é consultada em Saldos de Estoque.
Dúvidas frequentes
Não encontro o produto que quero na lista. O campo exibe apenas produtos com "Controla lote" ativado. Verifique a configuração do produto em seu cadastro.
Posso alterar o produto de um lote já criado? Não. O produto é fixo após a criação. Se necessário, crie um novo lote e remova o incorreto (somente se não houver saldo nem histórico).
O que acontece se eu bloquear um lote que tem saldo? O saldo continua registrado, mas o lote não fica disponível para novos movimentos de saída por ajuste manual
Posso colocar uma data de validade no passado? Sim. O sistema exibe o alerta "Este lote está vencido" mas não impede o salvamento.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |