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

• calcular os valores da negociação;
• considerar as parcelas selecionadas;
• aplicar os descontos sugeridos ou personalizados;
• gerar os valores finais da única opção de parcelamento disponível.

Ela depende da primeira etapa, que fornece:

• parcelas disponíveis;
• descontos sugeridos;
• limites de negociação.

Parâmetros obrigatórios

Devem ser informados:

• cliente
• negociacao

Opcional:

• meioPagamento

Também é obrigatório enviar:

• a lista de parcelas selecionadas para negociação.

Seleção das parcelas

Cada parcela deve ser identificada pelo:

• atributo parcela (ID da parcela).

Também podem ser enviados descontos personalizados:

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

Se não forem informados:

• o sistema utiliza os descontos sugeridos na primeira etapa.

Limites de negociação

Os descontos devem respeitar:

• os limites mínimos e máximos retornados na primeira etapa.

Exemplos:

• valorDescontoMin/Max
• descontoPrincipalMax
• descontoJurosMax
• etc.

O atributo:

• permiteValoresForaMinimoMaximo

define se é permitido:

• enviar descontos fora da alçada;
• sujeitos à aprovação.

Principais retornos

valorDivida

Passa a retornar:

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

parcelas

Retorna:

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

As parcelas escolhidas vêm com:

• selecionado = true

Os descontos retornados podem ser:

• os sugeridos;
• ou os personalizados enviados na simulação.

parcelamentos

Na segunda etapa:

• a única opção de parcelamento passa a retornar valores calculados;
• habilitado = true.

numeroParcelas

Em pagamentos avulsos:

• sempre será 1.

Datas negociáveis

São retornadas:

• dataEmissao
• dataVencimento

Com limites:

• dataEmissaoMin/Max
• dataVencimentoMin/Max

No pagamento avulso:

• não existe entrada.

Valores negociáveis

São retornados:

• valorParcela
• descontoTarifa

Com seus respectivos limites:

• valorParcelaMin/Max
• descontoTarifaMax

Os seguintes atributos não são utilizados em pagamentos avulsos:

• descontoDivida
• taxaOperacao
• valorEntrada
• descontoTarifaParcela

Terceira etapa

Caso seja necessário alterar:

• datas;
• valores da parcela;
• descontos;

deve ser executada a terceira etapa da simulação.

Se os valores sugeridos forem aceitos:

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

Detalhamento da parcela

Também são retornadas informações da única parcela:

• numeroParcela
• dataVencimento
• valorPrincipal
• valorJuros
• valorTarifa
• valorTarifaParcela
• valorTotal

Esses dados podem ser usados para apresentar os valores finais da negociação ao cliente.

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.