/materiais/inventario · "Inventário" (aparece com materiais.inventario)materiais.visualizar. Contar exige materiais.inventario; apurar, materiais.inventario_apurar; reverter, materiais.reverter_inventario; excluir folha, materiais.excluir_inventario.Para que serve
É a contagem formal de um depósito: abre-se uma folha de contagem com o saldo congelado, conta-se o que há na prateleira (de preferência às cegas, sem ver o saldo do sistema), reconta-se o que for preciso e quem aprova a contagem apura: as diferenças viram ajustes no estoque, valorizados pelo custo médio. Quem conta não apura (o banco recusa quem contou algum item da folha) e, na folha cega, quem conta não recebe o saldo do sistema — nem na tela nem pela API: o saldo só aparece para quem apura sem ter contado e, para todos, depois de apurada. Só aparecem os depósitos dos contratos de gestão que você acompanha.
A tela, marcação por marcação
As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.
Visão geral da tela

- Aparece quando:
materiais.inventario. O que faz: abre a janela "Abrir contagem".
- O que faz: mostra a folha embaixo. Em contagem cega o saldo não vem para quem conta (aparece para quem apura sem ter contado e, para todos, depois de apurada). Não há botão para mostrar o saldo.
Folhas de contagem

O que faz: abre a janela "Abrir contagem".
Explicado em detalhes na Figura 1.
O que faz: mostra a folha embaixo. Em contagem cega o saldo não vem para quem conta (aparece para quem apura sem ter contado e, para todos, depois de apurada). Não há botão para mostrar o saldo.
Explicado em detalhes na Figura 1.
Folha contada por outra pessoa, pronta para apurar

O que faz: abre a janela "Abrir contagem".
Explicado em detalhes na Figura 1.
O que faz: mostra a folha embaixo. Em contagem cega o saldo não vem para quem conta (aparece para quem apura sem ter contado e, para todos, depois de apurada). Não há botão para mostrar o saldo.
Explicado em detalhes na Figura 1.
- O que faz: ao sair do campo, grava a contagem (com quem contou e quando). A recontagem só se abre depois da primeira contagem e, havendo recontagem, é ela que vale na apuração. Quem conta passa a ser contador da folha: numa folha cega o saldo some da tela dele e o "Apurar" deixa de ser dele.
- Se der errado: "Item não encontrado ou inventário já apurado" · "Item não encontrado ou de um depósito que você não acompanha" · "Sem permissão".
- Aparece quando: folha apurada e
materiais.reverter_inventario. - O que faz: estorna os ajustes; o saldo volta ao de antes e a folha volta a "contado" (pode recontar e apurar de novo). Mensagem: "Apuração revertida: a folha voltou a contada."
- Pede confirmação? Sim — janela de motivo "Reverter apuração", mínimo 10 caracteres.
- Se der errado: "O inventário … não está apurado." · "Sem permissão para reverter inventário".
- Observação: Como aparece: ao abrir uma folha com o selo verde "apurado", o cabeçalho "Folha <número>" mostra o botão vermelho "Reverter apuração" (no lugar de "Apurar e ajustar" e "Excluir folha", que somem), a coluna "Diferença" com o que foi ajustado e os campos "Contado" e "Recontagem" travados. Clicar abre a janela de motivo "Reverter apuração" ("Reverter a apuração deste inventário? Os ajustes de saldo são estornados e a folha volta a contada (pode recontar e apurar de novo)." e o campo do motivo, mínimo 10 caracteres) com "Cancelar" e "Desfazer". Depois: "Apuração revertida: a folha voltou a contada." — dá para recontar e apurar de novo. Quem pode: quem tem
materiais.reverter_inventario.
Folha apurada: ajuste lançado e o botão Reverter apuração

O que faz: abre a janela "Abrir contagem".
Explicado em detalhes na Figura 1.
O que faz: mostra a folha embaixo. Em contagem cega o saldo não vem para quem conta (aparece para quem apura sem ter contado e, para todos, depois de apurada). Não há botão para mostrar o saldo.
Explicado em detalhes na Figura 1.
O que faz: ao sair do campo, grava a contagem (com quem contou e quando). A recontagem só se abre depois da primeira contagem e, havendo recontagem, é ela que vale na apuração. Quem conta passa a ser contador da folha: numa folha cega o saldo some da tela dele e o "Apurar" deixa de ser dele.
Explicado em detalhes na Figura 3.
O que faz: estorna os ajustes; o saldo volta ao de antes e a folha volta a "contado" (pode recontar e apurar de novo). Mensagem: "Apuração revertida: a folha voltou a contada."
Explicado em detalhes na Figura 3.
Reverter apuração: a janela que pede o motivo

