CRM - Relatórios do CRM

O que é

A página Relatórios CRM reúne nove relatórios prontos sobre o seu funil de vendas. Cada um responde a uma pergunta diferente:

Relatório	Responde
Funil de Conversão	Quantos passam por cada etapa e onde a maioria desiste
Performance da Equipe	Quem vende mais, e com que taxa de fechamento
Previsão & Metas	Quanto deve entrar nos próximos meses, e o quanto falta para a meta
Gargalos do Pipeline	Em que etapa as negociações emperram, e há quanto tempo
Comparar Pipelines	Como cada funil vai, lado a lado
Win/Loss	Quanto você ganha e por que perde o resto
Fontes de Leads	Quais origens trazem negócio, e não só volume
Tendência de Receita	Como a receita evolui mês a mês
Oportunidades por Viagem	Quais viagens puxam mais negociação e fecham melhor

Todos leem as mesmas oportunidades; o que muda é o corte.

O gestor comercial normalmente chega aqui depois de organizar o pipeline e ter um histórico mínimo de oportunidades fechadas (ganhas ou perdidas). É também o ponto de partida para exportar os dados em CSV e fazer análises externas em planilha.

Como usar

1. Vá em Módulos > CRM > Relatórios no sidebar (ou acesse diretamente /admin/crm/relatorios).
2. Escolha o relatório clicando em um dos cards:
   • Funil de Conversão - abre o relatório com o pipeline padrão e período de 30 dias. Mostra quantas oportunidades passaram por cada etapa, taxa de conversão geral, total ganho/perdido e a evolução mês a mês dos últimos 6 meses.
   • Performance da Equipe - lista todos os vendedores ativos que tiveram pelo menos uma oportunidade no período, ordenados pelo valor ganho. Compara total de oportunidades, ganhas, perdidas, abertas, valor no pipeline, valor ganho e taxa de conversão individual.
   • Previsão de Fechamento - agrupa todas as oportunidades em aberto com Data de previsão de fechamento preenchida, mês a mês. Calcula valor total, valor ponderado pela probabilidade da etapa e acurácia das previsões (oportunidades fechadas nos últimos 90 dias dentro de 7 dias de margem da data prevista).
3. Dentro dos relatórios de Funil de Conversão e Performance da Equipe, ajuste o filtro Período (7, 30, 90, 180 ou 365 dias) para recortar a janela analisada.
4. No Funil de Conversão, troque o Pipeline caso você tenha mais de um - o relatório só considera oportunidades vinculadas ao pipeline selecionado.
5. Para baixar os dados brutos, role até o bloco Exportar Dados na página inicial dos relatórios e clique em Exportar Oportunidades (CSV) ou Exportar Performance (CSV). O arquivo é gerado em UTF-8 com BOM e separador ;, pronto para abrir no Excel em português.

O que você precisa saber antes

• A caixa "Pergunte ao CRM" não lê os seus dados. Ela lê a sua pergunta, descobre qual dos nove relatórios responde e já abre esse relatório com os filtros aplicados. Quem calcula é o relatório, como sempre. Escrever "conversão do funil de Vendas nos últimos 30 dias" poupa o trabalho de achar o card e ajustar os filtros na mão, e nada além disso.
• Relatório novo não é dado novo. Os nove olham as mesmas oportunidades. Se o número parece errado em um deles, quase sempre a causa está no cadastro - oportunidade sem valor, sem data de previsão ou sem responsável - e não no relatório.
• Período curto engana. Vários relatórios abrem em 30 dias. Numa agência com ciclo de venda longo, essa janela mostra pouca coisa e faz parecer que a equipe parou. Amplie para 90 ou 180 dias antes de tirar conclusão.

Casos especiais

empresa sem pipeline padrão configurado

O relatório de Funil de Conversão tenta primeiro o pipeline marcado como padrão visível ao usuário logado. Se nenhum estiver marcado, ele cai no primeiro pipeline visível disponível. Em empresas ainda sem pipelines cadastrados, a página abre sem dados de etapas - o caminho é ir antes em CRM > Pipelines e criar o primeiro funil.

Vendedor sem nenhuma oportunidade no período

O relatório de Performance da Equipe só lista quem teve ao menos uma oportunidade no período. Quem não criou nem recebeu nenhuma simplesmente não aparece. Para incluí-los, amplie o período (por exemplo, mude de 30 para 90 dias).

Oportunidade aberta sem data de previsão

Na Previsão de Fechamento, só entram oportunidades com o campo Data de previsão de fechamento preenchido. Oportunidades em aberto sem essa data ficam de fora do relatório (e dos KPIs de receita prevista). Para corrigir, abra a oportunidade em CRM > Oportunidades e preencha a previsão.

Acurácia da previsão zerada

O KPI Acurácia da previsão só calcula se houver oportunidades fechadas (ganhas ou perdidas) nos últimos 90 dias com data_previsao_fechamento preenchida. Em empresas novos, é comum aparecer 0% até existir histórico suficiente.

Exportação sem dados

A rota de exportação aceita dois tipos: oportunidades (filtra created_at entre data_inicio e data_fim, padrão últimos 30 dias) e performance (mesma janela). Se a consulta volta vazia, o sistema redireciona com o aviso "Nenhum dado para exportar.".

Formato de exportação diferente de CSV

A rota exportar aceita o parâmetro formato, mas hoje apenas csv está implementado. Chamar com ?formato=xlsx retorna o erro "Formato não suportado.".

Erros comuns e como resolver

• "Nenhum dado para exportar." - Causa: o filtro de período não pegou nenhuma oportunidade ou nenhum vendedor com atividade. Solução: aumente a janela (?data_inicio=...&data_fim=...) ou confirme que existem oportunidades criadas no intervalo.
• "Formato não suportado." - Causa: o parâmetro formato veio com valor diferente de csv. Solução: remova o parâmetro ou use formato=csv.
• Funil aparece vazio mesmo com oportunidades cadastradas - Causa: o pipeline selecionado não tem etapas cadastradas ou o usuário logado não tem visibilidade sobre ele (escopo visivelPara). Solução: revise as etapas em CRM > Pipelines e confirme as permissões do papel do usuário.
• Vendedor com muitas vendas não aparece em Performance - Causa: o usuário está marcado como inativo (ativo = false). Solução: reative o usuário em Configurações > Usuários ou amplie o período se ele só fechou negócios fora da janela atual.

Onde encontrar

• URL: /admin/crm/relatorios
• Caminho no menu: Módulos > CRM > Relatórios
• Permissão necessária: crm.relatorios
• Módulo necessário: CRM

Veja também

• Oportunidades de Venda
• Pipelines do CRM
• Dashboard do CRM