Objetivo
Explicar o que cada indicador do Dashboard v2 representa, como é calculado e como interpretar variações, facilitando o uso no dia a dia por times comerciais, operação e suporte.
Quando usar este guia
Para entender quedas ou crescimentos inesperados
Para validar comparações com período anterior
Para explicar números a clientes ou áreas internas
Para investigar impactos de incentivos, conversão e cancelamentos
O que você vai conseguir com este artigo
Entender rapidamente o significado de cada KPI
Saber como cada número é calculado
Identificar o que investigar quando algo foge do esperado
Regras Gerais de Cálculo
Período selecionado
Intervalo definido no datepicker.
👉 Todos os KPIs e gráficos usam exatamente esse período.
Exemplo
01/02/2026 a 28/02/2026
Período anterior (comparação)
Intervalo imediatamente anterior, com a mesma duração do período atual.
Exemplo
Atual: 01/02/2026 a 28/02/2026
Anterior: 04/01/2026 a 31/01/2026
Variação percentual (vs período anterior)
Mostra crescimento ou queda em relação ao período anterior.
Fórmula
((valor_atual - valor_anterior) / valor_anterior) * 100
Exemplo
Atual: 120 | Anterior: 100 → +20%
⚠ Atenção – Divisão por zero
Se o valor anterior for 0, a API aplica fallback. Nessas situações, a variação deve ser analisada com cautela.
Pedidos considerados
Apenas pedidos válidos/operacionais:
Aprovados
Dentro do fluxo normal
❌ Cancelados, reprovados e status fora do fluxo não entram.
Formatação dos dados
Valores monetários: R$ (pt-BR)
Percentuais: 1 casa decimal
Quantidades: inteiro com separador de milhar
Bloco Comercial
Linha 1 — Receita
Total de Vendas
Soma da receita de todos os pedidos válidos no período.
Exemplo
1.939 pedidos → R$ 1.042.732,72
Número de Pedidos
Quantidade total de pedidos válidos no período.
Ticket Médio
Valor médio por pedido válido.
Fórmula
total_vendas / numero_pedidos
Exemplo
R$ 1.042.732,72 / 1.939 = R$ 537,77
👉 Use este KPI para entender se o crescimento veio de:
Mais pedidos (volume)
Pedidos maiores (valor)
Taxa de Conversão
Percentual de pedidos aprovados sobre pedidos que passaram pelo carrinho.
Fórmula
aprovados / carrinho * 100
⚠ Quedas costumam indicar:
Fricção no checkout
Regras comerciais restritivas
Problemas de disponibilidade
Linha 2 — Base de Clientes
Novos Clientes
Clientes cuja primeira compra histórica ocorreu no período.
Clientes Ativos
Clientes com ao menos 1 compra no período.
Taxa de Recompra
Percentual de clientes ativos com 2 ou mais pedidos no período.
Fórmula
clientes_com_2+ / clientes_ativos * 100
LTV Médio
Média da receita histórica acumulada dos clientes ativos.
⚠ Importante:
Não representa apenas o período atual. É um valor histórico, filtrado pelos clientes ativos no período.
Faturamento por Dia
Série diária de receita, com comparativo do período anterior.
Tooltip recomendado
Data
Quantidade de pedidos
Ticket médio
Valor total
Receita por Hora
Distribuição da receita por hora (0h–23h).
Destaque fixo: 08h às 18h
Indicadores de participação dentro e fora do horário comercial
Funil de Conversão
Etapas:
Carrinho
Aprovados
Faturados
Cancelados
📌 Fonte do funil
Baseado na passagem por status (pedidos_status), não apenas no status final. Isso reflete o fluxo real.
Outros indicadores do bloco
Vendas por Canal (app, mobile, desktop)
Vendas por Emitente (assistida x direta)
Formas de Pagamento
Top Clientes
Top Produtos
Bloco Comercial de Incentivos
O que é considerado incentivo
Um item entra como incentivado se possuir ao menos um dos campos:
id_promocao
id_campanha
id_cupom_desconto
id_cupom_automatico
id_brinde
id_precificador (quando promocional)
Linha 1 — Resumo
Valor total de pedidos incentivados
Valor total dos itens incentivados
Pedidos com incentivo
% da receita com incentivo
Fórmula
valor_pedidos_incentivados / valor_total * 100
Mix de Incentivos
Exclusivo: cada item entra em um único grupo
Inclusivo: um item pode ter múltiplos incentivos
Overlap: quantidade de incentivos simultâneos por item
Rankings e Alertas
Top promoções por receita
Dependência excessiva de incentivos
Concentração em cupom único
Alertas Operacionais e Comerciais
Queda de Conversão → variação negativa vs período anterior
Alta de Cancelamento → aumento relevante da taxa
Atenção à Internalização → SLA médio + pendências
Exemplo
“SLA médio de 31 min e 1 pendência”
→ Tempo médio foi 31 min e existe ao menos um pedido pendente
Exemplos de Interpretação
Receita sobe e conversão cai
Receita +12% | Conversão -8%
→ Campanhas podem ter elevado ticket, mas o funil perdeu eficiência.
Receita incentivada muito alta
58% da receita com incentivo
→ Risco de dependência e impacto em margem.
Recompra sobe e novos clientes caem
Base compra mais, mas aquisição perde força → risco no médio prazo.
Boas Práticas de Leitura
Sempre confira o período selecionado
Analise KPI + variação, não apenas o número
Separe efeito de volume e ticket
Em incentivos, avalie impacto em margem
Use alertas como triagem, não diagnóstico final
Notas Técnicas
Cache padrão: 10 minutos
Cache por tenant / período / bloco
Consultas de funil, clientes e incentivos são mais sensíveis em bases grandes
Glossário Rápido
KPI: Indicador-chave de desempenho
Ticket médio: Valor médio por pedido
Recompra: Cliente com 2+ pedidos
LTV: Valor histórico acumulado por cliente
Overlap: Múltiplos incentivos no mesmo item