5.6 Cada um com seu número: armazém, camada semântica e a reconciliação

Pergunta antes de ler

A Órbita tem quatro respostas para a pergunta “qual é o nosso ARR?”: R$ 26,9 milhões no CRM, R$ 25,2 milhões no ERP, R$ 24,8 milhões na planilha da CFO e R$ 23,2 milhões no painel de BI. Antes de continuar, escolha um e escreva por quê.

Depois escreva um segundo número: de quanto você acha que é a diferença entre o maior e o menor, em reais e em percentual do menor.

A escolha mais comum é a planilha da CFO, porque quem a defende tem o cargo mais associado a rigor. A segunda mais comum é o ERP, porque “é o que fatura”. As duas escolhas estão erradas pelo mesmo motivo: escolher é a operação errada. A diferença entre R$ 26,94 milhões e R$ 23,18 milhões é de R$ 3,76 milhões, ou 16,2% sobre o menor, e ela não é arredondamento nem divergência de metodologia. É a soma de seis defeitos com nome, valor, sistema de origem e dono de correção. A tarefa de RevOps não é arbitrar qual sistema está certo. É decompor.

Escolher um número entre quatro é política. Decompor a diferença entre eles é arquitetura.

Por que o CRM não consegue guardar o passado

Sistema transacional e sistema analítico: o palco e o livro-razão

O CRM existe para registrar e executar operações uma a uma. Ele é otimizado para escrita e mostra o estado atual. É um palco: editável, prospectivo, cheio de intenção e de narrativa de vendedor. O sistema de faturamento é um livro-razão: ele acrescenta linhas e não reescreve as antigas, é retrospectivo e auditável.

A regra de arbitragem. Quando os dois discordam sobre dinheiro, vence o livro-razão. Quando discordam sobre intenção, vence o palco. Tentar fazer um virar o outro é o erro arquitetural mais caro que existe, porque destrói a propriedade que tornava cada um útil.

O sistema analítico, o armazém de dados, existe para responder perguntas sobre muitos registros ao mesmo tempo e para guardar o histórico do estado. Ele não substitui nenhum dos dois. Ele guarda o que os dois esquecem.

Arraste o desenho para o lado para ver inteiro

Figura 5.6 O palco reescreve a própria história; o livro-razão acrescenta linhas. Leia as duas colunas como dois contratos diferentes com o tempo. À esquerda, o retângulo arredondado é processo: o registro é alterado no lugar e a versão anterior some. À direita, o retângulo reto é registro: cada mudança é uma linha nova e a anterior continua lá. A linha de baixo é a regra de arbitragem, e ela não é negociável por cargo.

Essa é a razão de existir do armazém, e ela não tem nada a ver com volume de dados. A Órbita tem 544 clientes e 640 oportunidades no ano. Isso cabe numa planilha. O que não cabe numa planilha é a pergunta “qual era o pipeline de agosto no dia 31 de agosto?”, porque o CRM já não sabe: um vendedor mudou a data prevista de fechamento em setembro e agosto mudou junto, sem aviso e sem registro de quem mexeu.

Camada semântica e a regra do instantâneo

A camada semântica é a tradução, escrita uma única vez e versionada em código, entre as tabelas técnicas e os conceitos de negócio. É onde mora a definição de ARR, de cliente ativo, de receita. O fluxo inteiro é: sistemas, carga, armazém bruto, transformação, camada semântica, painel. A métrica se define no penúltimo passo, nunca no último.

Regra do instantâneo: qualquer número que alguém vai usar para pagar, prometer ou reportar externamente precisa vir de um instantâneo datado e congelado, nunca de consulta ao vivo a sistema transacional.

Arraste o desenho para o lado para ver inteiro

Figura 5.6-b A métrica nasce no penúltimo passo. A Órbita a define no último, seis vezes. Leia as duas raias como dois caminhos para o mesmo número. A de cima é o caminho completo, e o marcador em ocre mostra o único lugar onde a definição de ARR pode morar sem se multiplicar. A de baixo é o caminho que a Órbita usa hoje: um export manual direto para a ferramenta de painel, o que faz a definição nascer dentro de cada painel. Nove painéis significam até nove definições, e é por isso que o número do BI não bate com o de ninguém.

A definição canônica vem antes da aritmética

Note a ordem. A reconciliação não começa olhando os quatro números. Começa escrevendo a definição que vai valer, porque sem ela não existe nem o conceito de estar errado. A definição precisa declarar três coisas, sempre as mesmas: grão, filtro e janela.

