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

A terceira etapa da simulação serve para:

• recalcular a negociação com valores personalizados;
• alterar descontos, datas e condições do parcelamento;
• simular cenários diferentes dos sugeridos automaticamente na segunda etapa.

Ela só é necessária quando a assessoria deseja modificar:

• descontos das parcelas;
• datas;
• entrada;
• valor das parcelas;
• taxas;
• tarifas.

Se os valores sugeridos na segunda etapa forem aceitos, a terceira etapa pode ser ignorada.

Objetivo da terceira etapa

Permitir que a assessoria personalize:

• descontos por parcela;
• datas do acordo;
• valores do parcelamento;
• obter um novo cálculo atualizado da negociação.

Parâmetros utilizados

Além dos parâmetros já usados anteriormente:

• cliente
• negociacao
• meioPagamento
• parcelas
• parcelamento

Na terceira etapa podem ser enviados valores personalizados.

Personalização das parcelas

Cada parcela deve continuar sendo identificada pelo:

• atributo parcela (ID da parcela).

Opcionalmente, podem ser alterados os descontos:

• valorDesconto
• descontoPrincipal
• descontoJuros
• descontoPermanencia
• descontoMora
• descontoMulta
• descontoOutros

Esses valores:

• substituem os descontos sugeridos na segunda etapa;
• devem respeitar os limites de negociação (Min e Max).

O atributo:

• permiteValoresForaMinimoMaximo

define se é possível enviar valores fora da alçada:

• true → permitido, sujeito à aprovação;
• false → não permitido.

Personalização do parcelamento

A opção escolhida continua sendo identificada por:

• numeroParcelas

Exemplos:

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

Também podem ser alterados:

Datas

• dataEmissao
• dataVencimento

respeitando:

• dataEmissaoMin/Max
• dataVencimentoMin/Max

Valores

• valorParcela
• valorEntrada
• taxaOperacao
• descontoDivida
• descontoTarifa
• descontoTarifaParcela

respeitando os limites:

• valorParcelaMin/Max
• taxaOperacaoMin/Max

• valorEntradaMin/Max

   

Retorno da terceira etapa

O método retorna:

• os mesmos atributos da segunda etapa;
• porém com todos os valores recalculados conforme as personalizações informadas.

Fluxo de negociação

A API permite executar:

• 2 etapas → quando os valores sugeridos são aceitos;
• 3 etapas → quando há necessidade de personalização.

Também é possível:

• repetir a terceira etapa quantas vezes forem necessárias,
• ajustando descontos, datas e valores,
• até chegar às condições desejadas para efetivar a negociação.

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