Ir para o conteúdo
Altuscorealtuscore.com.br

Dicionário de métricas · DIC-2026-EXE-001

Dicionário de métricas — o número é o número

Cada termo que aparece em painel, relatório ou reunião, com uma definição só, a conta, de onde sai e quem responde por ele.

Preparado para Helena Prado · Grão Norte Distribuidora · 19 de setembro de 2026

O problema

Toda reunião começava discutindo de quem era o número certo

Não era erro de ninguém: cada área tinha uma conta que fazia sentido para ela, com o mesmo nome.

O comercial olhava o CRM, o financeiro olhava os boletos, o marketing olhava a ferramenta de e-mail — e as três áreas chamavam o que viam de cliente ativo. A partir deste dicionário, cada termo tem uma definição só, e as outras contas continuam existindo com outro nome ou deixam de existir. O modelo de dados lê daqui, e todo painel lê do modelo.

9termos definidos 8versões antigas resolvidas 2donos respondendo
A mesma pergunta, 4 respostas

Quantos clientes ativos a distribuidora tem?

Cada área respondia com a própria conta, no mesmo mês (agosto de 2026). A maior resposta era 2,35 vezes a menor — e nenhuma estava errada pela regra de quem calculava.

Cliente ativo — a definição do dicionário1.284
CNPJ com pelo menos um pedido faturado nos últimos 90 dias, contados a partir do último dia do mês.
CRM do comercial2.140
todo cliente cadastrado com vendedor atribuído, tenha comprado ou não
Ferramenta de e-mail do marketing1.930
quem abriu pelo menos um e-mail nos últimos 90 dias
Planilha do financeiro912
quem pagou algum boleto dentro do mês

Em violeta, a definição que passa a valer. As outras seguem existindo com outro nome, ou deixam de existir — está no verbete.

O dicionário

Cada termo, com a conta e com quem responde

Em ordem alfabética. Quando um termo depende de outro, o nome leva ao verbete.

Cliente ativo

CNPJ com pelo menos um pedido faturado nos últimos 90 dias, contados a partir do último dia do mês.

count(distinct cnpj) de pedidos faturados com data entre fim_do_mes − 89 dias e fim_do_mes

Fonte
Modelo único — fato de pedidos faturados
Dono
Comercial — Rogério
Atualiza
diária, às 6h
Depende de
Pedido faturado
Usado em
Painel da diretoria, Painel comercial

Versões que circulavam antes

  • CRM do comercial — todo cliente cadastrado com vendedor atribuído, tenha comprado ou não. Renomeada passa a se chamar “Cliente em carteira”
  • Ferramenta de e-mail do marketing — quem abriu pelo menos um e-mail nos últimos 90 dias. Aposentada
  • Planilha do financeiro — quem pagou algum boleto dentro do mês. Renomeada passa a se chamar “Cliente pagante no mês”

Cliente novo

CNPJ cujo primeiro pedido faturado da história da distribuidora caiu dentro do mês.

min(data do pedido faturado) por cnpj dentro do mês

Fonte
Modelo único — fato de pedidos faturados
Dono
Comercial — Rogério
Atualiza
diária, às 6h
Depende de
Pedido faturado
Usado em
Painel comercial

Versões que circulavam antes

  • CRM do comercial — cadastro criado no mês, mesmo sem compra. Renomeada passa a se chamar “Cadastro novo”

Cliente perdido

Também chamado de “churn”

CNPJ que era cliente ativo no último dia do mês anterior e deixou de ser no último dia deste.

ativos(mês anterior) − ativos(mês), por cnpj

Fonte
Modelo único — fato de pedidos faturados
Dono
Comercial — Rogério
Atualiza
mensal, no dia 1º
Depende de
Cliente ativo
Usado em
Painel da diretoria

Devolução

Mercadoria que voltou com nota fiscal de entrada vinculada a uma nota de saída. Troca na entrega sem nota não é devolução: é ajuste do mesmo pedido.