métrica publicada = grão declarado + filtro declarado + janela declarada

Grão é o que conta como uma linha. Filtro é quem entra e quem fica de fora. Janela é a data de posição. Uma métrica publicada sem as três não é métrica: é um número com nome bonito.

R$ 24,8 milhõesARR canônico da Órbita em 31/12/2025Uma linha por assinatura com vigência ativa, líquida de desconto contratual, sem serviço não recorrente, posição congelada

Qual é o ARR ativo da Órbita em 31 de dezembro de 2025, pela definição canônica?

-- Grão: uma linha por assinatura.
-- Filtro: vigente em 31/12/2025, inadimplência curta conta como ativa.
-- Janela: posição de 31/12/2025.
SELECT SUM(valor_recorrente_anualizado) AS arr_ativo
FROM   assinatura
WHERE  status IN ('ativa', 'inadimplente_ate_60d')
  AND  data_inicio_vigencia <= DATE '2025-12-31'
  AND  (data_fim_vigencia IS NULL OR data_fim_vigencia > DATE '2025-12-31');

Três linhas fazem todo o trabalho e nenhuma delas é técnica. O GROUP BY ausente e o SUM sobre assinatura declaram o grão: uma linha por assinatura. O IN declara o filtro, e é aqui que mora o defeito de R$ 1,62 milhão do painel: quem escreve apenas = 'ativa' apaga do relatório as contas inadimplentes de menos de 60 dias, que estão contratualmente vigentes e sendo cobradas. As duas comparações de data declaram a janela. Guarde o formato: toda consulta deste livro vai repetir esta estrutura.

A reconciliação da Órbita, linha a linha

Arraste o desenho para o lado para ver inteiro

Figura 5.6-c Seis defeitos, não uma reunião de alinhamento. Leia da esquerda para a direita como uma queda do maior número até o canônico, e depois como duas ramificações. As três barras vermelhas do meio são deduções do número do CRM, e cada uma tem uma causa diferente: escopo de contrato, escopo de período e escopo de receita. A barra em petróleo é o ARR canônico. As duas colunas da direita mostram por que o ERP fica acima e o painel fica abaixo. Todos os rótulos vão na mesma unidade, milhões de reais com duas casas, para que a subtração de cada degrau feche nos próprios números impressos e nenhum rótulo vizinho troque de unidade. Compare com a cascata de ARR do Módulo 1: é o mesmo traçado, lido como divergência entre sistemas em vez de movimento no ano.

Na práticaÓrbita Software · fechamento de 31/12/2025

Passo 1: escrever a definição antes de olhar número. ARR da Órbita é a soma do valor recorrente contratado, normalizado para doze meses, de todas as assinaturas com vigência ativa em 31/12/2025, líquida de descontos contratuais, excluindo serviços não recorrentes e consumo variável não contratado. Grão: uma linha por assinatura. Sistema de registro: o faturamento. Janela: posição de 31/12/2025, congelada. Por essa definição o ARR é R$ 24,8 milhões.

Passo 2: decompor o excesso do CRM. R$ 26,94 milhões menos R$ 24,8 milhões = R$ 2,14 milhões, e ele tem três causas nomeadas. A primeira é R$ 1,48 milhão: contratos plurianuais entram no campo de valor pelo total do contrato e não pelo valor anual, então um contrato de 24 meses conta dobrado. A segunda é R$ 390 mil: quatorze oportunidades ganhas em 2025 com vigência começando em 2026, que são booking e não são ARR ativo. A terceira é R$ 270 mil: serviços não recorrentes somados ao mesmo campo em nove contratos.

Confere: R$ 1,48 milhão + R$ 390 mil + R$ 270 mil = R$ 2,14 milhões. E R$ 24,8 milhões + R$ 2,14 milhões = R$ 26,94 milhões.

Passo 3: decompor o ERP. Aqui os dois totais são vizinhos e a diferença é pequena, então a conta vai em R$ mil, unidade declarada uma vez, para fechar no último real: 25.212 no ERP menos 24.800 do canônico dão 412, isto é, R$ 412 mil de diferença líquida, composta de três movimentos opostos: R$ 680 mil porque matrizes e filiais são faturadas e contadas separadamente, R$ 190 mil de contratos cancelados que continuam ativos no cadastro, e uma falta de R$ 458 mil de contratos com vigência iniciada e ainda não faturados. Some: R$ 680 mil + R$ 190 mil menos R$ 458 mil = R$ 412 mil.

