Receita e carteira da agência

Cliente ativo pagante = status ativo e tipo de contrato recorrente (fee), excluindo projeto pontual, isento e a conta da própria agência. A carteira vigente é mais ampla: ativo, onboarding e pausado. A pergunta 'quantos clientes temos' responde a definição estrita; a ampla sai sempre com o nome dela. Atraso de pagamento não muda o status do cliente: é assunto do financeiro.

MRR é só fee mensal recorrente. Projeto pontual, setup e treinamento ficam fora; quando for preciso compará-los, entram como média móvel de 12 meses dividida por 12, numa coluna à parte, nunca somada ao MRR. Verba de mídia repassada e produção de terceiros por conta e ordem não são receita da agência; comissão de mídia é.

Some o valor da parcela de cada competência, nunca o valor total do contrato nem o campo de valor do cabeçalho repetido em cada linha. Contrato semestral ou anual entra dividido pelos meses do ciclo. Contrato sem valor mensal preenchido aparece contado, para ninguém ler o MRR como completo.

Compare o MRR recorrente do cliente no mês com o do mês anterior. Sem MRR antes e com agora: novo, ou reativação se já pagou algum dia. Com antes e sem agora: churn. Maior: expansão. Menor e maior que zero: contração. Na planilha de churn das agências, 'churn parcial' é contração e 'troca de escopo' não é churn: o cliente continua.

Um cliente marcado como churn ainda era cliente no mês de referência se a data de saída é igual ou posterior ao início desse mês. Precedência da data: data de churn, depois fim de contrato, depois data da mudança de status. Sem nenhuma data, mantenha o cliente. Contrato ativo vai até o mês corrente; não projete o futuro como realizado.

A nota sai com a razão social e o contrato com o nome comercial. Case pelo CNPJ do destinatário; quando só houver nome, normalize (minúsculas, sem acento, só letras e números) e mantenha uma tabela de apelidos para grupos com vários CNPJs. Publique a lista dos dois lados que não casaram: nota sem contrato e contrato ativo sem nota. Numa base real, o resíduo ficou perto de 4% do faturamento de 12 meses.

Use notas com status faturado, não canceladas e com valor acima de R$ 1, para tirar notas de teste. Exclua os CNPJs do próprio grupo (intercompany). Quando a agência é cliente de outra empresa do grupo, separe a linha sem apagar.

Contratos e cobranças recorrentes são gerados até o fim da vigência, às vezes mais de um ano à frente. Marque a linha de mês futuro em vez de cortar, e filtre na leitura. Somar a tabela inteira soma agenda com entrega.

O cadastro guarda só o valor atual e sobrescreve quando o escopo muda. Grave uma foto mensal do MRR por cliente ou leia o histórico de ajustes. Quando o MRR cai e a contagem de clientes não muda, confira o histórico antes de chamar de churn: costuma ser correção de cadastro.

Conte o mês de vida do cliente a partir do primeiro mês com MRR recorrente. Meses 1 a 3 são onboarding, 4 a 12 primeiro ano, 13 em diante renovado. Contrato sem data de início usa o primeiro contrato do cliente.