Automação de Cobrança

Domine sistemas automatizados de cobrança, incluindo cobrança recorrente, geração de faturas, gerenciamento de inadimplência, prorata e cálculo de impostos.

Quando Usar Esta Habilidade

• Implementar cobrança de assinatura SaaS
• Automatizar a geração e entrega de faturas
• Gerenciar recuperação de pagamentos falhos (inadimplência)
• Calcular cobranças prorata para mudanças de plano
• Lidar com imposto sobre vendas, IVA e GST
• Processar cobrança baseada em uso
• Gerenciar ciclos de cobrança e renovações

Conceitos Principais

1. Ciclos de Cobrança

Intervalos Comuns:

• Mensal (mais comum para SaaS)
• Anual (desconto para longo prazo)
• Trimestral
• Semanal
• Personalizado (baseado em uso, por assento)

2. Estados da Assinatura

trial → active → past_due → canceled
              → paused → resumed

3. Gerenciamento de Inadimplência

Processo automatizado para recuperar pagamentos falhos através de:

• Agendamentos de novas tentativas
• Notificações ao cliente
• Períodos de carência
• Restrições de conta

4. Prorata

Ajuste de cobranças quando:

• Houver upgrade/downgrade no meio do ciclo
• Adicionar/remover assentos
• Alterar a frequência de cobrança

Início Rápido

from billing import BillingEngine, Subscription

# Initialize billing engine
billing = BillingEngine()

# Create subscription
subscription = billing.create_subscription(
    customer_id="cus_123",
    plan_id="plan_pro_monthly",
    billing_cycle_anchor=datetime.now(),
    trial_days=14
)

# Process billing cycle
billing.process_billing_cycle(subscription.id)

Padrões detalhados e exemplos práticos

A documentação detalhada dos padrões está em references/details.md. Leia este arquivo quando o nível de navegação acima for insuficiente.