notas de entrada com CFOP de devolução e referência a nota de saída

Fonte
ERP — tabela de notas fiscais de entrada
Dono
Financeiro — Paula
Atualiza
de hora em hora
Usado em
Fechamento mensal

Margem bruta

Receita líquida menos o custo da mercadoria vendida, pelo custo médio do estoque na data de cada nota. Em percentual, dividida pela receita líquida.

receita_liquida − soma(quantidade × custo_medio_na_data)

Fonte
ERP — notas de saída e posição de estoque
Dono
Financeiro — Paula
Atualiza
diária, às 6h
Usado em
Painel da diretoria

Versões que circulavam antes

  • Planilha da diretoria — usava o custo da última compra, que sobe antes de o estoque antigo acabar e derruba a margem do mês. Unificada nesta definição

Pedido faturado

Também chamado de “venda”

Pedido com nota fiscal emitida e não cancelada. Orçamento aprovado que ainda não virou nota não é pedido faturado.

notas.situacao = 'autorizada' e sem evento de cancelamento; conta uma vez por número de pedido

Fonte
ERP — tabela de notas fiscais de saída
Dono
Financeiro — Paula
Atualiza
de hora em hora
Usado em
Painel comercial, Fechamento mensal

Versões que circulavam antes

  • Planilha do comercial — contava pedido digitado no CRM, inclusive os que nunca faturaram por falta de estoque ou crédito. Renomeada passa a se chamar “Pedido digitado”

Prazo médio de recebimento

Também chamado de “PMR”

Dias entre a emissão da nota e o pagamento, ponderados pelo valor de cada título pago no mês.

soma(valor × dias até o pagamento) / soma(valor), títulos pagos no mês

Fonte
ERP — contas a receber
Dono
Financeiro — Paula
Atualiza
diária, às 6h
Usado em
Fechamento mensal

Receita líquida

Também chamado de “faturamento líquido”

Valor dos pedidos faturados no mês, menos devoluções e descontos concedidos. Frete cobrado e impostos destacados na nota ficam fora.

soma(valor dos produtos das notas faturadas) − soma(devoluções) − soma(descontos)

Fonte
ERP — notas de saída e de entrada
Dono
Financeiro — Paula
Atualiza
diária, às 6h
Usado em
Painel da diretoria, Fechamento mensal, Meta dos vendedores

Versões que circulavam antes

  • Relatório de metas do comercial — somava o valor total da nota, com frete e impostos, e não descontava devolução. Unificada nesta definição

Ticket médio

Receita líquida do mês dividida pelo número de pedidos faturados no mês.

receita_liquida(mês) / count(pedidos faturados no mês)

Fonte
Modelo único
Dono
Comercial — Rogério
Atualiza
diária, às 6h
Usado em
Painel comercial, Meta dos vendedores

Versões que circulavam antes

  • Painel antigo do comercial — valor total das notas com frete e impostos, dividido por pedido digitado. Unificada nesta definição
Leitura

Nenhuma conta antiga estava errada; o problema era o nome

Cliente em carteira e cliente pagante no mês são números úteis, e continuam no painel — só não se chamam mais cliente ativo. A única versão aposentada é a do marketing: abertura de e-mail mede interesse, não compra, e já existe no relatório da ferramenta. A mudança que mais vai aparecer é a da receita: o relatório de metas passa a descontar devolução, e a meta dos vendedores precisa ser recalculada na mesma régua antes do próximo fechamento.

Próximos passos
  1. Cada dono revisa os próprios verbetes e aprova a definição, por escrito.
  2. Recalcular a meta dos vendedores na régua da receita líquida antes do fechamento de outubro.
  3. Trocar os nomes no CRM e na planilha do financeiro para os nomes novos.
  4. Termo novo só entra no painel depois de entrar aqui, com dono.

O arquivo dicionario.csv tem os mesmos termos em tabela, para colar na wiki ou na documentação do modelo.