Pular para o conteúdo principal

Parcelamento

Faturas podem ser divididas em múltiplas parcelas com datas de vencimento individuais.

Estados da Parcela

scheduled → pending → paid

overdue

canceled
StatusDescrição
scheduledVencimento futuro, aguardando processamento
pendingVencimento chegou, aguardando pagamento
paidParcela paga
overdueVencida e não paga
canceledCancelada (fatura anulada)

Criando Parcelas

Ao criar ou editar uma fatura, informe as parcelas:

CampoDescrição
Valor (centavos)Montante da parcela
Data de vencimentoData 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:

  1. O worker busca parcelas com vencimento ≤ hoje
  2. Verifica se a parcela anterior está paga (ou se é a primeira)
  3. Para charge_automatically: cobra o método de pagamento padrão
  4. Vincula o pagamento à parcela
  5. 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 scheduled ou pending são canceladas
  • Parcelas já pagas não são afetadas