Controlando o Estoque

Este guia mostra como gerenciar o estoque dos seus insumos, incluindo movimentações, locais de armazenamento, lotes com validade e inventário físico.

Movimentações de Estoque

Verificar Estoque Atual#

1. Acesse Estoque no menu
2. Na lista, encontre o insumo (busque por nome, SKU ou código de barras)
3. Cada item mostra o status (Normal, Baixo ou Zerado) e a Quantidade

Para ver o estoque de um insumo específico, toque nele para abrir a página do insumo e acesse a seção Estoque, onde você vê o Estoque Atual, o Estoque Mínimo (quando definido) e o Estoque por Local.

As movimentações de entrada, saída e ajuste são feitas a partir da seção Estoque da página do insumo.

Adicionar Estoque (Entrada de Insumo)#

1. No insumo, abra a seção Estoque e clique em Adicionar Estoque
2. Se houver mais de um local ativo, selecione o Local
3. Preencha:
   • Quantidade a Adicionar: 50
   • Motivo: Compra fornecedor ABC - NF 12345
4. Clique em Adicionar Estoque

Resultado: Estoque anterior: 0 → Estoque atual: 50

Remover Estoque (Venda ou Perda)#

1. No insumo, abra a seção Estoque e clique em Remover Estoque
2. Se houver mais de um local ativo, selecione o Local
3. Preencha:
   • Quantidade a Remover: 5
   • Motivo: Venda - Pedido #123
4. Clique em Remover Estoque

Resultado: Estoque anterior: 50 → Estoque atual: 45

Definir Estoque (Inventário Físico)#

Quando a contagem física diverge do sistema:

1. No insumo, abra a seção Estoque e clique em Definir Estoque
2. Se houver mais de um local ativo, selecione o Local
3. Preencha:
   • Nova Quantidade de Estoque: 43
   • Motivo: Inventário físico - ajuste de divergência
4. Clique em Definir Estoque

Resultado: Estoque anterior: 45 → Estoque atual: 43

Atenção: o Motivo é obrigatório em todas as movimentações. É necessário ter ao menos um local de estoque ativo antes de movimentar — caso contrário, cadastre um local primeiro (veja Locais de Estoque).

Ajuste em Lote#

Para corrigir o estoque de vários insumos de uma só vez, use a página Ajuste em Lote:

1. Selecione o Local
2. Informe o Motivo do ajuste (compartilhado por todos os itens)
3. Em Adicionar Insumos, busque e toque nos insumos desejados — cada um entra na lista Insumos selecionados
4. Para cada insumo, informe a Nova qtd (a coluna Anterior mostra a quantidade atual)
5. Clique em Confirmar Ajuste

O sistema processa todos os itens de uma vez, registrando uma movimentação para cada insumo ajustado, e exibe um resumo com a transição de quantidade de cada insumo.

Consultar Histórico#

1. No insumo, abra a seção Estoque e toque em Movimentações
2. Veja todas as movimentações, com filtros por Tipo e Local e busca por texto:

Toque em uma movimentação para ver os detalhes (tipo, quantidade movimentada, estoque anterior e resultante, motivo e data).

Tipos de Movimentação#

Validações de Segurança#

O sistema impede:

• Remover mais do que tem em estoque (a quantidade a remover não pode exceder o estoque atual)
• Adicionar ou remover quantidade zero ou negativa
• Definir uma quantidade negativa
• Informar quantidades fracionárias para unidades que só aceitam números inteiros
• Acessar estoque de outra empresa (isolamento por empresa)

Casos de Uso Comuns#

Devolução de Cliente#

1. Na seção Estoque do insumo, clique em Adicionar Estoque
2. Quantidade a Adicionar: (quantidade devolvida)
3. Motivo: "Devolução cliente - Pedido #XXX"

Perda ou Avaria#

1. Na seção Estoque do insumo, clique em Remover Estoque
2. Quantidade a Remover: (quantidade perdida)
3. Motivo: "Avaria - insumo danificado"

Locais de Estoque

Os locais de estoque organizam seu inventário nos pontos físicos da fazenda: galpão de insumos, silo, pátio de máquinas e o estoque em trânsito entre eles.

Criar um Local#

1. No módulo Estoque, abra Localizações
2. Clique em Novo Local
3. Preencha:
   • Propriedade: a fazenda onde este local fica (opcional — veja Cadastrando a Terra)
   • Tipo de Local: Galpão de insumos, Silo / armazém, Pátio de máquinas ou Em trânsito
   • Nome do Local: nome do local (ex: "Galpão da sede", "Silo 2")
   • De quem é este local: deixe Depositário em branco para um local próprio, ou escolha o fornecedor que guarda seu grão ali — isso faz deste local um armazém de terceiro (veja Grão Armazenado)
   • Endereço: CEP, rua, número, complemento, bairro, estado e cidade (opcional)
