Métricas SaaS em tempo real, exportação multi-formato.
MRR, ARR, churn, ARPU, taxa de cobrança, cohorts. Dashboard executivo com filtros por período. Export CSV, Excel, PDF, OFX, JSON.
Funcionalidade
Real-time
métricas
6
formatos de export
∞
períodos customizáveis
Snapshots
diários e mensais
Indicadores SaaS calculados nativamente
MRR (Monthly Recurring Revenue)
Soma de mrrAmountCents de todas as billing accounts ativas. Calculado em tempo real e por snapshot mensal.
- Breakdown por plano
- Histórico mensal
- Comparativo com mês anterior
ARR (Annual Recurring Revenue)
MRR × 12 ou soma de assinaturas anuais.
- Para investidores e board
- Export CSV / PDF
Churn Rate
Assinaturas canceladas no período / assinaturas no início do período. Logo + revenue churn.
- Cancelamentos voluntários vs involuntários
- Razão de cancelamento agregada
- Cohort analysis
ARPU
Receita total / clientes ativos. Métrica de upgrade e cross-sell.
- Average Revenue Per User
- Upgrade e cross-sell tracking
Taxa de Cobrança
Faturas pagas no vencimento / faturas emitidas. Indicador da eficiência do dunning.
- Eficiência do dunning
- Comparativo histórico
LTV (em desenvolvimento)
ARPU / churn — valor médio do cliente.
- Customer Lifetime Value
- Em desenvolvimento
O que está disponível
Dashboard Executivo
Cards com KPIs (MRR, assinaturas ativas, taxa de cobrança, churn) + gráficos (receita mensal, distribuição por plano).
- Filtro de período (últimos 12 meses default)
- Comparativo com período anterior
- Auto-refresh
Cohort Analysis
Análise por cohort de cadastro. Receita retida por mês após onboarding.
- Heatmap de retenção
- Drilldown por plano
- Export para análise externa
Relatórios Fiscais
TaxPeriod consolida apuração mensal/trimestral por Company. Livro de serviços prestados, apuração por período.
- ISS apurado por município
- IRPJ + CSLL trimestrais
- DAS estimado (Simples)
- Formato compatível com contabilidades
Snapshots de Uso
UsageDailySnapshot + UsageMonthlySnapshot armazenam consumo agregado. Reduz custo de queries no dashboard.
- Calculado por worker
- Suporte a quantidade + custo
- Base para metered billing
Exportação Multi-Formato
ExportService cria Export records e dispara worker export. Resultado em S3 com link assinado.
- CSV (genérico)
- Excel XLSX (com formatação)
- PDF (relatórios formatados)
- OFX, JSON, ZIP
Agendamento de Relatórios
Reports recorrentes enviados por e-mail. Configurável por frequência (diário, semanal, mensal).
- Email automático
- Configurável por frequência
- Diário, semanal, mensal
Filtros Avançados
Combinação por status, plano, valor, período, tags. Save de views customizadas.
- Operadores AND/OR
- Range temporal flexível
- Export do filtro aplicado
AuditLog Consultável
Toda mutação registrada. Filtro por usuário, ação, resource, IP. Útil para compliance e troubleshooting.
- Previous + new values JSON
- Retenção configurável (default 2 anos)
- API para integração com SIEM
Agendar export via API
bash
curl -X POST https://api.billing.kobana.com.br/v1/exports \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"resource": "invoices",
"format": "xlsx",
"filters": {
"period_start": "2026-01-01",
"period_end": "2026-06-30",
"status": ["paid"]
}
}'response
{
"id": "exp_xyz",
"status": "processing",
"download_url": null,
"estimated_time_seconds": 30
}