API EasyJur — Receita Estipulada

Respostas diretas pro JV

Evolução desde o 1º snapshot (20/05 → 08/06)

Em 19 dias a operação saiu da fase de trial e entrou em regime de cobrança. Os trials das coortes A/B/C venceram e a maior parte converteu — daí o salto em ativos e MRR. O uso real explodiu na 1ª semana de junho.

Resumo financeiro

Firme = quem já passou do trial e está pagando. Trial projetado = teto se 100% dos em_periodo_teste converterem (só restam 9 em trial — leitura quase fechada). Perdido = MRR que saiu via cancelamento desde o lançamento. Todos os números vêm de tb_aditivos_api_easyjur × tb_api_pacotes.

Funil de aceite (modal de ativação)

Dos 368 escritórios elegíveis (registrados em tb_aditivos_api_easyjur_elegiveis), 122 aceitaram o modal, 241 recusaram e 5 ainda não responderam. Total de aditivos é 140 — diferença de 18 corresponde a provisionamentos manuais (incluindo EasyJur Interna id=1).

verde aceitos · vermelho recusados · cinza pending. Atenção: coorte A concentra ~78% da base elegível e tem o pior aceite (17,5%). Se rolarmos pra base toda no formato de A, a adesão deve cair de 33% pra ~17-22%. As coortes B/C/D são amostras menores e mais qualificadas — não extrapolar o aceite alto delas pra base inteira.

Uso real da API (Elasticsearch · api_easyjur_requests)

Foram 159.647 chamadas de 41 escritórios distintos entre 04/05 e 08/06. Dos 140 que ativaram, 41 (29%) usaram de fato — o restante ativou e ainda não chamou. O uso saltou na 1ª semana de junho: maio inteiro somou 30.114 chamadas; só os 8 primeiros dias de junho somaram 129.533 (4,3× o mês anterior).

Distribuição diária

Quebra do padrão semanal a partir de 05/06: o volume passou a subir inclusive no fim de semana (06 e 07/06 são sáb/dom e bateram os picos). Isso é consistente com integração automatizada (jobs/cron de cliente), não uso manual — provavelmente a Lorene Ribeiro, que sozinha responde por 70% do volume.

Quem usou de fato (41 escritórios)

Top 3 concentram 134.165 chamadas (84% do volume total). 11 escritórios fizeram menos de 100 reqs — claros casos de "ativou pra testar e parou". Cauda longa típica: poucos heavy users sustentam o consumo, a maioria está só explorando.

Queries SQL prontas — rodar direto no banco

Cada query abaixo gera exatamente uma das tabelas/cards deste relatório no banco advogados_iturn. Toda contratação da API mora em tb_aditivos_api_easyjur (1 linha por escritório, id_empresa UNIQUE). O preço cobrado vem do pacote vinculado via id_pacote → tb_api_pacotes.preco_centavos. Todas são read-only — só SELECT.

1) Respostas pro JV (KPIs num único SELECT)

Reproduz os 6 cards do topo deste relatório. Roda em ~50ms.

SELECT
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur_elegiveis)                                            AS elegiveis_total,
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur_elegiveis WHERE status_aceite='acknowledged')         AS aceitos_modal,
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur)                                                      AS aditivos_total,
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur WHERE status_api='em_periodo_teste')                  AS em_trial,
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur WHERE status_api='ativo')                             AS ativos,
  (SELECT COUNT(*) FROM tb_aditivos_api_easyjur WHERE status_api='cancelado')                         AS cancelados,
  (SELECT COALESCE(SUM(p.preco_centavos),0)/100
     FROM tb_aditivos_api_easyjur a JOIN tb_api_pacotes p ON p.id=a.id_pacote
     WHERE a.status_api='ativo')                                                                       AS mrr_firme_reais,
  (SELECT COALESCE(SUM(p.preco_centavos),0)/100
     FROM tb_aditivos_api_easyjur a JOIN tb_api_pacotes p ON p.id=a.id_pacote
     WHERE a.status_api='em_periodo_teste')                                                            AS mrr_trial_projetado_reais,
  (SELECT COALESCE(SUM(p.preco_centavos),0)/100
     FROM tb_aditivos_api_easyjur a JOIN tb_api_pacotes p ON p.id=a.id_pacote
     WHERE a.status_api='cancelado')                                                                   AS mrr_perdido_reais,
  ROUND(100 *
    (SELECT COUNT(*) FROM tb_aditivos_api_easyjur_elegiveis WHERE status_aceite='acknowledged')
    /
    (SELECT COUNT(*) FROM tb_aditivos_api_easyjur_elegiveis)
  ,1)                                                                                                  AS pct_adesao;

