Efetivando Propostas de Acordo e de Renegociação

Somente as modalidades de negociação do tipo ACORDO e RENEGOCIAÇÃO podem permitir o registro de Propostas no CobranSaaS.

Após a simulação de acordos ou renegociações em várias etapas, a proposta é efetivada via método Propostas API - Efetivar proposta.

Os parâmetros de entrada são similares aos da terceira etapa da simulação e da efetivação de negociações, conforme Efetivando Negociações.

Os parâmetros cliente, negociacao e meioPagamento devem conter obrigatoriamente os IDs correspondentes. O dataVigencia indica a data limite da proposta, conforme o limite da modalidade de negociação. Também é obrigatória a lista de parcelas da dívida e uma ou mais opções de parcelamento para efetivar a proposta.

Cada parcela deve ser identificada pelo seu ID no atributo parcela e conter obrigatoriamente os 7 atributos de desconto: valorDesconto, descontoPrincipal, descontoJuros, descontoPermanencia, descontoMora, descontoMulta e descontoOutros, geralmente iguais aos da última etapa da simulação.

Diferente da efetivação de acordos e renegociações, que aceita apenas uma opção de parcelamento, na efetivação de propostas pode ser enviada uma lista de opções, cada uma identificada pelo número de parcelas no atributo numeroParcelas. Valores indicam: 0 = à vista; 1 = parcela única (com ou sem entrada); 2 = duas parcelas, etc.

Os atributos dataEmissao, dataVencimento, valorEntrada, descontoDivida, taxaOperacao e descontoTarifa são obrigatórios e geralmente iguais aos da última etapa da simulação. O atributo descontoTarifaParcela é opcional, mas recomendado, mesmo que seu valor seja zero.

Após a efetivação, o método retorna os dados detalhados da proposta, que passam a ser as informações oficiais, substituindo as temporárias da simulação. Entre as informações retornadas estão:

• id - identificador único interno da proposta no CobranSaaS;
• numeroProposta - número para identificação pelos usuários;
• condicoes - valores e datas calculados para cada opção de parcelamento enviada.

Exemplos de chamadas e de retornos do método Propostas API - Efetivar proposta constam no arquivo Assessorias - Propostas API.postman_collection.json, disponível como anexo em Integrando Assessorias através da API do CobranSaaS.