Passo 4: decompor o painel. O painel mostra R$ 23,18 milhões, uma falta de R$ 1,62 milhão contra o canônico de R$ 24,8 milhões. A causa é de recorte temporal: ele foi construído sobre um export de out/25 e nunca atualizado. Confira que a conta fecha pelo calendário: o ACV novo de novembro foi R$ 640 mil e o de dezembro R$ 880 mil, somando R$ 1,52 milhão. Sobram R$ 100 mil. A explicação provável é o líquido de expansão menos perdas dos dois meses, mas ela não foi verificada contra a cascata mensal, então entra como resíduo declarado de 0,4% do ARR, dentro da banda de tolerância. Declarar o resíduo com nome, tamanho e percentual é o que separa uma reconciliação de uma desculpa. Batizá-lo de causa sem ter medido é a linha de outros com roupa melhor.

Passo 5: quantificar o dano, que é o que compra orçamento. O crescimento real é (R$ 24,8 milhões menos R$ 18,4 milhões) ÷ R$ 18,4 milhões = 34,8%. Com o número do CRM, (R$ 26,94 milhões menos R$ 18,4 milhões) ÷ R$ 18,4 milhões = 46,4%. São 11,6 pontos percentuais de crescimento que não existem, num slide que vai para Sérgio Bittencourt e para o processo de Série C.

Quota fantasma de 2026. O plano de 2026 cresce de R$ 24,8 milhões para R$ 31,9 milhões, ou 28,6%. Aplicada sobre R$ 2,14 milhões de base que nunca existiu, essa taxa gera R$ 2,14 milhões × 28,6% = R$ 613 mil de quota sem lastro. Distribuída entre 11 AE, dá R$ 55,7 mil por pessoa por ano. O plano de remuneração do Módulo 8 nasceria quebrado por um defeito de modelagem deste módulo.

Custo de manter o problema. Bruno Capucci gasta três dias por mês fechando o ARR à mão, o que dá 36 dias-pessoa por ano e R$ 31 mil de custo por ano para a empresa. Isso é R$ 861 por dia-pessoa, e guarde essa taxa: ela é a régua com que você vai precificar qualquer correção deste módulo.

O veredito. Nenhuma das quatro pessoas mentiu e nenhuma das quatro estava certa. O que faltava não era honestidade. Era uma frase escrita com grão, filtro e janela, e um lugar onde ela morasse.

O instantâneo, o dicionário e a banda de tolerância

Reconciliar uma vez é um bom exercício. O que muda a operação é impedir que a divergência volte, e isso se faz com três artefatos baratos. O primeiro é o instantâneo mensal congelado: no primeiro dia útil do mês, o estado do mês anterior é gravado numa tabela que não se altera mais. O segundo é o dicionário de métricas versionado, em que cada definição tem autor, data, grão, filtro, janela e o número da versão anterior. O terceiro é o painel de reconciliação com banda de tolerância declarada: acima dela, abre-se incidente com dono e prazo.

Como se congela o ARR de um mês para que ele nunca mude retroativamente?

INSERT INTO instantaneo_arr (data_posicao, versao_definicao, apurado_em, arr)
SELECT DATE '2025-12-31',
       'arr_ativo_v3',
       CURRENT_TIMESTAMP,
       SUM(valor_recorrente_anualizado)
FROM   assinatura
WHERE  status IN ('ativa', 'inadimplente_ate_60d')
  AND  data_inicio_vigencia <= DATE '2025-12-31'
  AND  (data_fim_vigencia IS NULL OR data_fim_vigencia > DATE '2025-12-31');

A diferença entre esta consulta e a anterior não é técnica, é institucional. A anterior responde “quanto é agora”. Esta grava “quanto era naquele dia, segundo a versão 3 da definição, apurado em tal momento”. Se a definição mudar, a versão muda e as linhas antigas continuam legíveis. Se alguém editar retroativamente um contrato, a próxima apuração mostra a diferença em vez de reescrever a anterior. É isso que torna comissão auditável, e no Brasil, onde a comissão integra a remuneração do empregado, auditável deixa de ser boa prática e vira controle de risco.

Arraste o desenho para o lado para ver inteiro

