Parcelamento
Faturas podem ser divididas em múltiplas parcelas com datas de vencimento individuais.
Estados da Parcela
scheduled → pending → paid
↓
overdue
↓
canceled
| Status | Descrição |
|---|---|
| scheduled | Vencimento futuro, aguardando processamento |
| pending | Vencimento chegou, aguardando pagamento |
| paid | Parcela paga |
| overdue | Vencida e não paga |
| canceled | Cancelada (fatura anulada) |
Criando Parcelas
Ao criar ou editar uma fatura, informe as parcelas:
| Campo | Descrição |
|---|---|
| Valor (centavos) | Montante da parcela |
| Data de vencimento | Data de pagamento esperada |
Regras de Validação
- Mínimo de 2 parcelas
- As datas devem ser estritamente crescentes
- A soma dos valores deve ser igual ao total da fatura
- A data de vencimento da fatura é definida como a data da última parcela
Cobrança de Parcelas
Processamento Sequencial
Parcelas são processadas sequencialmente — cada parcela só é cobrada quando a anterior está paga:
- O worker busca parcelas com vencimento ≤ hoje
- Verifica se a parcela anterior está paga (ou se é a primeira)
- Para
charge_automatically: cobra o método de pagamento padrão - Vincula o pagamento à parcela
- Se for a última parcela: fatura marcada como
paid
Política de NF-e por Parcela
Quando a política de NF-e é per_installment, uma nota fiscal é emitida para cada parcela paga individualmente.
Cancelamento
Quando a fatura é anulada:
- Todas as parcelas com status
scheduledoupendingsão canceladas - Parcelas já pagas não são afetadas