ATS Especialista em PME - Base de Conhecimento - Relatório de Positivação de Clientes

Relatório de Positivação de Clientes | 139266 | Resulth Business

1. CONTEXTO

Gestores comerciais precisavam de uma visão consolidada sobre a efetividade da carteira de clientes: não apenas o volume de vendas, mas quantos clientes de fato compraram em determinado período. Essa informação, chamada de positivação, era difícil de obter sem cruzamento manual de dados.

O novo Relatório de Positivação de Clientes resolve essa necessidade entregando, em uma única tela, o percentual de positivação por vendedor ou rota, junto com indicadores de Total de Vendas, Ticket Médio e quantidade de Clientes Vinculados, tudo com filtros flexíveis e exportação para Excel.

2. O QUE HÁ DE NOVO

Novo relatório disponível em Relatórios → Faturamento → Vendas.
Quatro cards de indicadores consolidados no topo da tela: Total de Vendas, Ticket Médio, Clientes Vinculados e Positivação (%).
Grid de resultados com colunas ordenáveis por Vendedor/Rota, Total de Vendas, Pedidos, Ticket Médio, Clientes Vinculados, Clientes com compra no período e Positivação (%).
Filtros avançados com seleção múltipla de Vendedores, Rotas, Estado/Cidade, Tipo de Pedido, Considerar Troca e Considerar Devoluções.
Exportação para Excel (.xlsx) e impressão do relatório habilitadas após a pesquisa.
Filtros salvos automaticamente para futuras consultas.

3. COMO ACESSAR

Caminho: Relatórios → Faturamento → Vendas → Relatório de Positivação de Clientes

4. VISÃO GERAL DA TELA

A tela é composta por três áreas principais: filtros, cards de indicadores e grid de resultados.

Tela principal do Relatório de Positivação de Clientes com os cards de indicadores e o grid de resultados.

5. FILTROS DISPONÍVEIS

5.1 Filtros principais

Filtro	Obrigatório?	Descrição
Período	Sim	Data inicial e data final. Ambas são obrigatórias para gerar o relatório.
Filiais	Não	Seleção múltipla. Se o usuário possuir filial vinculada ao cadastro, somente ela estará disponível. Empresas com uma única filial têm o campo preenchido automaticamente.
Agrupar por	Não	Vendedor (padrão) ou Rota. Define a granularidade das linhas exibidas no grid.

5.2 Filtros Avançados

Clique no botão Filtros Avançados para acessar opções adicionais de segmentação:

Janela de Filtros Avançados com opções de Vendedores, Rotas, Estado/Cidade, Tipos de Pedido, Considerar Troca e Considerar Devoluções.

Filtro avançado	Descrição
Vendedores	Seleção múltipla. Exibe código, nome e situação (ativo/inativo).
Rotas	Seleção múltipla. Exibe código e nome da rota.
Estado / Cidade	Filtra pelo endereço principal do cliente. A cidade só é selecionável após a escolha do Estado.
Tipo de Pedido	Permite selecionar os tipos de operação a considerar: 51 - Digitação/Emissão NFe, 55 - Pré-venda, 56 - NFCe, 65 - O.S., Troca sem doc. origem.
Considerar Troca	Quando marcado, o valor das trocas é subtraído do Total de Vendas e do Ticket Médio. Trocas com NF de devolução associada não são consideradas (prevalece a NF de devolução).
Considerar Devoluções	Quando marcado, o valor das devoluções de vendas é subtraído do Total de Vendas e do Ticket Médio. Apenas devoluções dentro do mesmo período filtrado são consideradas.

Na seleção múltipla de Vendedores e Rotas, uma janela padrão é exibida com pesquisa e opções de Marca Todos / Desmarca Todos:

Janela padrão de seleção múltipla usada nos filtros de Vendedores e Rotas.

6. CARDS DE INDICADORES

Após a pesquisa, quatro cards são exibidos no topo do grid com os valores consolidados de toda a listagem:

Total de Vendas (R$)

Soma do total de vendas de todos os vendedores/rotas do grid.

Ticket Médio (R$)

Média = Total de Vendas / Quantidade de Pedidos.

Clientes Vinculados

Soma de clientes vinculados a vendedores ou rotas no período.

Positivação (%)

Média de (Clientes Positivados / Clientes Vinculados) × 100.