Figura 5.6-d A mesma pergunta, dois meses depois, duas respostas e nenhum registro. Leia os dois painéis como duas políticas para a mesma pergunta. No de cima, a consulta é feita ao vivo e a resposta muda quando alguém edita um registro antigo, sem que ninguém fique sabendo. No de baixo, a resposta de agosto está congelada e a edição vira uma linha de diferença com data e autor. A mudança não é impedida: ela passa a ser visível.

Fonte	ARR total da empresa, em R$ mil	Diferença para o canônico, em R$ mil	Tipo de defeito	O que fazer com essa linha
CRM	26.940	+2.140	escopo de contrato, de período e de receita	separar valor recorrente anualizado de valor total e de serviço, em campos distintos
ERP e faturamento	25.212	+412	identidade e evento ausente	agregar por raiz de CNPJ e baixar cadastro de contrato cancelado
Planilha da CFO	24.800	0	nenhum, e esse é o problema	promover a definição a código e aposentar a planilha, sem aposentar a autora
Painel de BI	23.180	-1.620	recorte temporal	ligar o painel ao instantâneo e derrubar o export manual

O painel de reconciliação mensal que a Órbita passa a publicar. A banda de tolerância é uma decisão de governança, não uma propriedade matemática: 0,5% sobre R$ 24,8 milhões são R$ 124 mil, e acima disso alguém abre incidente com dono e prazo. Todos os valores da tabela são ARR da empresa inteira e estão em R$ mil, unidade declarada uma vez no cabeçalho de cada coluna de número para que os números fiquem nus e as duas colunas subtraiam à vista, linha a linha: 26.940 menos 24.800 dão 2.140. A última coluna existe porque tabela só de número não decide nada.

Repare no que aconteceu com a planilha da Cláudia Meirelles nessa tabela. Ela é o número certo e continua sendo um problema, porque uma definição que só existe na cabeça e nas fórmulas de uma pessoa não é uma definição institucional: é uma dependência. A correção não é tirar a autoridade dela. É transformar o que ela já faz certo em código versionado que qualquer um consegue ler, para que a empresa continue tendo o número quando ela estiver de férias.

Exercício 5.660 minutos, planilha

Escreva a definição canônica de ARR da sua empresa em no máximo quatro linhas, declarando explicitamente grão, filtro e janela. Teste: entregue a definição a alguém de outra área e peça que ela diga, sem perguntar nada, o que fazer com um contrato assinado em dezembro com vigência em fevereiro.
A dedução de R$ 390 mil vem de 14 oportunidades. Antes de dividir, escreva contra qual número da Órbita você vai comparar o resultado e por que escolheu esse. Depois calcule o ACV médio implícito e diga se ele é plausível. Explique por que a ordem entre escolher a âncora e fazer a conta importa.
Se a Órbita passar a contar ARR por data de vigência e não por data de fechamento, a quota de 2026 sobe ou desce? Calcule e explique a consequência política da sua resposta.
Adversarial: um diretor propõe resolver tudo comprando um armazém de dados e uma ferramenta de BI decente, porque “o problema é o painel”. Use a decomposição deste capítulo para mostrar quanto do erro isso resolveria, em reais e em percentual. Declare antes qual denominador você está usando, a amplitude entre o maior e o menor ou a soma das três divergências, e diga por que a escolha muda a resposta.

Conferir respostas

