Prever o vencimento das parcelas geradas por uma ação programável

Uma ação programável pode gerar uma série de parcelas mensais no financeiro. Este artigo explica em que dia cada parcela vence, principalmente quando o primeiro vencimento cai no dia 29, 30 ou 31 e o mês seguinte não tem esse dia.

A regra

Ao somar meses a uma data, o sistema mantém o dia de origem quando ele existe no mês de destino. Quando não existe, usa o último dia desse mês.

Antes dessa correção, o dia “transbordava” para o mês seguinte: 31/01 + 1 mês virava 03/03, e o vencimento gravado no financeiro (tabela TBLFIN) saía dias depois do devido e no mês errado.

Data de origem	Meses somados	Vencimento
31/01	1	28/02
31/01 de um ano bissexto, como 2028	1	29/02
31/03	1	30/04
15/05	1	15/06
30/01	2	30/03

Datas cujo dia existe em todos os meses de destino não mudam. É o caso dos dias até 28 e dos exemplos de 15/05 e 30/01 acima.

Como a série de parcelas é calculada

A série parte sempre da data-base, não da parcela anterior. Por isso o dia original volta nos meses que o têm. Para um primeiro vencimento em 31/01, com 4 parcelas mensais:

Parcela	Vencimento
1	31/01
2	28/02
3	31/03
4	30/04

A parcela de fevereiro vence no fim do mês, mas a de março volta ao dia 31.

No passo de repetição de inclusão (LOOP_INSERT), o vencimento de cada parcela vai no campo PARCELA_DTVENC. Um vencimento em 10/04 gera a parcela seguinte em 10/05, e 01/05 gera 01/06.

Onde a regra vale

A mesma regra vale em dois pontos do executor de ações:

• o passo de repetição de inclusão (LOOP_INSERT), que gera as parcelas;
• a função DATE_ADD(..., 'MONTH'), usada nas expressões de uma ação.

O que não muda

• Só a unidade mês muda. Na frequência semanal (WEEK), o passo de repetição continua somando 7 dias: 10/04 gera 17/04.
• A hora da data é mantida, e a data original não é alterada: o cálculo trabalha sobre uma cópia.
• Mês fracionado é truncado. 1,9 mês vale 1 mês.
• Parcelas já geradas permanecem como estavam. A correção não reescreve nada que já foi gravado e só afeta execuções novas.

Quem é afetado

Quem usa ações programáveis que geram parcelas no financeiro com primeiro vencimento nos dias 29, 30 ou 31. Para as demais datas, o resultado é o mesmo de antes.

Para conferir

1. Execute uma ação que gera parcelas mensais com primeiro vencimento em 31/01.
2. Confira no financeiro: a segunda parcela vence em 28/02 (ou 29/02, em ano bissexto).

O que esta regra não cobre

O parcelamento de documentos por negociação (tipo de venda) não usa essa função. Nesse caso, o plano devolve o prazo em dias e a data é somada em dias corridos. Portanto, não espere o “último dia do mês” descrito acima nas parcelas de um documento parcelado por negociação.

Para conferir o que uma ação fez em cada execução, veja consultar o histórico de execuções de uma ação.