Obtendo as modalidades de Negociação e Meios de Pagamento

A obtenção das modalidades de negociação e dos meios de pagamento disponíveis é um pré-requisito para que as assessorias possam iniciar as simulações de negociações das dívidas de clientes.

Diferentes tipos de modalidades de negociação como, por exemplo, acordos, renegociações, propostas, promessas e pagamentos avulsos, e diferentes meios de pagamento para cada modalidade de negociação como, por exemplo, boleto, cartão de crédito, dinheiro, cheque e link para pagamento com cartão, podem estar disponíveis para as assessorias negociarem as dívidas de clientes.

A lista das modalidades de negociação e respectivos meios de pagamento disponíveis pode ser obtida através do método Negociações API - Listar negociações e, por poder retornar múltiplos registros, é importante observar as questões relativas à Paginação ao fazer chamadas a este método.

Conforme consta na documentação deste método, estão disponíveis parâmetros de entrada que poderão ser informados na chamada do método para restringir a lista modalidades de negociação retornada.

Sempre que a assessoria quiser obter as opções disponíveis para negociação das dívidas de um cliente específico, é importante que o parâmetro de entrada cliente seja informado com o ID do cliente, pois as opções disponíveis podem ser diferentes dependendo do cliente. Também é recomentado que o parâmetro de entrada situacao seja informado como ATIVO para que somente as modalidades de negociação que estiverem ativas sejam retornadas. No caso de a assessoria já ter conhecimento do(s) tipo(s) de modalidade de negociação que pretende utilizar para negociar as dívidas de um cliente específico, também é possível e recomendado informar um ou mais deste(s) tipo(s) (ACORDO, PAGAMENTO_AVULSO, PROMESSA e RENEGOCIACAO) no parâmetro de entrada tipoModalidade, de forma que modalidades de negociação de outros tipos não sejam retornadas.

A informação retornada no atributo tipoDesconto (GERAL e PARCELAMENTO) deverá ser devidamente considerada pois corresponde a duas possibilidades distintas de alçadas de negociação, disponível somente para os tipos de modalidade de negociação ACORDO e RENEGOCIACAO.

As modalidades de negociação dos tipos ACORDO, PAGAMENTO_AVULSO e RENEGOCIACAO são retornadas com um ou mais tipos de meios de pagamento (meiosPagamento) disponíveis (BOLETO, CARTAO_CREDITO, DINHEIRO, CHEQUE e LINK_PAGAMENTO) para cada uma delas. As modalidades de negociação do tipo PROMESSA de pagamento são retornadas sem nenhum meio de pagamento. O meio de pagamento escolhido para realizar a negociação das dívidas de clientes também implica em algumas diferenças na execução de simulações para cada modalidade de negociação.

Exemplos de chamadas e de retornos deste método constam no arquivo Assessorias - Negociações API.postman_collection.json, disponível como anexo em Integrando Assessorias através da API do CobranSaaS.