Manual de uso

1. Visão geral

Este sistema compara o estoque que o ERP diz que existe com o que você contou de verdade na prateleira, e mostra a diferença junto com a situação da validade de cada produto.

O caminho é sempre o mesmo, em quatro passos:

  1. Base de produtos: suba o relatório de estoque do ERP.
  2. Inventários: crie um inventário (ou abra um que já existe) e lance o que você contou: código, quantidade, datas e lote.
  3. Finalizar o inventário quando terminar.
  4. Divergências: veja o que sobrou, o que faltou e o que está perto de vencer.
Tudo é salvo na hora.Cada lançamento fica gravado assim que você toca em Lançar. Pode fechar o navegador, trocar de aparelho ou continuar amanhã: o inventário está em Inventários, do jeito que você deixou.

O menu à esquerda tem as telas: Base de produtos, Estoque, Inventários (onde você cria, conta e finaliza), Divergências e este Manual de uso. Contar e fazer inventário são a mesma coisa: cada inventário é uma contagem, e você a faz dentro dele.

2. Usar no celular

O sistema funciona no celular com as mesmas funções do computador. Abra o endereço no navegador (Chrome, Safari) e use sempre o endereço com https://.

  • O menu fica no botão de três riscos, no canto de cima à esquerda. Toque nele para abrir e toque fora (ou numa opção) para fechar.
  • As tabelas largas rolam para o lado: arraste com o dedo.
  • Nos campos de data o próprio celular abre o calendário.
  • Na tela de contar do inventário, os campos se organizam em duas colunas e o botão Lançar ocupa a largura toda.
Atalho na tela inicial.No Chrome: menu (três pontos) → Adicionar à tela inicial. No iPhone, no Safari: botão de compartilhar → Adicionar à Tela de Início. Assim o sistema abre como se fosse um aplicativo.

3. Base de produtos

É de onde o sistema tira o nome e o estoque de cada produto. Faça isto antes da primeira contagem e sempre que quiser atualizar o estoque do ERP.

Como importar

  1. No ERP, gere o relatório de Saldo de estoque (o arquivo se chama stq_rel_saldo_grid) e salve (.xls ou .xlsx). Não é o relatório de cadastro de produtos.
  2. Abra Base de produtos.
  3. Toque na caixa pontilhada (ou arraste o arquivo para ela) e escolha o relatório.
  4. Toque em Importar e espere a mensagem verde “Pronto”. Ela diz quantos produtos são novos e quantos foram atualizados.

O que o sistema lê do relatório

As colunas Código, Cód.Pers., Desc. Produto/Serviço e Saldo Qtd/Peso (a quantidade). O Código do ERP identifica o produto, porque nunca se repete. O Cód.Pers. pode estar vazio ou ser igual em produtos diferentes, e por isso serve só como outro jeito de achar o produto na contagem.

Pode importar quantas vezes quiser.Reimportar nunca duplica: atualiza o que já existe e acrescenta o que é novo. Os inventários já feitos não mudam.
Linhas sem Código são ignoradas.Se o relatório tiver uma linha em branco ou de total, o sistema pula e avisa na mensagem de “Pronto”. Se aparecer “não reconheci as colunas”, o arquivo não é o relatório de saldo de estoque.

4. Estoque

É a consulta do estoque do relatório: Código, Descrição, Quantidade e Shelf %.

  • Buscar: digite parte do código, do Cód.Pers. (a busca acha, mesmo ele não aparecendo na tabela) ou do nome e toque em Filtrar. Não precisa se preocupar com acento nem com maiúsculas.
  • Ordenar: toque no título de uma coluna. Em Quantidade o primeiro toque ordena do maior para o menor; tocando de novo, do menor para o maior. A seta mostra a ordem atual.
  • Shelf %: mostra quanto da validade ainda resta em cada produto, com as mesmas cores das Divergências. O relatório do ERP não traz validade, então o shelf vem das suas contagens: é sempre o do último inventário (o mais recente, mesmo que ainda esteja em andamento), usando o pior lote do produto. Produto que não foi contado aparece com um traço, e a linha do alto do cartão diz de qual inventário o shelf veio. Exceção, só no começo: enquanto você ainda não fez nenhum inventário, o Estoque mostra o shelf inicial, que veio já calculado da planilha de controle de 26/10/2026. Assim que existir o primeiro inventário, esse shelf inicial deixa de aparecer e vale só o que foi lançado nos inventários. Toque em Shelf % para ver primeiro os que vencem antes.
  • Exportar: no menu de três riscos do cartão, escolha Exportar CSV ou Exportar Excel. O arquivo sai com os mesmos produtos e na mesma ordem que você está vendo na tela, com Código, Descrição, Quantidade e Shelf %.
Exemplo útil.Para ver os produtos com mais estoque: toque em Quantidade uma vez. Para ver só os de queijo: digite queijo, filtre e depois ordene.

