# Central de Ajuda — Relatórios
## O que é
O módulo de Relatórios é a área do Calcme onde o dono da gráfica ou da marcenaria consegue extrair, visualizar e exportar todos os indicadores e históricos gerados pelos demais módulos (Vendas, Financeiro, Estoque, Comissões e Cadastros). Ele reúne relatórios operacionais (o que foi vendido, comprado, pago, recebido, produzido) e relatórios gerenciais (DRE, lucratividade, metas, KPIs, dashboard executivo).
Os relatórios podem ser visualizados na tela, exportados em PDF (modelo formatado), XLSX (planilha Excel para análise livre) e em alguns casos CSV. Relatórios mais pesados — como o Inventário Anual — são gerados em segundo plano (modo assíncrono), para não travar o sistema enquanto você continua operando.
## Para que serve
- Tomar decisão com base em dados reais (e não no “achismo”).
- Entender lucro e margem: DRE, lucratividade por produto, ticket médio, EBITDA, margem de contribuição.
- Controlar caixa e bancos: fluxo mensal, extrato por conta, contas a pagar e receber em aberto, inadimplência.
- Medir a equipe: metas de venda, comissões, ranking de vendedores e agências.
- Controlar estoque: giro, inventário anual, movimentações por período.
- Acompanhar clientes e canais: origem dos pedidos, perdas de venda (loss reason), ranking de clientes.
- Cumprir obrigações: fechamento mensal, conciliação, declarações fiscais com base no DRE.
## Fluxo completo
1. Os módulos Vendas, Compras, Financeiro e Estoque registram as movimentações no dia a dia.
2. O Calcme consolida automaticamente esses dados no banco (pedidos, notas, títulos, transações, movimentações de estoque).
3. Ao entrar no menu Relatórios, o usuário escolhe o tipo de relatório, o período (datas) e os filtros (vendedor, cliente, conta bancária, categoria, produto, grupo, centro de custo etc.).
4. O sistema processa a consulta em tempo real ou (no caso do inventário anual) dispara uma geração em segundo plano.
5. O relatório é exibido na tela e pode ser baixado em PDF, XLSX ou CSV.
6. Relatórios mais pesados aparecem com status de geração e podem ser gerados novamente se houver falha.
## Como usar
1. Acesse o menu Relatórios (ou pelo atalho do módulo específico: Vendas → Relatórios; Financeiro → Relatórios; Estoque → Relatórios).
2. Escolha a categoria: Financeiros, Vendas, Comissões, Estoque ou Dashboard.
3. Selecione o relatório desejado.
4. Preencha os filtros: período (data inicial e final), além de filtros específicos (conta bancária, categoria, vendedor, produto etc.).
5. Clique em Gerar (ou Filtrar).
6. Visualize na tela e escolha exportar em PDF ou XLSX.
7. Para relatórios de inventário anual, clique em Solicitar Geração; quando concluir, use Baixar.
---
## Submódulos
### 1. Dashboard 📊
A tela inicial executiva. Mostra os principais indicadores do negócio em cartões e gráficos.
- Ticket Médio — valor médio por pedido em um período.
- EBITDA — lucro operacional antes de juros, impostos, depreciação e amortização.
- CAC (Custo de Aquisição de Cliente) — quanto foi gasto em marketing/vendas para trazer cada cliente novo.
- LTV (Lifetime Value) — quanto cada cliente rendeu desde o início do relacionamento.
- MRR/ARR — receita recorrente mensal e anual (relevante para quem vende contratos, assinaturas, manutenção).
- MC (Margem de Contribuição) — diferença entre receita e custos variáveis.
- Clientes Ativos e Inativos — quantos estão comprando e quantos pararam.
- Contas a Pagar e Receber em aberto — visão rápida do financeiro.
Permissões: permissão para visualizar indicadores do dashboard, permissão para visualizar indicadores financeiros, permissão para visualizar indicadores de aquisição, permissão para visualizar indicadores de clientes, permissão para visualizar indicadores de recorrência, permissão para visualizar margem de contribuição, permissão para visualizar contas no dashboard, permissão para visualizar clientes ativos, permissão para visualizar clientes inativos. Cada cartão tem permissão própria, então é possível liberar só o que o colaborador precisa.
Exemplo gráfica: a dona usa o Dashboard para ver se o ticket médio caiu após trocar a tabela de preços do offset, e corrige imediatamente.
Exemplo marcenaria: o gestor vê que o CAC subiu e o LTV caiu — sinal de que a última campanha trouxe clientes pontuais, sem recorrência.
---
### 2. Relatórios Financeiros 💰
Conjunto de relatórios que cruzam Transações, Contas Bancárias, Categorias, DRE e Centros de Custo.
Principais relatórios disponíveis:
- Fluxo de Caixa Diário / Mensal — entradas, saídas e saldo por dia ou por mês.
- Contas a Pagar e a Receber (Bills) — títulos em aberto, vencidos, pagos, agrupados por período, cliente, fornecedor, categoria ou centro de custo.
- Extrato por Conta Bancária — todas as movimentações de uma conta (ou de todas).
- DRE (Demonstração de Resultado do Exercício) — relatório contábil com receita bruta, deduções, custos, despesas e lucro líquido, podendo ser anual, mensal, bimestral ou trimestral, e em regime de caixa (quando o dinheiro entrou/saiu) ou competência (quando o fato aconteceu).
- Relatório por Categoria Financeira — quanto entrou e saiu em cada categoria (ex.: “Papel Couchê”, “Energia”, “Folha de Pagamento”).
- Relatório por Grupo — agregações pré-definidas de contas/categorias.
- Relatório por Centro de Custo — gasto por departamento, máquina ou projeto (ex.: impressora HP Indigo, setor de acabamento, montagem de móveis sob medida).
- Transações por Centro de Custo — detalhamento das movimentações dentro de um centro.
Permissões: permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso.
Formato: visualização em tela + exportação PDF e XLSX.
Exemplo gráfica: o contador pede o DRE trimestral em regime de competência para fechar o trimestre; a gráfica gera em PDF e envia direto.
Exemplo marcenaria: o dono vê pelo relatório por centro de custo que o setor de usinagem CNC está consumindo 38% do caixa mensal e decide revisar a manutenção.
---
### 3. Relatórios de Vendas 🛒
Foco no desempenho comercial.
- Metas (Goals) — acompanhamento de metas por vendedor ou agência, com percentual atingido.
- Ranking Cliente / Agência — quem mais comprou no período, em volume financeiro e em quantidade.
- Vendas por Produto (Product Sales) — quais produtos venderam mais, em quantidade e faturamento.
- Lucratividade por Produto (Profitability Product) — margem real por produto (preço − custo − impostos − comissões).
- Listagem de Pedidos (List Orders) — pedidos em qualquer status, filtrados por período, vendedor, cliente, forma de pagamento, canal etc.
- Relatório de Motivo de Perda (Loss Reason) — orçamentos/pedidos recusados, agrupados pelo motivo (ex.: preço, prazo, concorrência).
- Origem dos Pedidos (Origin) — de onde veio o cliente: Instagram, indicação, Google, PDV, site etc.
Permissões: permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso.
Formatos: PDF, XLSX.
Exemplo gráfica: o dono descobre pelo relatório de lucratividade que “impressão digital A4 colorida” tem margem negativa por causa do custo do toner — e ajusta o preço.
Exemplo marcenaria: o gestor cruza ranking de cliente × origem e vê que 60% dos pedidos grandes vêm de arquitetos indicados — decide criar programa de parceria.
---
### 4. Relatórios de Comissões 👥
Gera a visão detalhada das comissões já calculadas pelo Financeiro.
- Comissão Geral — total de comissões do período, por vendedor e por agência.
- Comissão Detalhada por Pessoa — listagem pedido a pedido de um vendedor/agência específico, com base de cálculo e valor devido.
- Exportações — PDF, XLSX e CSV.
Permissão: permissão de acesso ao recurso.
Exemplo gráfica: antes de pagar comissão no dia 5, a financeira gera o relatório detalhado por vendedor para conferir pedido a pedido.
Exemplo marcenaria: o vendedor pede o espelho do mês; o gestor exporta o PDF da comissão individual e envia.
---
### 5. Relatórios de Estoque 📦
- Inventário Anual (Annual Stock Report) — fotografia completa do estoque em uma data de corte (posição, custo, valorização). Muito usado para fechamento de ano, balanço e apuração de IRPJ/Lucro Real.
- Movimentações por Período — entradas, saídas, ajustes, perdas.
- Acompanhamento de geração — em relatórios mais pesados, o sistema mostra o status (Pendente, Gerando, Concluído ou Falhou) para você saber quando o arquivo está pronto.
- Geração em segundo plano — quando concluído, o relatório fica disponível para download.
Permissões: permissão para visualizar este recurso, permissão de acesso ao recurso, permissão de acesso ao recurso, permissão de acesso ao recurso.
Exemplo gráfica: em 31/12 a gráfica solicita o Inventário Anual; no dia seguinte a contabilidade baixa o XLSX para declarar.
Exemplo marcenaria: a marcenaria gera o inventário anual de MDF, ferragens e insumos para comparar com a contagem física feita pela equipe.
---
## Integração com outros módulos
- Vendas → Relatórios: pedidos, NF, orçamentos, metas, origem, motivo de perda.
- Financeiro → Relatórios: contas a pagar e receber, extrato bancário, Categorias, DRE, Centros de Custo.
- Estoque → Relatórios: movimentações, inventário, posição por marca, custo médio.
- Cadastros → Relatórios: clientes, fornecedores, vendedores, produtos alimentam todos os agrupamentos.
- Compras → Relatórios: aparecem como saídas (contas a pagar, custo do produto vendido).
- Comissões → Relatórios: a partir do cálculo feito no Financeiro, o Relatório de Comissões apenas lê e formata.
- NF-e / NFS-e / NFC-e → Relatórios: valores de notas emitidas integram o DRE e o fluxo de caixa.
- PDV → Relatórios: vendas de balcão entram nos relatórios de vendas e caixa.
---
## Cancelamentos e estornos
- Relatórios não são objetos que se cancelam: são fotografias do estado atual dos dados.
- Quando um pedido, nota, título ou movimentação de estoque é cancelado ou estornado no módulo de origem, o relatório passa a refletir automaticamente a nova situação na próxima geração.
- Documentos excluídos ou cancelados deixam de aparecer nos relatórios padrão, conforme a regra do módulo de origem.
- Para rodar um relatório novamente, basta gerar outra vez com os mesmos filtros. Relatórios em segundo plano podem ser gerados novamente se houver falha.
---
## Erros e validações comuns
- “Período obrigatório” — você precisa informar data inicial e final.
- “Sem permissão para este relatório” — o perfil do usuário não tem a permissão específica (ex.: permissão de acesso ao recurso).
- “Nenhum registro encontrado” — os filtros estão muito restritos ou não há dados no período.
- “Falha ao gerar PDF” — geralmente filtro muito amplo (milhares de linhas) ou problema temporário; tente reduzir o período ou exportar em XLSX.
- Valores divergentes do esperado — quase sempre é regime do DRE (caixa vs. competência) ou filtro de centro de custo/categoria diferente do que o usuário pensou.
- Tracker de inventário com status “Falhou” — use Reprocessar; se persistir, acione o suporte.
---
## Perguntas frequentes
1. Qual a diferença entre regime de Caixa e regime de Competência no DRE?
- Caixa: conta receita/despesa no dia em que o dinheiro realmente entrou ou saiu da conta (pagamento efetivo).
- Competência: conta receita/despesa no dia do fato gerador (emissão da nota/venda), mesmo que o pagamento só ocorra depois. Quem segue IFRS/BPC usa Competência.
2. O relatório mostra valores diferentes do que eu vejo na tela do Financeiro. O que fazer?
Cheque: (a) período do filtro, (b) se há títulos excluídos ou cancelados, (c) se o relatório é por regime de caixa ou competência, (d) se está filtrado por centro de custo/categoria. Normalmente a diferença está em um desses pontos.
3. Posso exportar para Excel?
Sim. A grande maioria dos relatórios tem botão XLSX. Relatórios de comissão também exportam em CSV.
4. Como gero o Inventário Anual?
Vá em Relatórios de Estoque → Inventário Anual → Solicitar Geração. O sistema cria um tracker que processa em segundo plano. Você pode continuar usando o Calcme normalmente. Quando finalizar, aparecerá com status Concluído e o botão Baixar.
5. Por que o DRE não bate com o fluxo de caixa?
Porque o DRE por padrão é por competência (o que gerou receita/despesa), enquanto o fluxo de caixa é por caixa (quando o dinheiro circulou). Os dois costumam divergir no mês — e isso é normal.
6. Por que o gráfico do Dashboard está zerado?
Causas comuns: (a) o usuário não tem permissão para aquele KPI (ex.: permissão para visualizar indicadores financeiros), (b) não há dados no período, (c) categorias do DRE ainda não foram mapeadas (por exemplo, a conta “Impostos sobre Vendas” não foi classificada).
7. O relatório em PDF abre travado ou com milhares de páginas. Como resolver?
Reduza o filtro (período menor, um cliente/produto específico) ou use XLSX para análises extensas — o Excel aguenta melhor grandes volumes.
---
## Problemas comuns
- Comissão aparece zerada mesmo com vendas: a regra de comissão (percentual ou tabela) não está cadastrada no vendedor/agência. Ajuste em Financeiro → Comissões → Configurações.
- DRE sem receita: provável que as Categorias DRE não estejam vinculadas às Categorias Financeiras. Mapeie em Financeiro → Categorias DRE.
- Produto não aparece no ranking: o pedido pode estar com status Rascunho (ainda não confirmado), e por isso não entra nos relatórios oficiais.
- Inventário anual gera valor diferente da contagem física: diferença entre estoque contábil (Calcme) e físico (contado no chão de fábrica). Antes de confiar no relatório, faça o ajuste de inventário no módulo Estoque.
- Motivo de Perda vazio: os orçamentos foram perdidos, mas ninguém preencheu o motivo na recusa. Oriente a equipe a sempre selecionar o motivo.
---
## Quando algo parece errado
1. Confira o período — 90% dos “está errado” é filtro de data.
2. Confira o regime (caixa × competência), se for DRE ou fluxo.
3. Confira permissões — o usuário pode estar vendo só parte do relatório.
4. Cruze com a origem — se o DRE diverge, abra o Contas a Receber do mesmo período; se o estoque diverge, abra as movimentações do item.
5. Verifique cancelamentos e exclusões — um pedido cancelado no dia seguinte muda o relatório daquele dia.
6. Tente outra exportação — se o PDF falha, o XLSX quase sempre gera.
7. Se for inventário anual e o status ficou em Falhou, use Reprocessar.
8. Persistindo, acione o suporte com: nome do relatório, período, filtros usados, e um print do resultado.
---
## Orientações para o cliente
- Crie o hábito de olhar o Dashboard uma vez por dia — 5 minutos de manhã já orientam o dia inteiro.
- Use relatórios de Lucratividade por Produto antes de fazer promoção — evita vender no prejuízo.
- Padronize o preenchimento de categorias, centros de custo e origem — relatórios só são bons se os dados de origem forem bons. Garbage in, garbage out.
- Para o contador, padronize: envie DRE mensal em competência (PDF) + Fluxo de Caixa mensal (XLSX) + Extrato por conta bancária.
- Inventário Anual: gere no dia 31/12 à noite ou 01/01 de manhã cedo, antes de qualquer movimentação do novo ano.
- Metas: só funcionam se estiverem cadastradas por vendedor — sem meta, o relatório não tem o que comparar.
- Exporte e guarde cópias dos relatórios de fechamento mensal (PDF) em uma pasta específica. Servem de histórico caso você mude de contador ou queira comparar anos.
---
## Resumo
O módulo de Relatórios transforma os dados de Vendas, Financeiro, Estoque, Compras e Comissões em PDFs, planilhas e indicadores para decisão, controle e obrigações fiscais.
Principais blocos: Dashboard, relatórios financeiros, relatórios de vendas, comissões, estoque e histórico de alterações/auditoria.
O histórico de alterações ajuda a identificar quem criou, editou ou excluiu informações importantes. Ele é somente leitura e deve ser usado para rastreabilidade.
Regras de ouro:
- Relatório é fotografia: se a origem está errada, o relatório estará errado.
- DRE: escolha consciente entre Caixa e Competência.
- Exporte PDF para enviar a terceiros; XLSX para análise; CSV para integração.
- Inventário Anual é assíncrono — solicite, aguarde, baixe.
- Cada KPI e cada relatório tem permissão própria — libere com critério.
Dados bem lançados + relatórios bem filtrados = decisões melhores para a gráfica ou marcenaria.