Indicador	Como é calculado
Total de Vendas (R$)	Soma do total de vendas do grid (com deduções de trocas/devoluções conforme filtros marcados).
Ticket Médio (R$)	Total de Vendas (com deduções) ÷ Quantidade total de pedidos.
Clientes Vinculados	Soma de todos os clientes vinculados a vendedores ou rotas exibidos no grid (conforme cadastro do cliente).
Positivação (%)	Média dos percentuais de positivação de cada linha do grid = (Clientes Positivados ÷ Clientes Vinculados) × 100.

ℹ	Indicadores exibidos zerados antes da pesquisa Antes de clicar em Pesquisar, todos os cards apresentam valor zero. Isso é o comportamento esperado e não indica ausência de dados.

7. GRID DE RESULTADOS

O grid exibe uma linha por vendedor ou rota, conforme o agrupamento selecionado, ordenado por padrão da maior para a menor positivação:

Coluna	O que representa
Vendedor ou Rota	Nome do vendedor ou da rota, de acordo com o agrupamento escolhido no filtro.
Total de Vendas (R$)	Volume financeiro de vendas do vendedor/rota no período (descontando trocas e devoluções se os filtros estiverem marcados).
Pedidos	Quantidade de pedidos realizados no período.
Ticket Médio (R$)	Total de Vendas do vendedor/rota ÷ Quantidade de pedidos.
Clientes Vinculados	Total de clientes que possuem o vendedor ou a rota associada em seu cadastro.
Clientes com compra no período	Quantidade de clientes vinculados que realizaram ao menos uma compra no período filtrado.
Positivação (%)	(Clientes com compra no período ÷ Clientes Vinculados) × 100. Coluna com destaque visual no cabeçalho. Ordenação padrão decrescente.

Todas as colunas são ordenáveis: clique no cabeçalho da coluna para alternar entre ordem crescente e decrescente. A navegação entre linhas também pode ser feita pelas teclas direcionais do teclado.

8. COMO USAR

Acesse Relatórios → Faturamento → Vendas → Relatório de Positivação de Clientes.
Informe o Período (data inicial e final — obrigatórios).
Selecione as Filiais desejadas (ou aguarde o preenchimento automático, se aplicável).
Escolha o agrupamento: Vendedor (padrão) ou Rota.
Se necessário, clique em Filtros Avançados para refinar por Vendedor, Rota, Estado/Cidade, Tipo de Pedido, Trocas ou Devoluções.
Clique em Pesquisar. Uma barra de progresso é exibida durante o carregamento.
Analise os cards de indicadores no topo e os dados detalhados no grid.
Para exportar, clique em Exportar (gera arquivo .xlsx). Para imprimir, clique em Imprimir. Ambos os botões ficam habilitados somente após a pesquisa.

ℹ	Abortar pesquisa em andamento Durante o carregamento, pressione ESC para interromper a operação. O sistema exibirá a mensagem "Deseja abortar a operação?" com as opções SIM e NÃO.

9. IMPRESSÃO E EXPORTAÇÃO

Imprimir: gera uma impressão com o mesmo layout exibido no grid. O botão exibe o hint "Realize uma pesquisa para habilitar a impressão" quando desabilitado.
Exportar para Excel: exporta os dados do grid para o formato .xlsx. Funciona mesmo sem o Microsoft Excel instalado. O botão exibe o hint "Realize uma pesquisa para habilitar a exportação" quando desabilitado.

10. BOAS PRÁTICAS E OBSERVAÇÕES

Filtros salvos: os filtros aplicados são mantidos automaticamente para a próxima vez que o relatório for aberto, poupando retrabalho em consultas recorrentes.
Clientes vinculados × positivados: a positivação considera o vendedor amarrado ao pedido, não necessariamente o vendedor cadastrado no cliente. Certifique-se de que os pedidos estão corretamente atribuídos aos vendedores.
Valores negativos: o Total de Vendas pode ficar negativo caso o valor de devoluções/trocas no período seja maior do que o valor de vendas. Isso é um comportamento esperado do sistema.
Pedidos sem faturamento: se no período existirem apenas trocas ou devoluções (sem nenhum pedido faturado), o vendedor/rota não será exibido no grid.
Nenhum resultado encontrado: se os filtros não retornarem dados, o sistema exibirá a mensagem "Nenhum resultado encontrado para os filtros aplicados", sem travar a tela.

⚠	Impacto em análise comercial O relatório considera apenas vendas onde o tipo de operação está marcado como "Considerar em vendas" e devoluções marcadas como "Devolução de vendas". Tipos de operação fora desse critério não aparecem nos resultados, mesmo que existam pedidos no período.