> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# [Metrics] Como montar um ranking de vendedores

# Como montar um ranking de vendedores no Metrics

O widget **Ranking** mostra uma lista ordenada do maior para o menor, com medalha para os três primeiros (🥇🥈🥉), a posição dos demais (4º, 5º…), o valor de cada um e uma barra colorida que compara cada pessoa com o líder. É o formato ideal para acompanhar campanhas e feirões na TV da loja.

---

## Onde fica

Abra o painel no Metrics › clique em **Editar** › **Adicionar** › **Gráfico, KPI ou tabela**. Para mudar um ranking que já existe, com o painel em edição, abra a configuração do próprio widget.

A configuração tem três passos: **Consulta**, **Visualização** e **Aparência**.

## Passo a passo

1. Com o painel aberto, clique em **Editar**.
2. Clique em **Adicionar** › **Gráfico, KPI ou tabela**.
3. No passo **Consulta**, escreva a consulta (ou peça à IA). Ela precisa devolver **duas colunas**: o **nome** (ex.: vendedor) e o **número** que define a ordem (ex.: valor vendido).
4. Avance para **Visualização** e escolha o tipo **Ranking**.
5. Na coluna do número, em **Formato**, escolha **Moeda (R$)** se for valor em dinheiro, ou **Número** se for quantidade.
6. Avance para **Aparência**. Se não quiser o percentual em relação ao 1º lugar, ligue **Ocultar % (vs 1º lugar)**.
7. Salve o widget e clique em **Concluir** no painel.

## Exemplo: ranking por valor vendido, com a quantidade de vendas ao lado do nome

A consulta abaixo ordena os vendedores pelo valor vendido e mostra entre parênteses quantas vendas cada um fez — por exemplo, "MARIA SOUZA (3)" com R$ 39.560,00. Troque as datas pelo período da sua campanha.

```sql
SELECT CONCAT(u.Nome, ' (', COUNT(*), ')') AS Vendedor,
       SUM(v.ValorTotal) AS Valor
FROM Vendas v
JOIN Usuarios u ON u.Id = v.VendedorId
WHERE v.DataVenda BETWEEN '2026-10-29' AND '2026-10-31 23:59:59'
GROUP BY u.Nome
ORDER BY Valor DESC
```

Depois, no passo **Visualização**, deixe a coluna **Valor** com o formato **Moeda (R$)**.

Se o painel tiver o filtro de data, use a variável do filtro no lugar das datas fixas (veja o artigo de filtros e variáveis abaixo).

## Como o ranking lê as colunas

- **1ª coluna de texto**: o nome que aparece em cada linha.
- **1ª coluna numérica**: o valor que define a ordem e o tamanho da barra.
- **2ª coluna numérica (opcional)**: é tratada como **meta**. O ranking passa a mostrar "valor / meta" e o percentual de atingimento, e ordena pelo atingimento.

## Erros comuns

- **Aparece só a quantidade (1, 2, 3) e não o valor**: a consulta está contando vendas (`COUNT`). Para ordenar por dinheiro, use a soma do valor (`SUM`) como coluna numérica e escolha o formato **Moeda (R$)**.
- **Coloquei a quantidade como segunda coluna e apareceu um percentual estranho**: a segunda coluna numérica vira meta. Para mostrar a quantidade, junte-a ao nome, como no exemplo acima.
- **O valor aparece sem R$**: no passo **Visualização**, mude o **Formato** da coluna para **Moeda (R$)**.

## O que o ranking não faz

O ranking do Metrics não mostra a **foto** dos usuários nem o formato de **pódio** (três primeiros em destaque, lado a lado) da aba Ranking do Dashboard do CRM. Para esse formato com fotos, use a aba **Ranking** do Dashboard do CRM.