2) Estado por status × tier (linhas das 3 tabelas ATIVO / TRIAL / CANCELADO)

SELECT
  a.status_api,
  a.tier,
  COUNT(*)                              AS contratos,
  COALESCE(SUM(p.preco_centavos),0)/100 AS mrr_reais,
  COALESCE(SUM(p.creditos),0)           AS reqs_inclusas_total
FROM tb_aditivos_api_easyjur a
LEFT JOIN tb_api_pacotes p ON p.id = a.id_pacote
GROUP BY a.status_api, a.tier
ORDER BY FIELD(a.status_api,'ativo','em_periodo_teste','cancelado'),
         FIELD(a.tier,'starter','lite','plus','pro','business','scale','enterprise');

3) Funil de aceite por coorte (tabela “Funil de aceite”)

SELECT
  e.coorte,
  COUNT(*)                                                                              AS elegiveis,
  SUM(CASE WHEN e.status_aceite='acknowledged' THEN 1 ELSE 0 END)                       AS aceitos,
  SUM(CASE WHEN e.status_aceite='declined'     THEN 1 ELSE 0 END)                       AS recusados,
  SUM(CASE WHEN e.status_aceite='pending'      THEN 1 ELSE 0 END)                       AS pending,
  ROUND(100 * SUM(CASE WHEN e.status_aceite='acknowledged' THEN 1 ELSE 0 END) / COUNT(*), 1) AS pct_aceite
FROM tb_aditivos_api_easyjur_elegiveis e
GROUP BY e.coorte
WITH ROLLUP;

4) Recorte financeiro por coorte (A/B test)

SELECT
  IFNULL(a.coorte,'(sem coorte)') AS coorte,
  SUM(CASE WHEN a.status_api='em_periodo_teste' THEN 1 ELSE 0 END) AS em_trial,
  SUM(CASE WHEN a.status_api='ativo'            THEN 1 ELSE 0 END) AS ativos,
  SUM(CASE WHEN a.status_api='cancelado'        THEN 1 ELSE 0 END) AS cancelados,
  COUNT(*)                                                          AS total,
  COALESCE(SUM(CASE WHEN a.status_api='ativo'                          THEN p.preco_centavos END),0)/100 AS mrr_firme_reais,
  COALESCE(SUM(CASE WHEN a.status_api IN ('ativo','em_periodo_teste')  THEN p.preco_centavos END),0)/100 AS mrr_projetado_reais
FROM tb_aditivos_api_easyjur a
LEFT JOIN tb_api_pacotes p ON p.id = a.id_pacote
GROUP BY a.coorte
WITH ROLLUP;

5) Tier mais aceito (recorte por tier_sugerido)

SELECT
  e.tier_sugerido,
  p.preco_centavos/100                                                                  AS preco_reais,
  COUNT(*)                                                                              AS elegiveis,
  SUM(CASE WHEN e.status_aceite='acknowledged' THEN 1 ELSE 0 END)                       AS aceitos,
  SUM(CASE WHEN e.status_aceite='declined'     THEN 1 ELSE 0 END)                       AS recusados,
  SUM(CASE WHEN e.status_aceite='pending'      THEN 1 ELSE 0 END)                       AS pending,
  ROUND(100 * SUM(CASE WHEN e.status_aceite='acknowledged' THEN 1 ELSE 0 END) / COUNT(*), 1) AS pct_aceite
