Contas de Cobrança
Contas de cobrança (BillingAccount) representam o relacionamento financeiro entre uma organização e seu cliente. Cada conta possui assinaturas, faturas, pagamentos e métodos de pagamento.
Campos
| Campo | Descrição |
|---|---|
| Organização | Organização proprietária (obrigatório) |
| Pessoa | Cliente associado (tipo=customer) |
| ID externo | Identificador para integrações (único por organização) |
| Moeda | Moeda de cobrança (padrão: BRL) |
| E-mail de cobrança | E-mail para receber faturas |
| Dias de prazo | Prazo de pagamento em dias (padrão: 10) |
| Auto-cobrança | Se faturas são cobradas automaticamente |
| Saldo (centavos) | Saldo de créditos/débitos da conta |
| Status | active, suspended ou closed |
Configuração Fiscal
| Campo | Descrição |
|---|---|
| Isento de impostos | Se o cliente é isento |
| Certificado de isenção | Documento de isenção |
| Tipo fiscal do cliente | Classificação tributária |
| Reter ISS | Flag de retenção de ISS |
| Reter IRRF | Flag de retenção de IRRF |
| Reter CSRF | Flag de retenção de CSRF |
| Reter INSS | Flag de retenção de INSS |
| Inscrição municipal | Número de inscrição municipal |
Status e Ciclo de Vida
active → suspended ↔ active
↓
closed
| Status | Descrição |
|---|---|
| active | Conta operacional |
| suspended | Suspensa por inadimplência ou manualmente. Assinaturas pausadas |
| closed | Encerrada permanentemente |
Suspensão
- Define
suspendedAtesuspensionReason - Todas as assinaturas ativas são pausadas
- Notificação enviada ao cliente
- Pode ser reativada manualmente
Encerramento
- Todas as assinaturas devem estar inativas/canceladas
- Permanente (soft delete via
deletedAt)
Unicidade
- Uma conta de cobrança por cliente por organização
- ID externo único por organização
- Documento do cliente único por organização
Estatísticas
O dashboard exibe contadores por status:
- Total de contas
- Contas ativas
- Contas suspensas
- Contas com assinatura ativa