Desenhar bons Indicadores

Tipo

Como fazer

Para

Analista, Administrador do Tenant

Na tela

Indicadores e Relatórios › Criar indicador

Desenhar os Indicadores é decidir, antes de cadastrar, quais números a Aplicação responde e como cada um se calcula. Vale também quando o chat responde diferente à mesma pergunta. O conceito por trás (coluna, métrica, Indicador e quando dois números são o mesmo) está em Indicadores.

Antes de cadastrar

Liste no papel os conceitos que as pessoas perguntam, não os que existem no banco. Uma Aplicação de negócio costuma ter entre 5 e 25 conceitos de fato diferentes. Acima de 50, ela quase sempre está tentando ser várias Aplicações ao mesmo tempo.

Faça a pergunta-teste em cada item: se duas pessoas da empresa ouvem o nome e descrevem a mesma conta, é um conceito. Se descrevem contas diferentes, ou são dois Indicadores, ou o nome está ruim.

A régua

Passe cada Indicador novo por estas perguntas, nesta ordem.

Pergunta	Se sim	Se não
O nome é como as pessoas da empresa falam?	Siga	Renomeie antes de cadastrar
Já existe um Indicador com o mesmo filtro e a mesma coluna de data?	Acrescente a métrica em Valores alternativos dele	Siga
A diferença para um Indicador existente é só como agrupar ou qual período?	Não cadastre: quebra e período vêm da pergunta	Siga
A diferença cabe numa frase ("este não conta estornos")?	Escreva a frase na Descrição do existente	Siga
O filtro, a coluna de data ou a tabela são outros?	Crie o Indicador	Reveja: talvez seja o mesmo conceito

Um Indicador bem feito

Uma definição que cobre cinco métricas da mesma família:

Campo	Valor
Nome	Faturamento
Descrição	Faturamento comercial. Conta só vendas confirmadas do canal direto, sem receita financeira.
Valor principal	Soma de Vendas.Valor Líquido
Valores alternativos	Lucro, Margem (%), Ticket Médio, Quantidade Vendida, CMV
Coluna de data	Vendas.Data de Emissão
Filtros	Status = "Confirmado"

O nome é o que a empresa fala. O valor principal registra a decisão que ninguém deveria tomar de novo: valor líquido, e não bruto. As cinco alternativas têm o mesmo filtro e a mesma data, então ficam no mesmo Indicador. A coluna de data ancora "mês passado", "2025" e "ontem" na emissão. O filtro impede que venda cancelada entre em qualquer resposta.

Esse único Indicador responde "faturamento de março", "lucro do trimestre passado", "ticket médio deste ano", "margem de 2025 contra 2026" e "faturamento por filial nos últimos 30 dias". A quebra (filial, produto), o período e o ranking vêm de cada pergunta.

O mesmo conceito pulverizado

O erro mais comum é cadastrar uma variação de pergunta como se fosse um conceito:

Indicador	Valor principal	Coluna de data	Filtro
Vendas	Soma de Valor Líquido	Data de Emissão	Confirmado
Vendas Mensais	Soma de Valor Líquido	Data de Emissão	Confirmado
Vendas por Filial	Soma de Valor Líquido	Data de Emissão	Confirmado
Vendas por Produto	Soma de Valor Líquido	Data de Emissão	Confirmado
Ticket Médio	Valor Líquido / Quantidade	Data de Emissão	Confirmado
Lucro	Soma de Lucro Líquido	Data de Emissão	Confirmado

Os quatro primeiros são a mesma definição com agrupamentos diferentes. Ticket Médio e Lucro têm o mesmo filtro e a mesma data, então são valores alternativos. No lugar de um Indicador cobrindo as perguntas, o catálogo tem seis disputando cada uma. Quando alguém edita "Vendas" e esquece "Vendas Mensais", as respostas passam a divergir.

O sintoma típico é o chat responder uma coisa hoje e outra amanhã para a mesma pergunta.

Quando o filtro é o Indicador

Em alguns conceitos o filtro decide tudo. Sem ele, o número sai várias vezes maior.

Campo	Valor
Nome	Inadimplência
Descrição	Títulos a receber em atraso há mais de 30 dias, em aberto e não renegociados.
Valor principal	Soma de Contas a Receber.Valor do Título
Valores alternativos	Quantidade de títulos, Dias médios de atraso
Coluna de data	Contas a Receber.Data de Vencimento
Filtros	Status = "Aberto", Dias de Atraso > 30, Tipo de Negociação != "Renegociado"

Cada empresa define inadimplência de um jeito: 30, 60 ou 90 dias, com ou sem renegociados. O Indicador grava a regra da sua, e o chat deixa de reaprender a cada conversa.

Nomes parecidos

Este é o erro mais difícil de ver, porque o catálogo parece organizado:

Indicador	Filtro	Valor principal
Receita Confirmada	Status = "Confirmado"	Soma de Valor Bruto
Receita Líquida	Status = "Confirmado"	Soma de Valor Líquido
Receita Faturada	Status in ("Confirmado", "Faturado")	Soma de Valor Bruto

Receita Confirmada e Receita Líquida têm o mesmo filtro e mudam só a coluna: viram um Indicador "Receita", com valor líquido como principal e bruto como alternativo. Receita Faturada tem outro filtro e pode ser um conceito à parte, se a empresa distingue receita faturada de receita confirmada no dia a dia. Pergunte a quem faz as perguntas. Se forem coisas diferentes, mantenha os dois e escreva na Descrição de cada um o que os separa.

Quando separar de verdade

Receita comercial e receita financeira são dois Indicadores: vêm de tabelas diferentes, têm datas diferentes (emissão e movimentação) e filtros diferentes (venda confirmada e lançamento de juros, multa ou taxa). Também valem separados uma campanha com janela e filtro próprios, como "Faturamento da Black Friday", e linhas de produto com fórmulas diferentes, e não só um filtro por linha.

Na dúvida, pergunte: se eu juntar os dois num Indicador com valores alternativos, algum filtro fica errado para algum caso? Se sim, são dois.

Revisar o catálogo

• Indicador que ninguém usa: apague ou junte a outro.
• Dois Indicadores com a mesma coluna de data e os mesmos filtros: junte-os com Unificar selecionados, na curadoria. Quando também têm o mesmo nome, a curadoria já os marca com o selo Duplicado.
• Chat errando sempre o mesmo conceito: confira a coluna, a data e o filtro do Indicador dele.
• Respostas inconsistentes depois que o catálogo cresceu: procure famílias ("Vendas X", "Vendas Y") e junte.

Na dúvida, cadastre menos: acrescentar um Indicador depois dá menos trabalho do que limpar um catálogo inflado.

Relacionado

• Indicadores: o conceito e o que chega à IA
• A tela Indicadores e Relatórios: criar, seguir e ler
• Curadoria de Indicadores: publicar, unificar e excluir