Ajustar número de parcelas de uma recorrência (estender ou reduzir)

Permite ajustar o número total de parcelas ativas de uma recorrência existente, estendendo ou reduzindo.

Estender recorrência (aumentar parcelas):

  • Informe um valor de NovoNumeroDeParcelas maior que o número atual de parcelas ativas.
  • Parcelas inativas da recorrência são reativadas primeiro, das mais antigas para as mais novas, inclusive as inativadas manualmente.
  • Se ainda faltar, são criadas parcelas novas depois da última parcela ativa, não pagas, com valor, categoria e descrição da primeira parcela.

Reduzir recorrência (diminuir parcelas):

  • Informe um valor de NovoNumeroDeParcelas menor que o número atual de parcelas ativas.
  • O sistema inativa parcelas futuras (DataVencimento > hoje), das mais distantes para as mais próximas, mesmo se estiverem marcadas como pagas. Elas podem voltar pela rota de reativação.
  • Se não houver parcelas futuras suficientes, a requisição é recusada (400).

Limites:

  • Mensalmente: Máximo 12 parcelas
  • Quinzenalmente: Máximo 24 parcelas
  • Semanalmente: Máximo 52 parcelas
  • Duração total: Não pode ultrapassar 365 dias
  • Mínimo: 2 parcelas (recorrências com menos de 2 parcelas não fazem sentido)

Validações:

  • NovoNumeroDeParcelas deve respeitar os limites do tipo de recorrência.
  • Recorrência inexistente ou inativa responde 400.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
Body Params
int32
required
2 to 52

Novo total de parcelas ativas, mínimo 2 (Mensalmente: até 12, Quinzenalmente: até 24, Semanalmente: até 52). A duração total não pode ultrapassar 365 dias.

Headers
string
required
Responses
204

Sucesso, sem corpo

Errors

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json