O que faz: mostra a folha embaixo. Em contagem cega o saldo não vem para quem conta (aparece para quem apura sem ter contado e, para todos, depois de apurada). Não há botão para mostrar o saldo.
Explicado em detalhes na Figura 1.
Como a tela está organizada (de cima para baixo)
- Avisos (vermelho / verde).
- Cartão "Inventários" — "Uma folha por depósito de cada vez." e o botão "Abrir contagem". Tabela das últimas 60: Número, Depósito, Descrição, Tipo ("cega"/"aberta"), Aberto em, Situação (selo "aberto"/"contado"/"apurado"), e "Abrir folha". Vazia: "Nenhuma contagem registrada."
- Folha aberta (abaixo, quando se clica em "Abrir folha") — "Folha <número>", "N item(ns) · N sem contar" (e "· N com divergência" quando o saldo é visível para você), os botões "Excluir folha", "Reverter apuração", "Apurar e ajustar". Em contagem cega, para quem conta: "Contagem cega: quem conta não vê o saldo do sistema… O saldo aparece para quem apura (sem ter contado) e para todos depois da apuração." Tabela: Produto (código — descrição, unidade), Lote, Sistema (só para quem pode ver o saldo), Contado, Recontagem, Diferença (idem; vermelha quando há), Contado em. Folha vazia: "A folha nasceu vazia: o depósito não tem saldo."
Situações
| Situação | O que se pode fazer |
|---|---|
| Aberto / contado | Contar e recontar; "Apurar e ajustar" (com tudo contado); "Excluir folha" |
| Apurado | Só consulta; "Reverter apuração" |
Botões
Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). A seguir, os demais botões desta tela — os que só aparecem em outras situações —, com o que fazem e onde ficam.
"Apurar e ajustar" (azul, martelo; mostra "Apurando…")
- Aparece quando:
materiais.inventario_apurar, a folha não apurada e você não contou nenhum item dela (se contou, aparece "Você contou itens desta folha: quem apura é outra pessoa com a chave "Apurar inventário"."). Fica desligado enquanto houver item sem contar. - Pede confirmação? Sim — "Apurar o inventário": "Apurar a folha <número> e lançar no estoque os ajustes das divergências?" com o aviso de que, apurado, o inventário não muda mais (só revertendo).
- O que faz: lança um ajuste a mais/a menos por item divergente (pelo custo médio) e marca a folha "apurado". Mensagens: "N ajuste(s) lançado(s) no estoque." ou "Contagem bateu com o sistema: nenhum ajuste foi necessário."
- Se der errado: "Há itens sem contagem. Conte todos antes de apurar." · "Apurar o inventário é de quem aprova a contagem, não de quem conta" · "Quem contou itens desta folha não a apura: outra pessoa com a chave "Apurar inventário" confere e apura." · "Inventário não encontrado ou já apurado" · "Sem acesso a este depósito: ele é de um contrato de gestão que você não acompanha".
"Excluir folha" (vermelho)
- Aparece quando: folha não apurada e
materiais.excluir_inventario. - Pede confirmação? Sim — "Excluir inventário": "Excluir a folha de contagem <número>, ainda não apurada? Sai junto: as contagens lançadas nela". Mensagem: "Inventário <número> excluído."
- Se der errado: "Inventário apurado (já ajustou o estoque) não pode ser excluído."
Janelas
"Abrir contagem"

Fecha a janela sem gravar nada; a tela de trás continua como estava.
O que faz: abre a janela "Abrir contagem".
Explicado em detalhes na Figura 1.
- Campos: "Depósito" · "Descrição" (ex.: "Contagem cíclica de setembro") · "Contagem cega (quem conta não vê o saldo do sistema)" (vem marcada).
- Botões: "Cancelar" · "Abrir".
- Efeito: cria a folha com os itens com saldo do depósito (por lote, quando há lote) e o saldo congelado; abre a folha. Mensagem: "Folha de contagem aberta com o saldo congelado."
- Erros: "Já existe um inventário aberto neste depósito. Apure ou cancele antes de abrir outro." · "O depósito está desativado: não se abre contagem nele." · "Sem acesso a este depósito: ele é de um contrato de gestão que você não acompanha" · "Sem permissão para abrir inventário".
Perguntas que as pessoas fazem
- Contei errado. → Use "Recontagem": ela substitui a contagem na apuração.
- Não consigo apurar. → Falta contar algum item, você não tem a chave de apurar, ou você contou itens desta folha (quem conta não apura).
- Sou contador e não vejo o saldo do sistema. → É a contagem cega: o saldo aparece depois da apuração.
- A folha de contagem não aparece no relatório livre. → De propósito: o saldo congelado da folha não sai pela leitura direta (contagem cega).
- Apurei errado. → "Reverter apuração" (com a chave) e apure de novo.
- Material entrou no depósito depois de abrir a folha. → A folha usa o saldo congelado na abertura; apure ou exclua e abra outra.
Ligações com outros módulos e telas
- Estoque — os ajustes aparecem no Histórico com o número do inventário; o botão "Inventário" de lá traz para esta tela.
- Contabilidade — os ajustes vão ao razão.