5. Inventários e contagem

Um inventário é uma contagem completa, do começo ao fim (por exemplo, “Câmara fria” ou “Loja Centro”). Tudo acontece na tela Inventários: ela lista os que você já tem, e é por ela que você cria um novo, continua um em andamento, importa uma planilha ou abre as divergências. Você pode ter vários salvos ao mesmo tempo.

Criar

Em Inventários, escreva um nome (é opcional) e toque em Criar e contar. O sistema abre a tela de contar desse inventário. Para voltar à lista, toque em Voltar aos inventários.

Importar uma planilha de contagem

Se você já tem uma contagem em planilha, não precisa digitar tudo de novo. Em Inventários, no cartão Importar planilha de contagem, escolha o arquivo (.xls ou .xlsx). A primeira linha precisa ter as colunas Código, Contagem (ou Quantidade), Fabricação e Validade. Lote é opcional. O código é o Código do ERP.

  • Vira um inventário novo, em andamento. O nome é o que você escrever no campo de nome, ou o nome do arquivo.
  • Valem as mesmas regras de qualquer lançamento: as duas datas são obrigatórias e a validade não pode ser antes da fabricação.
  • Linha que não passa não é importada e nada é inventado. A tela mostra a lista com o motivo de cada uma (por exemplo, “Faltam as datas de fabricação e de validade”) e um botão Baixar pendências (CSV). Complete na planilha e importe de novo, ou lance direto dentro do inventário.
Importar duas vezes cria dois inventários.Cada importação gera um inventário novo. Se importou por engano, exclua o repetido na tela Inventários.

Situação

  • Em andamento: aceita lançamentos. O botão é Continuar.
  • Finalizado: a contagem terminou e as divergências estão disponíveis. Os botões são Divergências e Reabrir.

Reabrir

Esqueceu um item? Em um inventário finalizado, toque em Reabrir, faça os lançamentos que faltam e finalize de novo.

Excluir

Toque em Excluir no inventário e confirme em Excluir de vez. O inventário e todos os lançamentos dele saem da lista.

Excluir não tem volta.Não existe botão para desfazer. Se tiver dúvida, deixe o inventário salvo: ele não atrapalha nada.

Contar dentro do inventário

Ao tocar em Continuar (ou depois de criar um inventário), você chega à tela de contar. No alto aparece o nome do inventário que você está contando. É ali que você lança o que contou.

Passo a passo de cada lançamento

  1. Código: digite o Cód.Pers. ou o Código do produto. A descrição aparece sozinha, sem precisar sair do campo.
  2. Quantidade: digite o número contado. Pode usar vírgula (2,5) ou ponto.
  3. Fabricação e Validade: as duas são obrigatórias. A validade não pode ser antes da fabricação.
  4. Lote: opcional, mas ajuda a conferir depois.
  5. Toque em Lançar. Aparece uma mensagem verde com o total daquele código.
Mais rápido.Depois de lançar, o código continua preenchido e o cursor volta para a quantidade. Se vai lançar outro lote do mesmo produto, é só mudar quantidade, datas e lote.

Quando o código serve a mais de um produto

No ERP, alguns produtos diferentes têm o mesmo Cód.Pers. Quando isso acontecer, abre uma lista com os produtos possíveis, mostrando nome, Código e Cód.Pers. Toque no produto certo para escolher. O sistema não deixa lançar sem essa escolha, para não contar no produto errado.

Lançar o mesmo código várias vezes

Pode acontecer de contar o mesmo produto em vários lugares ou em vários lotes. Lance cada contagem separadamente: o sistema soma tudo e conta o código uma vez só. O quadro Total por código mostra isso, e embaixo, em Lançamentos, aparece cada lançamento individual.

LançamentoProdutoQtdLote
1Queijo Mussarela 3 kg3A1
2Queijo Mussarela 3 kg5A1
3Queijo Mussarela 3 kg2B7

No quadro Total por código esse produto aparece em uma linha só, com Total contado = 10 e Lançamentos = 3. É esse total de 10 que vai para a comparação com o estoque.

Corrigir um lançamento errado

Em Lançamentos, toque na lixeira da linha. Ela muda para Confirmar?: toque de novo para remover (se não tocar, volta ao normal em alguns segundos). O total do código se ajusta sozinho.

Finalizar

Quando terminar, toque em Finalizar inventário, no alto da tela, e confirme. O sistema leva você para as Divergências desse inventário. Só dá para finalizar com pelo menos um lançamento. Se esquecer algo, Reabrir na tela Inventários.

6. Divergências

Mostra, para cada produto contado, a comparação entre o ERP e a sua contagem. Por padrão aparece o último inventário finalizado. Para ver outro, vá em Inventários e toque em Divergências no que quiser.

