Cuentas de Cobro
Las cuentas de cobro (BillingAccount) representan la relación financiera entre una organización y su cliente. Cada cuenta posee suscripciones, facturas, pagos y métodos de pago.
Campos
| Campo | Descripción |
|---|---|
| Organización | Organización propietaria (obligatorio) |
| Persona | Cliente asociado (tipo=customer) |
| ID externo | Identificador para integraciones (único por organización) |
| Moneda | Moneda de cobro (predeterminado: BRL) |
| E-mail de cobro | E-mail para recibir facturas |
| Días de plazo | Plazo de pago en días (predeterminado: 10) |
| Auto-cobro | Si las facturas se cobran automáticamente |
| Saldo (centavos) | Saldo de créditos/débitos de la cuenta |
| Status | active, suspended o closed |
Configuración Fiscal
| Campo | Descripción |
|---|---|
| Exento de impuestos | Si el cliente está exento |
| Certificado de exención | Documento de exención |
| Tipo fiscal del cliente | Clasificación tributaria |
| Retener ISS | Flag de retención de ISS |
| Retener IRRF | Flag de retención de IRRF |
| Retener CSRF | Flag de retención de CSRF |
| Retener INSS | Flag de retención de INSS |
| Inscripción municipal | Número de inscripción municipal |
Status y Ciclo de Vida
active → suspended ↔ active
↓
closed
| Status | Descripción |
|---|---|
| active | Cuenta operacional |
| suspended | Suspendida por morosidad o manualmente. Suscripciones pausadas |
| closed | Cerrada permanentemente |
Suspensión
- Define
suspendedAtysuspensionReason - Todas las suscripciones activas son pausadas
- Notificación enviada al cliente
- Puede ser reactivada manualmente
Cierre
- Todas las suscripciones deben estar inactivas/canceladas
- Permanente (soft delete vía
deletedAt)
Unicidad
- Una cuenta de cobro por cliente por organización
- ID externo único por organización
- Documento del cliente único por organización
Estadísticas
El dashboard muestra contadores por status:
- Total de cuentas
- Cuentas activas
- Cuentas suspendidas
- Cuentas con suscripción activa