Simulação de Acordos/Renegociações (Desconto tipo “Parcelamento”) — Segunda Etapa

A segunda etapa da simulação tem como objetivo:

• calcular os valores da negociação para uma opção específica de parcelamento;
• retornar os descontos sugeridos para cada parcela da dívida;
• gerar o fluxo completo do parcelamento escolhido.

Ela só pode ser executada após a primeira etapa, que fornece:

• parcelas disponíveis;
• opções de parcelamento;
• regras da negociação.

Parâmetros obrigatórios

Além de:

• cliente
• negociacao
• meioPagamento

também devem ser informados:

parcelas

Lista das parcelas de dívida selecionadas para negociação.

• Basta enviar o ID da parcela no atributo parcela.

parcelamento

Deve ser enviada apenas uma única opção de parcelamento.

• Identificada pelo atributo numeroParcelas.

Exemplo:

• 0 = à vista;
• 1 = parcela única;
• 2 = duas parcelas;

As regras da primeira etapa devem ser respeitadas:

• multiplosContratos
• obrigatorio

calcularDescontoParcelamento

• Se true:
  • retorna também os limites e opções de descontos por plano de parcelamento.
• Se false ou omitido:
  • os descontos sugeridos já vêm calculados normalmente na segunda etapa.

Principais retornos

valorDivida

Agora passa a retornar:

• o valor total das parcelas selecionadas;
• já considerando os descontos sugeridos.

parcelas

Retorna:

• todas as parcelas disponíveis;
• inclusive as não selecionadas.

As parcelas selecionadas vêm com:

• selecionado = true

Agora os descontos passam a ser calculados:

• valorDesconto
• descontoPrincipal
• descontoJuros
• descontoMora

• descontoMulta

   

Também são retornados:

• limites mínimos e máximos permitidos para negociação (Min e Max).

Se a assessoria quiser alterar os descontos sugeridos:

• deve executar a terceira etapa da simulação.

Se aceitar os valores sugeridos:

• a terceira etapa não é necessária.

parcelamentos

Na segunda etapa:

• somente o parcelamento escolhido é retornado com valores calculados;
• habilitado = true.

São retornados:

• datas sugeridas;
• valores das parcelas;
• entrada;
• juros;
• tarifas;
• descontos;
• fluxo completo de vencimentos.

Datas negociáveis

• dataEmissao
• dataVencimento

Com respectivos limites:

• dataEmissaoMin/Max
• dataVencimentoMin/Max

Valores negociáveis

• valorParcela
• valorEntrada
• taxaOperacao
• descontos e tarifas

Com seus respectivos limites mínimos e máximos.

Caso a assessoria queira alterar datas ou valores:

• deve executar a terceira etapa.

Caso aceite os valores sugeridos:

• pode seguir diretamente para efetivação da negociação.

Fluxo de vencimentos

Também são retornadas as informações detalhadas de cada parcela do acordo:

• numeroParcela
  • 0 = entrada;
• dataVencimento
• valorPrincipal
• valorJuros
• valorTarifa
• valorTotal

Esses dados permitem exibir o cronograma completo do parcelamento escolhido.

Exemplos de chamadas e de retornos do método Acordos API - Simular acordo (Etapa 2) constam no arquivo Assessorias - Acordos API.postman_collection.json, disponível como anexo em Integrando Assessorias através da API do CobranSaaS.