FROM tb_aditivos_api_easyjur_elegiveis e
LEFT JOIN tb_api_pacotes p ON p.id = e.id_pacote_sugerido
GROUP BY e.tier_sugerido, p.preco_centavos
ORDER BY FIELD(e.tier_sugerido,'starter','lite','plus','pro','business','scale','enterprise');

6) Pacotes vigentes (snapshot do catálogo)

SELECT
  slug,
  preco_centavos/100                                  AS preco_reais,
  creditos                                            AS reqs_mes_inclusas,
  ROUND(preco_centavos / 100 / (creditos/1000), 2)    AS reais_por_1k_reqs,
  ativo
FROM tb_api_pacotes
ORDER BY ordem;

7) Lista nominal — quem está em cada status (export pro CS)

SELECT
  a.id_empresa,
  ea.nome                                               AS escritorio,
  a.tier,
  a.coorte,
  a.status_api,
  p.preco_centavos/100                                  AS mensalidade_reais,
  DATE(a.data_inicio_trial)                             AS dt_inicio_trial,
  DATE(a.data_fim_trial)                                AS dt_fim_trial,
  DATE(a.data_proxima_cobranca)                         AS dt_proxima_cobranca,
  DATE(a.data_cancelamento)                             AS dt_cancelamento
FROM tb_aditivos_api_easyjur a
LEFT JOIN tb_api_pacotes p          ON p.id = a.id_pacote
LEFT JOIN tb_escritorio_advogados ea ON ea.id = a.id_empresa
ORDER BY FIELD(a.status_api,'ativo','em_periodo_teste','cancelado'),
         p.preco_centavos DESC,
         a.id_empresa;

8) ARR projetado e ticket médio (KPIs de boardroom)

SELECT
  COUNT(*)                                                                                          AS contratos_vigentes,
  COALESCE(SUM(p.preco_centavos),0)/100                                                             AS mrr_reais,
  COALESCE(SUM(p.preco_centavos),0)/100 * 12                                                        AS arr_reais,
  ROUND(AVG(p.preco_centavos)/100, 2)                                                               AS ticket_medio_reais
FROM tb_aditivos_api_easyjur a
JOIN tb_api_pacotes p ON p.id = a.id_pacote
WHERE a.status_api IN ('ativo','em_periodo_teste');   -- troca pra ='ativo' se quiser MRR/ARR firme

9) Cancelamentos por tier (pra investigação com CS)

SELECT
  a.tier,
  COUNT(*)                                       AS cancelamentos,
  COALESCE(SUM(p.preco_centavos),0)/100          AS mrr_perdido_reais,
  GROUP_CONCAT(a.id_empresa ORDER BY a.id_empresa) AS empresas_canceladas
FROM tb_aditivos_api_easyjur a
LEFT JOIN tb_api_pacotes p ON p.id = a.id_pacote
WHERE a.status_api = 'cancelado'
GROUP BY a.tier
ORDER BY mrr_perdido_reais DESC;

Uso real (ES — não tem SQL equivalente)

A contagem de chamadas reais à API vive em Elasticsearch (índice api_easyjur_requests em elastic.easyjur.com, populado pelo quota_service.track_request()). Pra refresh use GET api_easyjur_requests/_search com agg cardinality sobre id_empresa + agg date_histogram sobre @timestamp. Dashboard pronto: ~/claude/api-launch-v1/kibana-dashboard-api-easyjur.ndjson.

Estado atual — breakdown por status × tier

ATIVO   MRR firme · R$ 13.340 / 97 contratos

EM PERÍODO DE TESTE   MRR projetado · R$ 1.710 / 9 contratos

CANCELADO   MRR perdido · R$ 8.110 / 34 contratos

