> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/relatorios/relatorios-de-vendas.md). # Relatórios de vendas Leitura comercial do **Kanban**: dashboard de vendas com meta, ganho, conversão, ranking de vendedores e origem dos negócios, mais um relatório de funil com a conversão etapa a etapa. **Caminho:** menu lateral → Relatórios → **Dashboard de Vendas** e **Funil de Vendas** Os números respeitam os **funis que o usuário pode ver** (mesma regra de acesso do Kanban) e o **fuso horário do tenant** — "o mês" é o mês na parede do tenant, não em UTC. > **A fonte dos dados são os próprios cards do Kanban.** Valor, status (Ganho/Perdido) e responsável do card é o que os dois relatórios leem. Se o time não marcar o card como **Ganho** ou **Perdido** e não preencher o **valor**, o dashboard não tem como refletir a realidade — ele mostra exatamente o que está no quadro, nem mais nem menos. \[\[FOTO]] *** ### 1. Dashboard de Vendas **Caminho:** Relatórios → **Dashboard de Vendas** #### Filtros | Filtro | Uso | | ----------------- | ------------------------------------------------------------------------------ | | Mês de referência | Mês analisado. Padrão: mês corrente (fuso do tenant) | | Funil | Recorta para um funil específico. Vazio = todos os funis que o usuário alcança | | Vendedores | Recorta pelo responsável do card. Aceita múltipla seleção | Qualquer alteração de filtro já gera o relatório de novo. Há também um botão **Gerar relatório** para atualizar manualmente. \[\[FOTO]] #### KPIs | KPI | O que significa | | --------------------------- | ------------------------------------------------------------------------------- | | **Meta do mês** | Meta do time (ou do vendedor/funil filtrado) cadastrada para o período | | **Ganho** | Valor somado dos cards marcados como Ganho no mês | | **% da meta** (velocímetro) | Ganho ÷ meta do time, em um gráfico de gauge | | **Conversão** | Ganhos ÷ (ganhos + perdidos) — só considera negócios já fechados | | **Oportunidades abertas** | Quantidade de cards ainda em aberto | | **Valor em aberto** | Soma do valor dos cards abertos | | **Valor ponderado** | Valor em aberto × probabilidade de cada card — estimativa de quanto deve fechar | | **Ticket médio** | Valor médio dos negócios ganhos | | **Ciclo médio de venda** | Dias entre a entrada do card no kanban e o fechamento (Ganho), em média | **Recorte temporal:** um card **fechado** (Ganho/Perdido) entra no mês em que foi fechado; um card ainda **aberto** entra no mês em que foi criado no kanban. Isso evita contar a mesma venda duas vezes (como "aberta" num mês e "ganha" no seguinte). \[\[FOTO]] #### Gráficos | Gráfico | Conteúdo | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | Evolução mensal — ganho × meta | Últimos 6 meses, comparando valor ganho com a meta de cada mês | | Ranking de vendedores | Valor ganho por vendedor, do maior para o menor. Cards sem responsável entram no balde **"Sem vendedor"**, para o total nunca sumir | | Em aberto por etapa | Valor (e valor ponderado) dos cards abertos, por coluna do funil | | Negócios por origem | Distribuição por campanha de origem ou canal do ticket vinculado; sem origem identificada cai em **"Origem desconhecida"** | | Resumo do período | Ganhos, perdidos, em aberto, ponderado e total, lado a lado | O ranking mostra no máximo 50 vendedores; havendo mais que isso com venda no mês, aparece um aviso de que a soma das linhas não fecha com o total ganho. \[\[FOTO]] #### Exportação e impressão | Ação | Resultado | | ------------ | ----------------------------------------------------------------------------------------- | | **Excel** | Exporta o ranking de vendedores (vendedor, negócios ganhos, valor ganho, meta, % da meta) | | **Imprimir** | Gera versão impressa do relatório com o resumo e a tabela | \[\[FOTO]] #### Metas Botão **Metas**, visível só para **administradores** (perfis admin/super). 1. Clique em **Metas** no cabeçalho do dashboard. 2. **Meta do time:** defina o valor (obrigatório) e, opcionalmente, a quantidade de negócios esperada para o mês/funil filtrado. 3. **Metas por vendedor:** clique em **Adicionar vendedor**, escolha o vendedor e informe a meta de valor (e opcionalmente a quantidade). 4. Salve cada linha individualmente. É possível excluir uma meta já cadastrada. As metas são **por mês e por funil**: ao trocar o filtro de funil, o modal mostra/edita a meta daquele funil. Quando o funil filtrado não tem meta própria, o dashboard usa a meta consolidada (sem funil), se existir. \[\[FOTO]] *** ### 2. Relatório de Funil **Caminho:** Relatórios → **Funil de Vendas** Funil visual por etapa, com percentual de conversão entre colunas, tempo médio em cada etapa e uma tabela com os valores. #### Filtros | Filtro | Uso | | ----------------- | ------------------------------------------------------------------- | | Funil | Qual quadro analisar. Padrão: o funil marcado como padrão do tenant | | Mês de referência | Mês analisado (fuso do tenant) | \[\[FOTO]] #### O que aparece * **Funil visual:** uma barra por etapa (coluna do kanban), na ordem do quadro, com o tamanho proporcional às entradas. * **Conversão entre etapas:** entradas da etapa seguinte ÷ entradas desta etapa, exibida entre as barras. * **Tempo médio na etapa:** quantos dias, em média, os cards ficam parados em cada coluna antes de sair dela. * **Tabela:** por etapa — entradas, em aberto, ganhos, perdidos, valor de entradas, valor ganho, valor perdido, dias médios na etapa e conversão para a próxima. * **Conversão dos fechados:** ganhos ÷ (ganhos + perdidos) do funil inteiro no mês. \[\[FOTO]] #### Exportação e impressão Os botões **Excel** e **Imprimir** exportam a mesma tabela por etapa mostrada na tela. *** ### Estimativa — leia antes de confiar nos números > O sistema **não grava um histórico completo de passagem do card entre colunas**. O relatório de funil é montado a partir da **posição atual** de cada card e da sua data de criação/fechamento — por isso os números de entradas, tempo por etapa e conversão são uma **aproximação**, não uma contagem exata de quantos cards passaram por cada coluna. Consequências práticas: * A tela mostra um selo **Estimativa** sempre visível, com esse aviso completo em um tooltip/nota. * A conversão de uma etapa para a próxima pode passar de **100%** — sem o histórico de passagem real, a etapa seguinte pode registrar mais entradas do que a anterior chegou a registrar. * Ainda **não existe** campo de motivo de perda no card; por isso o relatório não traz "motivos de perda" — o espaço já está reservado no back-end para quando esse campo existir. Use o relatório de funil para enxergar **gargalos e tendência** (onde os negócios empacam, quanto tempo ficam parados), não como uma auditoria exata de cada movimentação. *** ### Regras importantes * Os dois relatórios só enxergam os **funis que o usuário tem acesso** — mesma regra de permissão do Kanban (admin vê todos; os demais, os das suas filas ou vinculados individualmente). * Meses e fechamentos respeitam o **fuso horário do tenant**. * Só **administradores** (admin/super) cadastram, editam ou excluem metas. * O dashboard e o funil dependem inteiramente da **disciplina no Kanban**: card sem valor, sem status Ganho/Perdido, ou sem responsável definido, aparece como está — o relatório não infere nada que não esteja no card. * Valor ponderado = valor do card × probabilidade. *** ### Mensagens e erros comuns | Situação | Comportamento | | ---------------------------------------- | ---------------------------------------------------------- | | Sem dados no mês filtrado | KPIs zerados / "Nenhum dado no período" | | Falha ao gerar o relatório | Notificação de erro; tente novamente | | Exportar Excel sem dados | Botão desabilitado | | Imprimir sem relatório gerado | Botão desabilitado | | Meta sem valor informado | Aviso para preencher o valor da meta | | Ranking com mais de 50 vendedores no mês | Aviso de que a soma das linhas não fecha com o total ganho | *** ### Dicas de uso * Antes de fechar o mês, confira se o time marcou **Ganho/Perdido** e o **valor** em todos os cards fechados — é a única forma dos KPIs baterem com a realidade. * Cadastre a meta **no início do mês**, por time e, se fizer sentido, por vendedor — o gauge de "% da meta" e o ranking dependem dela. * Use "Em aberto por etapa" para identificar em qual coluna o funil está empacando. * Trate o relatório de funil como **estimativa de tendência**, não como número fechado — combine com a observação direta do quadro Kanban quando precisar de precisão. * Filtre por vendedor no Dashboard de Vendas para acompanhar performance individual sem esperar o fechamento do mês.