Kobana

Conheça o Faturamento Automático por dentro

Explore os módulos da plataforma e descubra como automatizar todo o ciclo de cobrança recorrente da sua empresa.

Dashboard do Faturamento Automático

Dashboard

KPIs do billing em tempo real

Visão consolidada da operação de cobrança recorrente. Receita do mês, assinaturas ativas, faturas pendentes e atividade recente em uma única tela.

Receita do mês

Total recebido com comparativo do período anterior. Drilldown por plano ou empresa.

Assinaturas ativas

Contagem em tempo real com tendência. Filtros por status, ciclo e MRR.

Faturas pendentes

Pendentes de pagamento com taxa de inadimplência destacada.

Atividade recente

Últimos pagamentos, novas assinaturas, NFe emitidas e eventos relevantes.

Assinaturas

Ciclo de vida completo, com proration

7 estados (draft → confirmed → trialing → active → past_due → canceled / paused). Trial, upgrade/downgrade com proration, pausa e cancelamento agendado.

Ciclos de faturamento

Mensal, trimestral, semestral e anual. billing_cycle_anchor configurável por assinatura.

Proration nativo

Cálculo automático em upgrade/downgrade. Preview antes de confirmar.

Trial flexível

Com ou sem cartão. Worker trial-ending notifica antes do fim.

Pausa e retomada

pauseCollection JSON com razão e regra de retomada. Webhooks dedicados.

Faturas

Geradas automaticamente 24/7

Worker invoice-generation processa às 01:00 UTC todos os dias. PDF profissional, NFe vinculada, retenções aplicadas e link de pagamento prontos sem intervenção.

Estados (InvoiceStatus)

draft → open → paid | void | uncollectible. Cada transição em AuditLog.

Composição automática

subtotal + tax − discount = total. Retenções subtraídas do netValueCents.

PDF + email

Renderizado server-side. Template + EmailLayout por empresa. AWS SES.

Lembretes pré-vencimento

Régua −7, −3, −1 e dia do vencimento. Email, in-app, webhook.

Pagamentos

Métodos, gateways e retry automático

Cartão (Pagar.me), boleto e PIX (Kobana Gateway Bancário), bank transfer. Idempotency-Key em toda mutação. Worker payment-retry reprocessa falhas a cada 6 horas.

Gateways integrados

Pagar.me, Kobana Gateway Bancário, Mock para sandbox. Default por método via flag.

Dunning configurável

DunningConfig: maxRetries (5), retryIntervalDays ([1,2,3,5,7]), gracePeriodDays (30).

Webhooks assinados

Callbacks dos gateways processados com idempotência. Worker callback dedicado.

Reembolso via API

Total ou parcial. Status muda para refunded ou partially_refunded.

Clientes

Hierarquia em 3 camadas

Customer → BillingAccount → PortalUser. Cliente pode ter várias contas de faturamento (filiais, departamentos). Multi-usuário no portal com permissões granulares.

Cadastro completo

PF ou PJ, endereço (CEP, IBGE), múltiplos contatos. Validação de CPF/CNPJ.

Multi-conta

Cada BillingAccount com método de pagamento, ciclo fiscal e portal próprios.

Portal multi-usuário

Convite por e-mail (PortalInvitation, expira em 7 dias). 2FA opcional.

LGPD nativo

DataPurgeService para direito ao esquecimento. Export completo em ZIP.

Planos e Produtos

Catálogo flexível em 4 níveis

Product → Price → Plan → Subscription. Múltiplos preços por produto (ciclo, moeda, scheme). Addons fixos ou metered. Cupons percentage/fixed e sistema de créditos.

Tipos de produto

base, addon_fixed, addon_quantity, metered. ServiceItem para tributação correta.

BillingScheme avançado

per_unit, tiered, volume, package. Tiers JSON com graduated ou volume.

Cupons e créditos

Coupon com limites e validade. Credit promotional/adjustment/refund/manual.

Mudança de plano

PlanChangeRule por par origem → destino com proration e bonus.

NFe e Fiscal

Fiscal brasileiro nativo

NFS-e via NFe.io ou provider próprio. 4 regimes (Simples, Lucro Presumido, Lucro Real, MEI). Motor tributário com 8 tipos de tributo. RBT12 + Fator R para Simples.

Política de emissão

disabled, on_finalization, on_full_payment, per_installment.

Retenções automáticas

IRRF, CSRF (PIS+COFINS+CSLL), INSS, ISS retido. Calculadas por TaxRule.

Certificado A1

PFX/PEM criptografado com AES-256-GCM. Alerta 30 dias antes do vencimento.

Retry inteligente

Worker nfe-retry (30min). NfeRequestTry tracks cada tentativa com payload + response.

Analytics

Métricas SaaS em tempo real

MRR, ARR, churn, ARPU, taxa de cobrança e cohort analysis. Snapshots diários e mensais via worker. Export em CSV, Excel, PDF, OFX e JSON.

Dashboard executivo

KPIs com filtro de período. Comparativo automático com período anterior.

Cohort analysis

Receita retida por cohort de cadastro. Heatmap de retenção.

Relatórios fiscais

TaxPeriod por Company. ISS por município, IRPJ + CSLL trimestrais, DAS estimado.

Export multi-formato

Worker export processa em background. URL assinada com expiração.

Automação e Dunning

Workers rodando 24/7

18 jobs agendados via cron. Dunning com 5 retentativas, alerta de cartão expirando, expiração de proposta, suspensão automática e mais.

subscription-renewal

Diário 00:00 UTC. Renova assinaturas no fim do ciclo respeitando commitment.

invoice-generation

Diário 01:00 UTC. Gera faturas idempotentes para todas as subscriptions no ciclo.

payment-retry

A cada 6 horas. Reprocessa pagamentos failed conforme DunningConfig.

card-expiring

Semanal segunda 10:00 UTC. Detecta cartões em ≤ 30 dias e notifica cliente.

API + Webhooks

API REST com HMAC assinado

3 ambientes isolados (production, staging, sandbox). Idempotency-Key nativo. Rate limiting separado para GET e mutation. SDKs Node/Python/Ruby em desenvolvimento.

REST API completa

643 endpoints com versionamento /v1. JSON padronizado e paginação cursor + offset.

Webhooks HMAC-SHA256

WebhookEndpoint com events array. WebhookDelivery com retry exponencial até 5 tentativas.

API keys com escopo

Permissões granulares. Rate limit por key. Revogação imediata. Last used trackeado.

Sandbox completo

Cartões de teste pré-definidos. Mock gateway simula recusas. Mesma API de produção.

Continue explorando

Agora que você conhece a plataforma, agende uma demonstração personalizada ou explore as funcionalidades em detalhe.

Fale com um especialista

Agende uma conversa com nosso time e tire todas as suas dúvidas.

Agendar demonstração
Ver funcionalidades

Explore cada módulo em detalhe: assinaturas, faturas, fiscal e mais.

Ver funcionalidades
Documentação técnica

Para desenvolvedores: API REST, webhooks, SDKs e ambiente sandbox.

Ver documentação

Pronto para automatizar seu faturamento recorrente?

Agende uma demonstração e veja o Faturamento Automático funcionando para seu caso de uso.