Grão, filtro e janela. Exemplo aceitável: receita recorrente anualizada, uma linha por assinatura, status em (ativa, inadimplente até 60 dias), posição do último dia do mês, congelada. Se a sua definição não diz o que acontece com um contrato assinado em dezembro com vigência em fevereiro, ela ainda não está pronta.
R$ 390 mil ÷ 14 contratos = R$ 27,9 mil de ACV médio por contrato adiado, ou seja por cliente por ano. A âncora certa é o ACV médio dos novos da Órbita, que é R$ 37,3 mil: o lote vale 75% dele, mesma ordem de grandeza e abaixo da média, o que descreve uma mistura puxada para SMB e mid baixo. Quem ancorar contra o ticket publicado do mid-market, que é R$ 62,5 mil, vai encontrar 45% e concluir que o número está errado. Não está: o que está errado é a âncora. Um lote de 14 contratos ganhos no fim do ano não é um lote mid-market puro, e dizer que é seria inventar um segmento para justificar um valor. A conferência de plausibilidade é parte da reconciliação, e ela só funciona quando a âncora é escolhida antes da conta: um número que fecha na soma e não fecha na ordem de grandeza costuma esconder dois erros que se cancelam.
Sobe. Passar a contar por vigência tira R$ 390 mil de 2025 e joga em 2026, o que aumenta a base de partida do ano seguinte e, com ela, a quota. O ponto do exercício é perceber que corrigir uma métrica move dinheiro no plano de remuneração de alguém, e que por isso a correção precisa ser anunciada antes do ciclo, nunca no meio.
Metacognitivo: a maior parte dos leitores escolhe o painel porque divergência dói onde ela é vista. A reconciliação mostra o contrário: R$ 2,14 milhões de R$ 3,76 milhões de amplitude entre o maior e o menor nascem no CRM, que é a camada de registro. Corrigir o painel primeiro produz um gráfico bonito sobre um modelo errado. Repare no denominador: R$ 3,76 milhões é amplitude, e os R$ 412 mil do ERP ficam de fora porque são o líquido de uma sobra e uma falta que se cancelam em parte. Se o seu recorte for divergência total e não amplitude, some os três e trabalhe com R$ 4,17 milhões. Os dois recortes são legítimos. Publicar um com o nome do outro não é.

Armadilha: filtrar por status sem saber o que os outros status significam

O analista recebe a tabela de assinaturas, vê sete valores possíveis no campo de status e nenhuma legenda. Ele faz o que qualquer pessoa razoável faria: escolhe o que parece óbvio e escreve status = ativa. O painel fica pronto, ninguém reclama, e a partir daquele dia um pedaço do ARR vigente deixa de existir para a empresa.

O detalhe que torna isso grave não é o erro de consulta. É que as contas que sumiram do painel são exatamente as que alguém deveria estar trabalhando: clientes vigentes, sendo cobrados, em régua de cobrança, na janela em que a recuperação ainda é barata. Elas somem da vista de quem poderia salvá-las.

A correção tem duas partes e a segunda é a que ninguém faz. A primeira é reescrever o filtro. A segunda é publicar a legenda completa dos sete status, com o significado de negócio de cada um, junto do modelo, para que o próximo analista não precise adivinhar.

Um filtro que ninguém consegue justificar em português é uma decisão de negócio tomada por quem não tinha mandato para tomá-la.

Recuperação

Responda antes de abrir. Tentar e errar consolida mais que reler.

1Por que um relatório histórico rodado no CRM pode mudar sem que ninguém tenha mexido no relatório, e qual regra impede isso?
Porque o CRM guarda o presente e não o passado: editar hoje a data de um negócio antigo reescreve o mês antigo. A regra do instantâneo impede: qualquer número usado para pagar, prometer ou reportar externamente sai de uma posição datada e congelada, nunca de consulta ao vivo.
2Uma empresa mostra R$ 8,4 milhões de ARR no CRM e R$ 7,95 milhões no faturamento. Auditoria encontra R$ 300 mil de implantação somada ao campo de valor e 6 contas duplicadas somando R$ 150 mil. A reconciliação fecha? O que isso diz sobre a qualidade do diagnóstico?
Fecha exatamente: R$ 300 mil + R$ 150 mil = R$ 450 mil, e R$ 7,95 milhões + R$ 450 mil = R$ 8,4 milhões. Uma reconciliação que fecha sem linha de ajuste é a prova de que o diagnóstico está completo. Uma linha de “outros” de qualquer tamanho significa que existe pelo menos uma causa ainda não encontrada, e ela costuma ser a maior.
3O Módulo 1 separou booking, faturamento e receita como três moedas diferentes. Qual das deduções desta reconciliação é exatamente essa distinção reaparecendo, e por que ela só vira erro quando os nomes se misturam?Módulo 1 · 1.2
A dedução de R$ 390 mil, dos contratos fechados em 2025 com vigência em 2026. Contar na data de fechamento não é errado: é a definição de booking. Vira erro no instante em que alguém chama esse total de ARR, porque aí duas moedas diferentes passam a disputar o mesmo nome e a mesma linha de slide.
4Escreva de memória as três declarações obrigatórias de uma métrica publicada e a regra sobre onde ela é definida no fluxo do dado.
Grão, filtro e janela. E a métrica se define no penúltimo passo, na camada semântica, nunca no último. Definida no painel, ela se multiplica pelo número de painéis, e cada cópia envelhece de um jeito diferente.