Como ler as colunas

  • Estoque sistema: a quantidade que o ERP tem.
  • Contagem: o total que você contou (todos os lançamentos do código somados).
  • Divergência: Contagem menos Estoque sistema. Positivo (+) = contou a mais do que o ERP diz. Negativo (−) = contou a menos, ou seja, faltou.
  • Shelf %: quanto da validade do produto ainda resta. Vai de 100% (recém-fabricado) até 0% (vencido).
  • Situação: a cor do shelf.

As cores

SituaçãoShelfO que significa
No prazo68% a 100%Ainda tem bastante validade.
Crítico1% a 67%Atenção: a validade está acabando.
Vencido0%A validade é hoje ou já passou.
Produto com vários lotes.A linha usa o pior lote, ou seja, o que vence primeiro. Se um lote está no prazo e outro está vencido, o produto aparece como vencido.

Filtrar, ordenar e exportar

  • Filtrar: por código, Cód.Pers. ou nome, e pelos botões Todas / No prazo / Crítico / Vencido.
  • Ordenar: toque no título da coluna.
  • Exportar: menu de três riscos → CSV ou Excel. Sai somente o que está filtrado na tela.
Só entram produtos que você contou.Um produto que existe no ERP mas não foi lançado na contagem não aparece nas divergências. Se quiser conferir o que ficou de fora, compare com a tela Estoque.

7. Dúvidas e problemas

Digitei o código e apareceu “Código não encontrado na base”

Confira o número e tente o outro código do produto (o Código ou o Cód.Pers.). Veja na tela Estoque se o produto existe. Se não existir, ele não estava no relatório: importe o relatório atualizado em Base de produtos.

Ao importar na Base de produtos aparece “Este arquivo não é o relatório de Saldo de estoque”

Você escolheu um relatório do ERP que não é o certo. A Base de produtos só aceita o relatório de Saldo de estoque, cujo nome de arquivo começa com stq_rel_saldo_grid e que tem as colunas Código, Desc. Produto/Serviço, Cód.Pers. e Saldo Qtd/Peso. Relatórios de outros menus, como o de cadastro de produtos (fat_produto_grid, com Grupo, NCM e Tributação), não servem. A mensagem lista as colunas que o sistema encontrou no arquivo, para você conferir.

Abriu uma lista pedindo para escolher o produto

É normal: o código que você digitou serve a mais de um produto no ERP. Escolha pelo nome. O Código (que aparece embaixo do nome) é o que identifica o produto de verdade.

Aparece “A página expirou” ao lançar ou importar

Isso acontece quando a página ficou aberta por muito tempo, ou quando o endereço foi aberto com http:// em vez de https://. Recarregue a página (e confira que o endereço começa com https) e tente de novo. Se continuar, avise quem cuida do sistema.

Aparece “Muitas requisições. Espere um minuto”

O sistema limita o número de envios por minuto para se proteger. Espere um minuto e tente de novo.

O inventário não aceita novos lançamentos

Ele está finalizado. Na tela Inventários (ou na faixa que aparece dentro do próprio inventário), toque em Reabrir.

Lancei um valor errado

Dentro do inventário, em Lançamentos, toque na lixeira da linha errada, confirme e lance o valor certo. O total do código se acerta sozinho.

Perdi o que contei?

Não. Cada lançamento é salvo na hora. Vá em Inventários e toque em Continuar no inventário em andamento. Só se você tiver excluído o inventário é que ele some, e isso não tem volta.

O estoque de um produto parece desatualizado

O estoque mostrado é o do último relatório importado. Gere um relatório novo no ERP e importe em Base de produtos. As contagens já feitas continuam como estão; as divergências passam a usar o estoque novo.

A tela do celular ficou apertada ou cortada

Gire o aparelho para o modo deitado ou arraste a tabela para o lado. Em telas pequenas o menu fica no botão de três riscos, no canto de cima.

Digitei a data e o celular não aceita

Toque no campo e escolha a data no calendário que abre. O campo só aceita datas válidas.

Deu erro e não sei o que fazer

Recarregue a página. Se o erro continuar, anote o que você estava fazendo, a mensagem que apareceu e o horário, e passe para quem cuida do sistema.

8. Glossário

  • Código: o número do produto no ERP. Único: nunca se repete.
  • Cód.Pers.: código personalizado do ERP. Pode estar vazio ou repetido entre produtos.
  • Estoque sistema: a quantidade que o ERP diz que existe (coluna Saldo Qtd/Peso).
  • Contagem: a quantidade que você contou de verdade.
  • Divergência: a diferença entre a contagem e o estoque do sistema.
  • Lote: identificação de uma remessa do produto. O mesmo produto pode ter vários lotes, com datas diferentes.
  • Fabricação e validade: as datas do lote. Com elas o sistema calcula o shelf.
  • Shelf %: a parte da vida do produto que ainda resta (da fabricação até a validade).
  • Inventário: uma contagem completa e salva, com nome e data.
  • Lançamento: cada vez que você toca em Lançar. Vários lançamentos do mesmo código são somados.