4. Clique em Criar Local

Tipos de Local#

Vincular o local a uma propriedade é opcional: um local pode existir antes de qualquer propriedade cadastrada, e o silo de terceiro não tem propriedade sua por trás — ao escolher um depositário, o campo Propriedade deixa de ser pedido.

O pátio de máquinas guarda o que abastece e conserta a frota, não a frota em si. As máquinas ficam no módulo Máquinas, que é onde elas ganham valor por hora e horímetro. O diesel que sai deste local num abastecimento e a peça que sai numa manutenção dão baixa aqui.

Transferir Estoque entre Locais#

1. No módulo Estoque, abra Transferências
2. Selecione o Local de origem e o Local de destino (é preciso ter ao menos dois locais ativos)
3. Escolha o Insumo e informe a Quantidade (o campo mostra o estoque disponível)
4. Informe o Motivo da transferência (opcional)
5. Clique em Transferir Estoque

O sistema automaticamente remove do local de origem e adiciona no local de destino, registrando a movimentação em ambos.

Gerenciar Locais#

Na lista de locais, cada item mostra o tipo, o status (Ativo/Inativo) e a quantidade de lotes associados. Toque em um local para ver os detalhes:

• Informações do local: nome, tipo e status
• Endereço cadastrado (quando informado)
• Lotes associados ao local (atalho para a lista de lotes)
• Editar Local: alterar nome, tipo e endereço

Dica: Crie locais que reflitam sua estrutura física real e use nomes padronizados para facilitar a identificação.

Grão Armazenado

O grão colhido não entra no mesmo estoque dos insumos: ele tem saldo próprio, por armazém, cultura e safra. Grão é commodity — se mistura fisicamente dentro do silo — então o talhão de onde ele saiu não é rastreado depois que ele entra; a safra continua sendo, porque é o eixo de rateio de custo e receita da propriedade inteira.

Armazém de terceiro e depositário#

Além do armazém próprio, você pode cadastrar um armazém de terceiro: a cooperativa ou o armazém geral onde você guarda seu grão.

Ao criar ou editar um local, escolha o Depositário — o fornecedor que guarda o grão ali. Um armazém de terceiro não muda de tipo por isso: continua sendo silo, galpão ou o que já era, só que com um depositário do lado. Nas listas de saldo de grão, ele aparece identificado pelo depositário, ao lado dos seus armazéns próprios.

Local de terceiro não aceita propriedade própria vinculada — a tentativa é recusada. Faz sentido: se o armazém tem dono declarado (o depositário), ele não pode também estar dentro de uma das suas propriedades.

Entrada do grão colhido#

Depois de lançar a colheita em Safras e cultivos, registre a entrada no armazém como próxima ação:

1. Acesse Estoque > Grão Armazenado e clique em Nova entrada
2. Escolha o Armazém, a Cultura e a Safra
3. Informe a Quantidade, na unidade de produção da cultura — a mesma em que a colheita foi lançada
4. Escolha a Origem do grão: Colheita, Compra de terceiro ou Devolução
5. Para compra ou devolução, informe De quem veio
6. Informe a Data do movimento e, se quiser, Observações
7. Clique em Lançar entrada

Colheita sem entrada continua válida. Lançar a colheita e lançar a entrada no armazém são dois atos separados, e um produtor pode fazer o primeiro sem o segundo — o saldo mostra o colhido maior que o armazenado, com a diferença visível, e isso nunca é tratado como erro.

Grão comprado de terceiro entra pela mesma tela, com a origem Compra de terceiro: só a quantidade e de quem veio, sem lançamento financeiro — o custo dessa compra ainda não tem para onde ir no sistema. A origem fica visível no extrato, para que ninguém confunda com produção própria.

Saldo por armazém, cultura e safra#

Em Estoque > Grão Armazenado, a lista mostra o saldo de cada combinação de armazém, cultura e safra, com o armazém de terceiro identificado pelo depositário. Toque num saldo para ver o Extrato: entradas, saídas, transferências e perdas, cada uma com data, motivo e quem registrou.

O saldo pode ficar negativo. Quando sai mais grão do que o sistema registrou ter entrado — colheita subdeclarada, entrada esquecida —, o movimento é registrado do mesmo jeito e a tela avisa a diferença em vez de travar. É uma dívida do registro, não do armazém: confira o extrato e lance a entrada que falta.

Qualquer linha do extrato pode ser estornada, com o movimento original permanecendo visível e um estorno lançado contra ele — o saldo volta ao que era antes. Estornar uma perna de transferência estorna as duas: o grão volta ao armazém de origem.

Perda de armazenagem não é a mesma coisa que quebra#

O grão parado ou em trânsito perde peso: aeração, roedor, avaria no transporte. Registre essa perda:

