Kobana

Conoce la Facturación Automática por dentro

Explora los módulos de la plataforma y descubre cómo automatizar todo el ciclo de cobro recurrente de tu empresa.

Dashboard de la Facturación Automática

Dashboard

KPIs de billing en tiempo real

Visión consolidada de la operación de cobro recurrente. Ingresos del mes, suscripciones activas, facturas pendientes y actividad reciente en una única pantalla.

Ingresos del mes

Total recibido con comparativo del período anterior. Drilldown por plan o empresa.

Suscripciones activas

Conteo en tiempo real con tendencia. Filtros por estado, ciclo y MRR.

Facturas pendientes

Pendientes de pago con tasa de morosidad destacada.

Actividad reciente

Últimos pagos, nuevas suscripciones, NFe emitidas y eventos relevantes.

Suscripciones

Ciclo de vida completo con prorrateo

7 estados (draft → confirmed → trialing → active → past_due → canceled / paused). Trial, upgrade/downgrade con prorrateo, pausa y cancelación programada.

Ciclos de facturación

Mensual, trimestral, semestral y anual. billing_cycle_anchor configurable por suscripción.

Prorrateo nativo

Cálculo automático en upgrade/downgrade. Vista previa antes de confirmar.

Trial flexible

Con o sin tarjeta. Worker trial-ending notifica antes del fin del período.

Pausa y reanudación

pauseCollection con razón y regla de reanudación. Webhooks dedicados.

Facturas

Generadas automáticamente 24/7

Worker invoice-generation procesa a las 01:00 UTC todos los días. PDF profesional, NFe vinculada, retenciones aplicadas y link de pago listos sin intervención.

Estados (InvoiceStatus)

draft → open → paid | void | uncollectible. Cada transición en AuditLog.

Composición automática

subtotal + impuesto − descuento = total. Retenciones sustraídas del netValueCents.

PDF + email

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

Recordatorios pre-vencimiento

Régua −7, −3, −1 y día del vencimiento. Email, in-app, webhook.

Pagos

Métodos, gateways y retry automático

Tarjeta (Pagar.me), boleto y PIX (Kobana Gateway Bancário), transferencia bancaria. Idempotency-Key en toda mutación. Worker payment-retry reprocesa fallos cada 6 horas.

Gateways integrados

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

Dunning configurable

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

Webhooks firmados

Callbacks de los gateways procesados con idempotencia. Worker callback dedicado.

Reembolso via API

Total o parcial. Estado cambia a refunded o partially_refunded.

Clientes

Jerarquía en 3 capas

Customer → BillingAccount → PortalUser. El cliente puede tener varias cuentas de facturación (filiales, departamentos). Multi-usuario en el portal con permisos granulares.

Registro completo

PF o PJ, dirección (CEP, IBGE), múltiples contactos. Validación de CPF/CNPJ.

Multi-cuenta

Cada BillingAccount con método de pago, ciclo fiscal y portal propios.

Portal multi-usuario

Invitación por email (PortalInvitation, expira en 7 días). 2FA opcional.

LGPD nativo

DataPurgeService para derecho al olvido. Export completo en ZIP.

Planes y Productos

Catálogo flexible en 4 niveles

Product → Price → Plan → Subscription. Múltiples precios por producto (ciclo, moneda, scheme). Addons fijos o metered. Cupones percentage/fixed y sistema de créditos.

Tipos de producto

base, addon_fixed, addon_quantity, metered. ServiceItem para tributación correcta.

BillingScheme avanzado

per_unit, tiered, volume, package. Tiers JSON con graduated o volume.

Cupones y créditos

Coupon con límites y validez. Credit promotional/adjustment/refund/manual.

Cambio de plan

PlanChangeRule por par origen → destino con prorrateo y bonus.

NFe y Fiscal

Fiscal brasileño nativo

NFS-e vía NFe.io o provider propio. 4 regímenes (Simples, Lucro Presumido, Lucro Real, MEI). Motor tributario con 8 tipos de tributo. RBT12 + Factor R para Simples.

Política de emisión

disabled, on_finalization, on_full_payment, per_installment.

Retenciones automáticas

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

Certificado A1

PFX/PEM cifrado con AES-256-GCM. Alerta 30 días antes del vencimiento.

Retry inteligente

Worker nfe-retry (30min). NfeRequestTry registra cada intento con payload + response.

Analytics

Métricas SaaS en tiempo real

MRR, ARR, churn, ARPU, tasa de cobro y cohort analysis. Snapshots diarios y mensuales vía worker. Export en CSV, Excel, PDF, OFX y JSON.

Dashboard ejecutivo

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

Cohort analysis

Ingresos retenidos por cohort de registro. Heatmap de retención.

Informes fiscales

TaxPeriod por Company. ISS por municipio, IRPJ + CSLL trimestrales, DAS estimado.

Export multi-formato

Worker export procesa en background. URL firmada con expiración.

Automatización y Dunning

Workers ejecutando 24/7

18 jobs programados vía cron. Dunning con 5 reintentos, alerta de tarjeta por vencer, expiración de propuesta, suspensión automática y más.

subscription-renewal

Diario 00:00 UTC. Renueva suscripciones al fin del ciclo respetando commitment.

invoice-generation

Diario 01:00 UTC. Genera facturas idempotentes para todas las subscriptions en ciclo.

payment-retry

Cada 6 horas. Reprocesa pagos failed conforme DunningConfig.

card-expiring

Semanal lunes 10:00 UTC. Detecta tarjetas en ≤ 30 días y notifica al cliente.

API + Webhooks

API REST con HMAC firmado

3 ambientes aislados (production, staging, sandbox). Idempotency-Key nativo. Rate limiting separado para GET y mutation. SDKs Node/Python/Ruby en desarrollo.

REST API completa

643 endpoints con versionado /v1. JSON estandarizado y paginación cursor + offset.

Webhooks HMAC-SHA256

WebhookEndpoint con events array. WebhookDelivery con retry exponencial hasta 5 intentos.

API keys con scope

Permisos granulares. Rate limit por key. Revocación inmediata. Last used trackeado.

Sandbox completo

Tarjetas de prueba predefinidas. Mock gateway simula rechazos. Misma API de producción.

Continúa explorando

Agenda una demostración personalizada o explora las funcionalidades en detalle.

Habla con un especialista

Agenda una charla con nuestro equipo y resuelve todas tus dudas.

Agendar demostración
Ver funcionalidades

Explora cada módulo en detalle: suscripciones, facturas, fiscal y más.

Ver funcionalidades
Documentación técnica

Para desarrolladores: API REST, webhooks, SDKs y ambiente sandbox.

Ver documentación

¿Listo para automatizar tu facturación recurrente?

Agenda una demostración y ve la Facturación Automática funcionando para tu caso de uso.