API para cadastro de acordo de forma semelhante ao portal de negociação
A API de cadastro de acordos de forma semelhante ao portal de negociação deve ser utilizada para registrar um acordo no Recuperador CRM seguindo o formato do portal de negociação, ou seja, deverá ser informado o parcelamento desejado e o sistema efetuará o acordo como sendo um acordo feito pelo portal de negociação. Isso é bastante útil para utilizar a funcionalidade do portal de negociação do Recuperador CRM em formato white label.
Endpoint: https://www.recuperador.com.br/api/v1PortalNegociacao
Ação: POST
Formato: JSON
Autenticação: enviar o token da API no campo username da autenticação Basic Auth. Deixe o campo password em branco.
Objeto de entrada
{
id_contasareceber: int, id_credor: int, id_cliente: int, parcelas: int, cpf_cnpj_formatado: string
}
Seguem informações complementares sobre cada coluna do objeto:
- ID contas a receber: deve ser preenchido código da dívida. Utilize a API para listagem de dívidas elegíveis para negociação pelo portal de negociação para obter o id correto.
- ID credor: deve ser preenchido código do credor da dívida. Utilize a API para listagem de dívidas elegíveis para negociação pelo portal de negociação para obter o id correto.
- ID cliente: deve ser preenchido código do cliente (devedor) da dívida. Utilize a API para listagem de dívidas elegíveis para negociação pelo portal de negociação para obter o id correto.
- Parcelas: deve ser preenchido com um valor inteiro representando a quantidade e parcelas do acordo. Utilize a API de listagem de parcelamentos do portal de negociação para obter os parcelamentos válidos definidos para a assessoria. É importante destacar que a assessoria define a quantidade de parcelas e o respectivo desconto por parcelamento. Exemplo: para uma parcela, desconto de 70% nos juros, multa e correção. Para 2 parcelas, desconto de 60% etc. Portanto, é necessário informar a quantidade de parcelas de acordo com os parcelamentos configurados previamente.
- CPF/CNPJ formatado: deve ser preenchido com o CPF ou CNPJ do devedor. O documento deverá ser formatado com ponto, hífen e barra. Exemplo: utilize o formato 999.999.999-99 para CPF ou 99.999.999/9999-99 para CNPJ.
Classe de retorno
{
sucesso: bool, mensagem: string
}
Seguem informações complementares sobre cada coluna do objeto:
- Sucesso: retornará true em caso de acordo realizado com sucesso e false em caso de erro na chamada.
- Mensagem: exibirá a mensagem de sucesso ou de erro. Em caso de sucesso, será exibido o link da fatura, que é o link que o devedor deverá acessar para conferir as parcelas geradas, bem como para gerar os boletos ou para permitir o pagamento via cartão de crédito, dependendo da configuração do cadastro do credor.