Lançar o estoque inicial
Produto recém-cadastrado entra com saldo zero: o estoque só existe a partir de movimentação. O saldo de abertura de cada SKU é lançado como ajuste positivo, um a um, no depósito onde a mercadoria está.
Como fazer
- Confira em Estoque → Depósitos que existe um depósito ativo. Sem ele não há onde lançar.
- Em Estoque → Ajuste / Inventário, escolha o Depósito.
- Em Produto (SKU), busque a variação por SKU ou nome.
- Em Tipo de ajuste, deixe Ajuste positivo.
- Informe a Quantidade (valor absoluto) — sempre positiva.
- Em Observação (opcional), registre a justificativa (ex.: saldo de abertura).
- Clique em Registrar movimentação e repita para o próximo SKU.
- Confira o resultado em Estoque → Posição, com ou sem filtro de depósito.
O que o sistema faz sozinho
A empresa não nasce com depósito. A criação de uma empresa semeia sozinha o plano de contas, a tabela de preço padrão, a configuração de vendas e os módulos — depósito não está na lista. Empresa nova chega sem nenhum, e o primeiro precisa ser criado à mão em Estoque → Depósitos antes de qualquer lançamento.
O sinal do lançamento vem do Tipo de ajuste, aplicado no servidor, e a tela responde com o saldo resultante. Saldo negativo não bloqueia — só troca a confirmação por um aviso.
Ajuste e inventário não são a mesma coisa. O ajuste é um lançamento avulso, para saldo de abertura, perda, avaria ou sobra. O inventário (Estoque → Inventários) é a contagem formal: Novo inventário cria o rascunho, Abrir contagem congela um retrato dos saldos do depósito, Concluir contagem fecha a digitação e Conciliar gera de uma vez as movimentações da diferença de cada SKU.
A movimentação de estoque não é editável nem apagável. Errou a quantidade, o conserto é um novo ajuste no sentido contrário, e os dois ficam no histórico.
Ajuste manual entra sem custo unitário. Quando ele é a primeira movimentação daquele SKU no depósito, o custo médio nasce em R$ 0,00 — a entrada de nota de compra é que forma o custo.
Quando não funciona
- O inventário não lista o produto novo — o retrato de Abrir contagem sai da posição de estoque, e SKU que nunca se movimentou não tem posição. Por isso o saldo inicial não pode ser lançado por inventário: o ajuste é o único caminho. ⚠️ A própria tela de ajuste exibe um aviso mandando ir para Inventários — vale para a contagem periódica, não para a abertura.
- "Faltam N SKU(s) sem qtd_contada — não é possível concluir." — o botão Concluir contagem fica desligado até a última linha ter quantidade.
- Não dá para desfazer o inventário conciliado — conciliado é estado final. Correções vão em ajustes novos.
- "Depósito inativo" ou "Depósito não encontrado nesta empresa" — o depósito precisa estar ativo e ser da empresa selecionada no topo.
- "Produto (variação) não encontrado ou inativo nesta empresa" — a variação ou o produto está desativado.
- "Deve ser maior que zero" — a Quantidade não aceita zero nem negativo. Para tirar saldo, troque o Tipo de ajuste para Ajuste negativo e deixe a quantidade positiva.
- "Você não tem permissão estoque.ajuste_manual nesta empresa. Peça ao admin_org pra conceder esse papel." — a tela inteira fica bloqueada.
- A coluna Custo médio não aparece na Posição — ela é liberada só a quem
tem
financeiro.view, além de admin da organização e superadministrador.