# Central de Ajuda — Módulo Estoque (Calcme)
O módulo de Estoque do Calcme centraliza tudo o que entra e sai do almoxarifado da sua empresa, seja ela uma gráfica (papéis, tintas, chapas, bobinas, envelopes) ou uma marcenaria (chapas de MDF/MDP, fitas de borda, parafusos, dobradiças, vernizes, ferragens). Ele foi desenhado para responder em segundos três perguntas críticas do dia a dia: “o que eu tenho?”, “o que eu posso usar agora?” e “o que eu preciso comprar?”.
Diferente de um controle por planilha, o estoque do Calcme conversa diretamente com Vendas, PCP, PDV, Notas Fiscais e Compras: quando um pedido é fechado, o sistema já reserva o material; quando uma compra é recebida, a quantidade entra no estoque; quando uma NF-e é emitida, a baixa é automática. Isso elimina retrabalho e dá ao gestor uma visão fiel do que está disponível para produção e venda.
A documentação a seguir cobre os quatro grandes pontos do módulo: a tela principal de Estoque, o Extrato (movimentações de cada item), o módulo de Compras (pedidos a fornecedor e recebimentos) e as Configurações de Compra.
---
## 1. Visão Geral — Tela Principal de Estoque
Caminho: menu lateral → Estoque (URL: /register/estoque)
A tela principal é dividida em quatro abas, uma para cada tipo de item gerenciado pela empresa:
- Papéis — folhas, bobinas, envelopes, papel digital (uso típico em gráficas).
- Insumos — tintas (offset, plotter, digital, serigrafia), cartuchos, vernizes, colas, fitas (uso comum em gráficas e marcenarias).
- Materiais — chapas de MDF/MDP, ferragens, dobradiças, parafusos, lâminas, perfis, qualquer matéria-prima “bruta” (foco principal das marcenarias).
- Produtos Simples — itens prontos para revenda, sem composição interna (ex.: brindes, cartões pré-prontos, kits de ferragens).
Cada aba só aparece se o usuário tiver permissão para visualizar o respectivo tipo de item no estoque.
### O que cada coluna significa
- ID / Código — identificador interno e código do item (visível apenas para Materiais e Produtos).
- Tipo — subcategoria do item (ex.: TintaOffset, FolhaDigital, Bobina, Envelope, Outro).
- Nome — descrição do item, com badges para formato (ex.: 66×96) e gramatura (ex.: 90 g/m²) quando aplicável.
- Estoque — bloco com duas colunas internas por marca:
- Em Estoque (à esquerda): quantidade física que existe.
- Disponível (à direita): quantidade livre, descontando reservas de pedidos/PCP.
- Reposição — diferença entre o Estoque Máximo e o Disponível. Se aparecer ∞ é porque o item não tem máximo cadastrado.
- Un. — unidade de medida (Unidade, Kg, m², etc.).
- Ações — atalho para abrir o Extrato do item.
### O significado das cores
O Calcme usa cores para alertar visualmente o gestor:
- 🟩 Verde (ok) — quantidade acima do estoque mínimo.
- 🟨 Amarelo (mínimo) — quantidade igual ou abaixo do estoque mínimo, mas ainda positiva. Hora de programar a compra.
- 🟥 Vermelho (negativo/crítico) — zero ou negativo. Risco imediato de parar a produção.
### Filtros disponíveis
- Busca livre — por nome, código ou ID.
- Status do estoque (multiseleção) — Normal, Mínimo, Crítico.
- Disponibilidade — só pode ser usada após escolher um status; permite filtrar por Em Estoque ou Disponível.
- Grupo — filtra pelo grupo cadastrado em cada categoria (PaperGroup, InputGroup, MaterialGroup, ProductGroup).
### Ações rápidas (botão ⚡)
- Imprimir Lista — gera versão imprimível da listagem atual.
- Zerar Estoque — apaga todas as quantidades da aba atual. Aparece somente para usuários master, é uma ação destrutiva e usada normalmente em virada de inventário ou migração.
---
## 2. Extrato do Item — Movimentações de Estoque
Caminho: clicar em qualquer item da lista de Estoque (URL: /register/estoque/extrato)
O Extrato é o histórico completo de cada item. Cada movimentação aqui é chamada de “lançamento” ou “extrato”, e é a fonte da verdade do quanto a empresa tem, reservou e está esperando chegar.
### Abas por marca
No topo aparece uma aba para cada marca que já teve movimentação para aquele item, mais uma aba “Sem Marca” para lançamentos genéricos. Em uma gráfica, por exemplo, um mesmo papel “Couché 90 g/m² 66×96” pode ter saldos separados para Suzano, Ibema e International Paper. Em uma marcenaria, uma chapa “MDF 15mm Branco TX” pode ter saldos por Duratex, Eucatex e Arauco.
### Os quatro tipos de operação
| Operação | O que faz | Exemplo Gráfica | Exemplo Marcenaria |
|---|---|---|---|
| Entrada | Soma em Em Estoque e em Disponível | Recebimento de 50 fls de couché | Recebimento de 20 chapas de MDP |
| Saída | Subtrai de Em Estoque e de Disponível | Baixa por consumo na impressão | Baixa por uso no corte |
| Provisão | Subtrai apenas do Disponível (reserva) | Pedido fechado aguardando produção | OS aprovada aguardando montagem |
| Em Trânsito | Soma apenas em Disponível (esperado) | Tinta comprada que ainda não chegou | Ferragens encomendadas no fornecedor |
A fórmula que aparece no rodapé é a chave para entender tudo:
> Em Estoque − Provisionado + Trânsito = Disponível
### Origem do movimento
Cada lançamento mostra de onde veio:
- Pedido nº ### — gerado por um pedido de venda (ou incidente). Clicar no badge abre o pedido.
- Compra — gerado por um Pedido de Compra (ou recebimento de NF-e).
- Manual — lançado direto na tela do extrato (ajustes, perdas, contagens).
### Lançamento manual (botão Novo Lançamento)
Ao clicar em Novo Lançamento, abre um modal com os campos:
- Data (obrigatório) — quando a movimentação aconteceu.
- Tipo (obrigatório) — Entrada, Saída, Provisão ou Em Trânsito.
- Marca — se o item trabalha com marcas, escolha a correta.
- Custo (apenas para Entrada e Trânsito):
- Unitário — informa o valor de cada unidade.
- Embalagem — informa quantidade por embalagem, total de embalagens e o valor da embalagem; o sistema calcula o custo unitário automaticamente.
- Por Kg — disponível para papel.
- Quantidade (obrigatório).
- Cliente / Fornecedor / Pedido — para amarrar a movimentação a um terceiro.
- Descrição (obrigatório) — por padrão vem “Manual”, mas pode ser alterada para algo como “Perda por umidade” ou “Sobra de produção”.
> ⚠ Se o lançamento de Entrada ultrapassar o Estoque Máximo, o sistema bloqueia. Apenas usuários com a permissão permissão de estoque correspondente podem confirmar mesmo assim.
### Ajuste de preço de custo
No alto do extrato existe um seletor “Ajuste de preço” com três opções:
- Último preço — o sistema usa o valor da última entrada como custo do item.
- Média de preços — usa a média de todas as entradas.
- Média das últimas N compras — você escolhe o número (ex.: 3) e o sistema considera apenas as N últimas entradas.
O custo apurado aqui é usado na formação de preço de venda, em orçamentos e nos relatórios financeiros.
### Marca rápida
Pelo próprio extrato é possível cadastrar uma marca nova sem sair da tela (botão de marcas), útil quando chega uma compra de fornecedor inédito e o atendente precisa lançar a entrada na hora.
### Editar e excluir movimento
Cada linha tem dois botões:
- ✏ Editar permissão de estoque correspondente) — abre o lançamento. Se você mudar tipo ou quantidade, o sistema recalcula tudo abaixo dele.
- 🗑 Excluir permissão de estoque correspondente) — apaga o movimento e refaz a recontagem do item. Atenção: o registro é perdido; só faça em caso de erro real.
### Filtro por período
Por padrão o extrato mostra o mês atual. Use as setinhas para navegar para o mês anterior/seguinte ou o calendário para escolher um intervalo livre.
---
## 3. Compras — Pedidos de Compra e Recebimentos
Caminho: menu lateral → Financeiro → Compras (URL: /financial/compra)
O módulo de Compras é o ciclo “pedi → recebi → paguei”. Cada Pedido de Compra registra o que foi solicitado a um fornecedor, acompanha o recebimento (que entra automaticamente no estoque) e pode gerar contas a pagar.
### Os seis status possíveis
1. Nova — rascunho, ainda não enviada ao fornecedor.
2. Aberta — confirmada, aguardando entrega.
3. Em Andamento — fornecedor confirmou e está produzindo/separando.
4. Recebido Parcial — parte dos itens já chegou.
5. Recebido Total — todos os itens chegaram (status final positivo).
6. Cancelada — pedido cancelado.
> O sistema muda o status sozinho conforme você registra recebimentos. Ao bater 100% das quantidades pedidas, vai para Recebido Total.
### Cabeçalho de uma compra
- Fornecedor (obrigatório) — busca em Cadastros → Fornecedores.
- Transportadora — opcional; busca em Cadastros → Transportadoras.
- Modalidade de Frete — Remetente, Destinatário, Terceiro, Próprio (várias variações) ou Sem Frete (CST 9 da NF-e).
- Data do pedido e Previsão de entrega.
- Observação Interna (não vai para o fornecedor) e Observação Externa (sai no PDF/e-mail).
- Anexos — PDFs, imagens, planilhas; suporta preview no próprio sistema.
- Grupo — para organizar (ex.: “Compras Recorrentes”, “Insumos Marcenaria”, “Papel Especial”).
### Itens da compra
A busca é unificada entre Papel, Insumo, Material e Produto Simples — basta digitar nome ou código que o sistema sugere de qualquer aba do Estoque.
Para cada item você define:
- Marca (e pode cadastrar nova marca direto da tela).
- Custo: Unitário, Embalagem (qtd. por emb. × qtd. de emb. = total) ou Por Kg (apenas papel).
- Quantidade.
- IPI (%).
- Descrição complementar (ex.: “entrega no segundo turno”).
### Parcelas e pagamento
- Condição: Pagamento à Vista ou a Prazo.
- Número de parcelas + lista detalhada com data, valor, forma de pagamento e observação por parcela. Formas suportadas incluem Dinheiro, Boleto, Crédito, Débito, Pix, Transferência, Ted, Cheque, BNDES, Vale (Refeição/Alimentação/Combustível/Presente), Carteira Digital, entre outras.
> Se o usuário tiver permissão para sincronizar compra com o financeiro, ao salvar a compra o sistema cria/atualiza automaticamente os títulos em Contas a Pagar.
### Recebimento (entrada em estoque)
Para cada item da compra existe um histórico de recebimentos parciais: data + quantidade. A cada recebimento, o sistema:
1. Gera um lançamento de Entrada no extrato do item, com a marca correta e o custo praticado;
2. Reduz a quantidade em Trânsito equivalente;
3. Atualiza o status da compra (Em Andamento → Parcial → Total).
Permissões: permissão de compras correspondente e permissão de compras correspondente.
### Movimentação de Trânsito automática
Enquanto a compra não foi totalmente recebida, o que falta entra como Em Trânsito no estoque dos itens. Isso permite ao PCP saber que o material vai chegar e liberar pedidos de venda sem esperar a chegada física.
### Ações em massa
- Unificar compras — junta várias compras de um mesmo fornecedor que estejam em status Nova ou Aberta em uma só. Ótimo para consolidar pedidos pequenos da mesma semana.
- Excluir em massa — remove várias compras selecionadas permissão de compras correspondente).
### Comunicação com o fornecedor
- Enviar por E-mail permissão para enviar compra por e-mail) — usa o template configurado em Configurações de Compra; aceita placeholder {{nrOrdemCompra}}.
- Enviar por WhatsApp permissão para enviar compra por WhatsApp) — abre o WhatsApp Web/Desktop com o texto e link para o PDF da compra.
- PDF público — gera link /docs/compra/<hash> que o fornecedor abre sem login.
### Importação de NF-e (entrada por XML)
Permissão: permissão para importar NF-e de compra.
Três caminhos:
1. Sincronizar com integração fiscal — busca todas as NF-es emitidas contra o CNPJ da empresa nos últimos 3 meses. Útil para gráficas e marcenarias que recebem dezenas de notas no mês e querem evitar digitação.
2. Buscar por chave manual — cole a chave de 44 dígitos da NF-e e o sistema baixa o XML.
3. Upload de XML — anexe o arquivo .xml que o fornecedor enviou.
Após importar, o Calcme exibe um mapeamento item a item: para cada produto da nota você confirma se ele já está cadastrado no Estoque (e em qual marca) ou se é um cadastro novo. Só depois de mapear é que a compra é criada.
### Grupos de compras
Permissões: permissão de compras correspondente/INSERT/UPDATE/DELETE. Permite criar categorias (“Insumos diários”, “Investimento maquinário”, “Manutenção”) para filtrar a listagem e gerar relatórios mais limpos.
### Anexos / Documentos
Permissões: permissão de compras correspondente e permissão de compras correspondente. Aceita upload, download, preview de PDF, imagens e CSV diretamente na tela.
---
## 4. Configurações de Compra
Caminho: menu lateral → Configurações → Compras (URL: /config/compra)
Aqui o gestor define o padrão de comunicação com fornecedores. Todos os campos são obrigatórios:
- Texto do Topo — sai no cabeçalho do PDF do Pedido de Compra.
- Texto do Rodapé — sai no rodapé do PDF.
- Texto do WhatsApp — modelo da mensagem ao clicar em “Enviar por WhatsApp”.
- Título do E-mail — assunto do e-mail enviado ao fornecedor.
- Conteúdo do E-mail — corpo do e-mail. Aceita o placeholder *{{nrOrdemCompra}}**, que é substituído pelo número da OC no envio.
> Dica: para gráficas e marcenarias, vale incluir no texto do rodapé/e-mail os horários de recebimento, endereço com referência e nome do responsável pelo conferimento da mercadoria.
---
## 5. Permissões — Quando o cliente diz “não consigo ver/clicar em X”
Toda a tela do Estoque é controlada por permissões que ficam em Cadastros → Usuários → Perfil. Os principais nomes para você reconhecer no atendimento:
Estoque (visão e movimentação):
- permissão de estoque correspondente — ver a tela principal do Estoque.
- permissão para visualizar papéis no estoque / permissão para visualizar insumos no estoque / permissão para visualizar materiais no estoque / permissão para visualizar produtos no estoque — controla cada aba.
- permissão de estoque correspondente — abrir o extrato do item.
- permissão de estoque correspondente / UPDATE / REMOVE — criar, editar, excluir movimentações.
- permissão de estoque correspondente — permite lançar entrada acima do estoque máximo.
Compras:
- permissão de compras correspondente / INSERT / UPDATE / DELETE — CRUD básico.
- permissão de compras correspondente / permissão de compras correspondente — ver e registrar recebimentos.
- permissão de compras correspondente / INSERT / UPDATE / DELETE — gerenciar grupos.
- permissão de compras correspondente / permissão de compras correspondente — gerenciar anexos.
- permissão para enviar compra por e-mail / permissão para enviar compra por WhatsApp — enviar pelo canal correspondente.
- permissão para importar NF-e de compra — importar NF-e (integração fiscal/XML/chave).
- permissão para sincronizar compra com o financeiro — sincronizar a compra com Contas a Pagar.
> O botão “Zerar Estoque” é restrito ao perfil master da empresa — não há permissão granular para ele.
---
## 6. Dúvidas Frequentes (FAQ)
🟦 Por que o “Disponível” do meu item ficou negativo?
Porque há mais provisão (pedidos fechados aguardando produção) do que material físico. Significa que você prometeu mais do que tem. Solução: receber a compra que está em trânsito, lançar uma entrada manual ou rever o pedido que reservou material a mais.
🟦 Qual a diferença entre Provisão e Trânsito?
Provisão é material que está reservado para um pedido de venda (sai do disponível mesmo estando fisicamente no estoque). Trânsito é material que foi comprado e ainda não chegou (entra no disponível sem estar fisicamente no estoque). Provisão diminui disponível, Trânsito aumenta.
🟦 Como o sistema calcula o preço de custo após uma nova compra?
Depende do que está selecionado no campo “Ajuste de preço” dentro do Extrato do item. Se for Último preço, vale o custo da última entrada. Se for Média de preços, vale a média de todas as entradas. Se for Média das últimas N compras, você define o N e o sistema considera só as últimas N entradas.
🟦 Excluí um movimento sem querer. Perdi o histórico?
Sim. A exclusão é definitiva e o sistema faz uma recontagem do item a partir dos lançamentos restantes. Por isso o sistema avisa antes com um popup. Se foi um erro, refaça o lançamento manualmente com a mesma data, marca, quantidade, custo e descrição.
🟦 A compra mudou de status sozinha. Por quê?
Porque o sistema acompanha os recebimentos: ao registrar uma entrada parcial, a compra vai para Recebido Parcial; ao bater 100%, vai para Recebido Total. Da mesma forma, criar/atualizar a compra sincroniza o título em Contas a Pagar (se o usuário tiver permissão para sincronizar compra com o financeiro).
🟦 Não consigo ver o botão “Zerar Estoque”.
Esse botão aparece apenas para o perfil master da empresa. Solicite a um administrador para executar a operação ou para conceder o acesso master temporariamente.
🟦 Importei uma NF-e e veio item duplicado / sem cadastro. O que faço?
Na tela de mapeamento da importação, vincule o item da nota ao item já cadastrado (não cadastre um novo). Se realmente for um item novo, marque para criar e revise depois em Cadastros → Estoque a unidade, grupo e estoque mínimo. Marcas novas detectadas na nota podem ser cadastradas pelo botão de marca rápida durante o mapeamento.
🟦 O fornecedor não recebeu o e-mail do Pedido de Compra.
Verifique três coisas: (1) o e-mail do fornecedor está correto em Cadastros → Fornecedores; (2) o template em Configurações → Compras está preenchido (todos os campos são obrigatórios); (3) se a empresa configurou SMTP próprio, conferir as credenciais em Configurações Gerais. Quando não há SMTP, o envio sai pelo servidor padrão do Calcme.
🟦 Recebi a mercadoria mas o estoque não atualizou.
O recebimento precisa ser registrado dentro do Pedido de Compra (botão de receber, item por item). A simples alteração do status para Recebido Total sem registrar quantidades por linha não gera entrada no estoque. Confirme também se você tem a permissão permissão de compras correspondente.
🟦 Quero unificar duas compras do mesmo fornecedor e o sistema não deixa.
A unificação só funciona para compras nos status Nova ou Aberta. Compras em Em Andamento, Recebido Parcial ou Recebido Total já têm vínculo com estoque e não podem ser unificadas — nesse caso, cancele e refaça, ou trate-as separadamente.
🟦 Para que serve o cadastro de Marca por item?
Permite controlar estoque separado por marca (e até estoque máximo por marca, se a opção “Estoque máximo por marca” estiver ativa no item). Numa gráfica, isso permite ver que a Suzano está acabando enquanto a Ibema sobra. Numa marcenaria, ver que o MDF Eucatex está em falta enquanto o Duratex está cheio.