8 cancelamentos de enterprise (R$ 700/mês) puxam o MRR perdido pra cima — sozinhos representam R$ 5.600/mês (69% do total perdido). Padrão se mantém desde 20/05: o churn é caro porque concentra no topo da tabela de preços. Vale priorizar entrevistas de CS com esses 8.

Recorte financeiro por coorte (A/B test de duração de trial)

Coorte C (trial 30d) é a grande vencedora do A/B: 100% de aceite no funil e 24 de 26 já em cobrança, só 1 cancelamento (~96% retenção). Trials longos converteram muito melhor. Coorte A (7d) fechou em 39 ativos vs 11 cancelados = ~78% retenção entre quem chegou ao fim do trial — pior que C/B, mas é a coorte de massa (54 aditivos). Coorte B (14d): 16 ativos vs 6 cancelados = ~73%. Coorte D (opt-in manual) segue sendo o desastre previsto: 16 de 20 cancelaram (80%) — sem cobrança automática, quase ninguém renova ativamente. Recomendação: não usar o formato D no rollout.

Tier mais aceito — recorte detalhado

Calculado em cima de tb_aditivos_api_easyjur_elegiveis agrupado por tier_sugerido e status_aceite. "Aceito" significa que o admin clicou no modal de ativação (status passa pra acknowledged e cria o aditivo em trial).

Em volume absoluto: starter (25) e plus (21). São tiers com base elegível grande. Em pct de aceite: enterprise (66,7%), scale (42,9%) e pro (41,7%). Clientes maiores têm muito mais propensão a aceitar — o ticket da API é pequeno relativo ao plano deles. Insight comercial: o pitch pode ser mais agressivo no topo da curva, onde a conversão é o dobro da base.

Pacotes vigentes em produção

Snapshot de tb_api_pacotes em 2026-06-08.

Caveats & leituras pra reunião

• A leitura financeira já está quase consolidada. Sobram só 9 contratos em trial (vs 46 em 20/05) — o MRR firme de R$ 13.340 é praticamente o número real, não mais uma projeção otimista. As coortes A/B/C todas venceram o trial.
• Coorte C (30d) ganhou o A/B test. 100% de aceite e ~96% de retenção pós-trial. Trial longo converteu melhor que 7d (A: 78%) e 14d (B: 73%). Recomendação: trial mais longo no rollout.
• Coorte D (opt-in manual) é pra descartar. 80% cancelaram. Sem cobrança automática, o cliente simplesmente não renova ativamente.
• "Ativou" ≠ "usou". 140 ativaram, só 41 (29%) chegaram a chamar a API. Os outros 99 estão pagando (ou pagaram) sem usar — risco de churn por inércia. Melhorou um pouco vs 20,5% de 20/05, mas ainda é o maior ponto de atenção de retenção.
• Uso hiperconcentrado. 1 cliente (Lorene Ribeiro) faz 70% do volume; top 3 fazem 84%. Se a Lorene parar/cancelar, o gráfico de uso da API despenca — mas o MRR não, porque o tier dela é R$ 250. Receita e uso estão desacoplados.
• Churn caro no enterprise. 8 cancelamentos × R$ 700 = R$ 5.600/mês (69% do MRR perdido). Antes do rollout pra base toda, entrevistar esses 8 — foi preço, expectativa de uso ou "testei e não preciso".
• Cotas foram 10×. O novo catálogo dá muito mais reqs pelo mesmo preço. Os 106 contratos vigentes somam ~9,5 milhões de reqs/mês de cota incluída; o uso de junho projeta ~0,5M/mês (~5%). Ninguém está perto do teto — upgrade por estouro de cota não vai acontecer tão cedo. A monetização vem de novos contratos, não de overage.
• Snapshot 2026-06-08. Financeiro via SQL em advogados_iturn (live); uso real via ES api_easyjur_requests (live). Coorte A ainda concentra ~78% da base elegível com aceite de 17,5% — é o número a usar pra projetar o rollout, não a média de 33,2%.