1. No saldo do armazém, toque em Lançar perda
2. Informe a Quantidade e o Motivo da perda: Perda no armazém, Perda no transporte, Perda no embarque, Avaria ou Outra perda
3. Confirme

Isto não é a quebra da classificação do romaneio. A quebra — o desconto de umidade, impureza e avariados que a balança aplica no fechamento da carga (veja Classificar a carga) — já saiu do peso antes de o grão chegar ao armazém: o que entra no silo é o peso final, já descontado. Lançar aquele desconto de novo aqui descontaria o mesmo grão duas vezes.

São duas perdas, com nomes e origens diferentes, e nenhuma saca aparece nas duas:

Quem espera um único número de "quebra" precisa somar os dois — o sistema nunca soma sozinho, porque são contas diferentes.

A perda não é um ajuste de saldo. Não existe "definir saldo" para grão: uma contagem que não bate é sempre um movimento com motivo — uma perda, ou a entrada que faltava lançar. Corrigir um erro de digitação também é lançar o movimento contrário, com o motivo, e o extrato guarda as duas linhas — a errada e a correção.

Transferência entre armazéns#

1. No saldo do armazém de origem, toque em Transferir
2. Escolha o Armazém de destino, a Quantidade e a Data
3. Confirme

A transferência lança as duas pernas de uma vez, sempre na mesma quantidade: a saída do armazém de origem e a entrada no de destino. A perda no transporte, quando houver, é lançada à parte como perda (acima) — nunca como a diferença entre o que saiu de um lado e o que chegou no outro.

Conferência com o extrato do depositário#

O extrato que o armazém de terceiro te dá pode não bater com o seu, e o momento de descobrir isso é antes de perder o direito de reclamar:

1. No saldo do armazém de terceiro, toque em Conferir extrato do depositário
2. Informe a Data do extrato e a Quantidade que o depositário diz que você tem
3. Confirme

A tela mostra os dois números lado a lado e a diferença entre eles. A conferência não corrige nada — ela só registra o que os dois números diziam naquela data. Fechar a diferença é lançar um movimento com motivo: uma entrada, se você tinha mais do que achava, ou uma perda, se tinha menos.

Conferências antigas ficam no histórico; a mais recente é a que a tela destaca. Um armazém próprio não tem o que conferir — só existe conferência onde há um depositário do outro lado.

Lotes e Validades

O controle de lotes permite rastrear insumos por lote de fabricação, com data de validade, facilitando a gestão de perecíveis e o cumprimento de normas sanitárias.

Criar um Lote#

1. No módulo Estoque, abra Lotes
2. Clique em Novo Lote
3. Preencha:
   • Número do Lote: identificador do lote (ex: "LOT-2026-001")
   • Quantidade: quantidade de itens no lote
   • Insumo: selecione o insumo do catálogo
   • Local: selecione o local de estoque do lote
   • Data de Fabricação: quando o lote foi produzido (opcional)
   • Data de Validade: quando o lote expira (obrigatória; sugerida em 90 dias por padrão)
4. Clique em Criar Lote

Gerenciar Lotes#

Na lista de lotes, cada item exibe o status (Ativo, Vencido ou Quarentena) e, para lotes ativos próximos do vencimento, um indicador de validade. Toque em um lote para ver os detalhes: número, insumo, local, quantidade, datas de fabricação e validade.

Na página de detalhes você pode alterar o status do lote:

• Colocar em Quarentena: isola um lote Ativo (por exemplo, quando há suspeita de problema)
• Reativar Lote: devolve um lote em Quarentena para o status Ativo

Alertas de Vencimento#

Para lotes Ativos, o sistema sinaliza a proximidade do vencimento diretamente na lista e na página de detalhes:

• Lotes que vencem nos próximos 30 dias recebem um indicador de validade
• Lotes que vencem nos próximos 7 dias (ou já vencidos) são destacados como críticos

Dica: Priorize a venda de lotes com validade mais próxima (método FEFO - First Expired, First Out) para evitar perdas.

Permissões#

Boas Práticas#

1. Sempre documente: Use o campo "Motivo" para rastrear movimentações
2. Inventários regulares: Faça contagens físicas periódicas (mensal recomendado)
3. Permissões controladas: Limite quem pode adicionar/remover estoque
4. Audite o histórico: Revise movimentações para identificar perdas ou desvios
5. Organize por locais: Use locais para separar estoque de diferentes pontos físicos
6. Controle validades: Cadastre lotes para insumos perecíveis e monitore vencimentos
7. Lance a entrada da colheita logo: o saldo de grão só existe quando alguém registra a entrada — colheita sem entrada não é erro, mas fica invisível até você lançar
8. Confira o armazém de terceiro periodicamente: o extrato do depositário raramente bate sozinho com o seu; a conferência mostra a diferença enquanto ainda dá para reclamar