Inventário
A tela de Inventário é o histórico de ajustes de saldo feitos no estoque. Cada linha representa uma correção de quantidade lançada manualmente — quem fez, em qual armazém, em qual SKU/lote, quanto contou e o motivo (comentário). É também a partir dessa tela que se faz um Ajuste de Estoque rápido: usar o leitor de código de barras para localizar um SKU/endereço, conferir os lotes e lançar a nova quantidade contada — o sistema gera automaticamente a entrada ou saída para igualar o saldo ao que foi conferido.
A tela tem visualização em Lista com filtros por data, código de referência, código SKU, nome, código de barras e busca rápida. Não há ações em lote.
Esta é a tela legacy — em telas novas use a Novo Inventário (
/app/sku/inventory), que dá mais controle (tipos de inventário, fila de contagem, múltiplas conferências, atribuição de colaboradores). A Inventário continua disponível para ajustes pontuais e para consultar o histórico de correções antigas.
Índice
Conceito
Cadastro e edição
Busca e visualização
Regras de negócio
Configurações
Referência rápida
O que é a tela Inventário?
É o histórico de ajustes de saldo lançados no estoque. Cada linha mostra uma única correção de quantidade — para um SKU, em um lote, em um armazém, em uma data, com um comentário e o usuário responsável. A tela também tem a ação Conferência Inventário, um modal de leitor de código de barras que permite localizar um SKU ou endereço, ver os lotes existentes e lançar uma nova quantidade contada — o sistema cria automaticamente o registro de ajuste e a movimentação de estoque correspondente.
📍 Onde: menu lateral → Produtos → Inventário.
Qual a diferença entre Inventário e Novo Inventário?
São duas telas diferentes para gerenciar contagem de estoque, com escopos distintos:
| Inventário (esta tela) | Novo Inventário | |
|---|---|---|
| Quando usar | Ajustes pontuais e consulta de histórico | Inventários planejados com lista de contagem |
| Listagem | Histórico cronológico de correções | Inventários abertos/fechados com status próprio |
| Contagem | Lançamento direto via leitor de código de barras (modal Conferência Inventário) | Tela dedicada por inventário com fila de SKUs/endereços, múltiplas conferências e atribuição de colaboradores |
| Tipos de inventário | Não tem (sempre é livre) | Endereço, SKU, Livre, Auditoria |
| Conferências | Uma só (lançamento direto) | 1ª, 2ª e 3ª conferência |
| Auditoria automática | Não | Sim (tipo Auditoria) |
| Recomendado para | Correções rápidas após operação | Fechamentos periódicos e auditorias formais |
📍 A tela Novo Inventário fica em Produtos → Novo Inventário.
Como fazer um ajuste de estoque pela tela Inventário?
Acesse Produtos → Inventário e clique em Conferência Inventário no topo. Na janela que abre:
- (Quando a empresa tem mais de uma conta) Selecione a Conta.
- Selecione o Armazém (o padrão aparece marcado).
- Marque Buscar inativos? se quiser incluir lotes inativos na busca.
- No campo Escanear, leia ou digite o endereço, o código de referência ou o código de barras do produto que vai conferir, e pressione Enter.
- O sistema mostra a lista de lotes encontrados. Para cada lote, digite no campo Quantidade o valor que foi contado fisicamente. Lotes que não precisam de correção podem ficar em branco — só os preenchidos viram ajuste.
- Preencha o campo Comentários explicando o motivo (auditoria, recontagem, perda, achado, etc.) — é obrigatório.
- Clique em Salvar. O sistema processa linha por linha e mostra o resultado de cada lançamento.
Quando precisar fazer ajustes em vários armazéns ou produtos, repita o processo para cada um.
Cadastros que você precisa ter antes
- Armazém — em Logística → Armazéns (precisa estar ativo).
- SKU com lote — quando o SKU ainda não tem nenhum lote no armazém, o sistema cria automaticamente um lote no endereço padrão ("Principal") no primeiro lançamento.
Quais campos são obrigatórios no ajuste?
No modal Conferência Inventário são obrigatórios:
- Armazém — onde o ajuste vai ser feito.
- Escanear — algum SKU/endereço precisa ter sido buscado antes de salvar.
- Comentários — texto livre justificando o ajuste.
- Quantidade — pelo menos um lote da lista precisa ter quantidade preenchida.
Quando há mais de uma conta cadastrada, Conta também é obrigatória.
Como buscar e filtrar o histórico de inventário?
Use o painel Filtros no topo da lista. Filtros disponíveis:
- Data inventário — intervalo de datas em que o ajuste foi feito.
- Código referência — busca pelo código do SKU na empresa.
- Código SKU — busca pelo código interno do produto.
- Nome — busca pelo nome do produto.
- Código de barras — busca pelo código de barras principal do SKU.
A busca rápida (lupa no topo) procura simultaneamente em código SKU, nome, código de barras e código de referência.
O que cada coluna da lista mostra?
| Coluna | O que mostra |
|---|---|
| Data criação | Data e hora em que o ajuste foi lançado. |
| Referência | Código de referência do SKU na empresa. |
| Nome | Nome do produto. Clique para abrir a ficha do SKU em nova aba. |
| Cód. barras | Código de barras principal do SKU. |
| Quantidade | Quantidade contada que foi lançada nesse ajuste. |
| Armazém | Armazém onde o ajuste foi feito. |
| Usuário | Login do usuário que lançou o ajuste. |
| Comentários | Texto livre informado no lançamento. |
| Id.lote | Código do lote ajustado. |
Como o sistema calcula o ajuste a partir da quantidade contada?
O sistema compara a quantidade contada que você lançou com o saldo atual do lote no armazém e gera uma movimentação:
- Contagem > saldo atual → entrada de estoque pela diferença.
- Contagem < saldo atual → saída de estoque pela diferença.
- Contagem = saldo atual → não gera movimentação.
O custo aplicado em cada movimentação vem do Custo Médio do SKU naquele armazém. Quando o custo médio é zero, o sistema usa o Custo Última Compra. Quando a parametrização Utilizar custo manual SKU está ativa, o sistema usa o Custo Manual cadastrado na ficha do SKU.
Cada movimentação dispara uma notificação Ajuste de Saldo para sistemas externos integrados via webhook (quando configurado).
Quando um lançamento é rejeitado?
O sistema processa cada linha do ajuste separadamente e reporta erros individuais. Motivos comuns de rejeição:
- SKU não cadastrado — o produto buscado não existe na conta.
- Item não é do tipo SKU — só Produto, Kit ou Insumo aceitam ajuste de saldo (Kits sem variação, Insumos e Produtos finais).
- Quantidade para ajustar saldo não é um número — campo Quantidade veio em branco ou com texto inválido.
- Armazém não cadastrado — armazém informado não pertence à conta ou está inativo.
- Lote não encontrado — o lote informado não existe.
- Lote não pertence ao armazém — o lote informado pertence a outro armazém.
- Lote está inativo — o lote foi marcado como inativo.
Quando ocorre erro em alguma linha, o sistema continua processando as demais e devolve a lista de quais falharam, com a descrição do motivo. Os lançamentos válidos são gravados normalmente.
Como usar o custo manual do SKU no ajuste?
Ative a parametrização Utilizar custo manual SKU. Com ela ligada, todo ajuste de inventário aplica o Custo Manual cadastrado na ficha do SKU em vez do custo médio ou do custo da última compra. A regra também vale para o cálculo de margem das vendas feitas após a ativação.
Para configurar: Configurações → Parametrizações → Produto, ative a parametrização e salve. Em seguida, cadastre o Custo Manual desejado em cada SKU em Produtos → Produtos e SKUs.
Resumo de parametrizações
Configurações da empresa que afetam esta tela. Para ativar ou desativar, acesse Configurações → Parametrizações, abra o submenu indicado e habilite ou desabilite a parametrização.
| Parametrização | Submenu | O que muda quando ativada |
|---|---|---|
| Utilizar custo manual SKU | Produto | O ajuste de saldo gerado pela tela Inventário aplica o Custo Manual cadastrado na ficha do SKU no lugar do custo médio do armazém ou do custo da última compra. A regra também vale para o cálculo de margem das vendas feitas após a ativação. |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar Inventário | Acesso à tela e ao histórico de ajustes da conta. |
| Criar Inventário | Lançar ajustes pela ação Conferência Inventário. |
| Deletar Inventário | Excluir um ajuste já lançado (quando habilitado pela operação). |