Webhook acordos

Neste capítulo, falaremos sobre como ativar e utilizar o módulo de webhook de acordos. Este módulo serve para integrar sistemas de terceiros com acordos cadastrados no Recuperador CRM.

Em resumo, o objetivo desse módulo é disparar automaticamente uma mensagem em formato POST para um sistema de terceiros com dados sobre o acordo cadastrado. Isso permitirá com que o sistema de terceiros faça algumas ações, tais como cadastrar uma negociação, registrar faturas (contas a receber) e entre outras coisas.

Dica: sistema de terceiros é um sistema feito por outra empresa, diferente da empresa responsável pelo Recuperador CRM, que receberá as informações do acordo. Esse sistema de terceiros pode ser um sistema de gestão, pode ser um sistema próprio etc.

Configuração inicial

O primeiro passo é habilitar o webhook de acordos no cadastro do credor em questão. Isso pode ser feito logado como administrador (assessoria) por meio do menu Cadastros > Credores > aba Webhooks. Mude o campo HABILITA WEBHOOK DE ACORDOS para Sim, defina o endereço do endpoint do sistema de terceiros e clique em Salvar.

Importante: o endpoint do webhook de acordos deve ser obtido com o suporte do seu sistema de terceiros. Ele deve começar com http ou https.

Locais de disparo do webhook de acordos

Os webhooks de acordos serão disparados automaticamente sempre que:

1. Um acordo for cadastrado no formulário de acordos;
2. Um acordo for cadastrado usando o portal de negociações;
3. Um acordo for cancelado;
4. Um acordo for quitado;

Além disso, o sistema fará uma retentativa diária de disparo de webhooks não processados nos últimos 7 dias na parte da manhã. O sistema faz até 5 tentativas de envio de webhook de um acordo para o sistema de terceiros.

Relatório

Em Cadastros > Credores > aba Webhooks > botão Lista de payloads de acordos, é possível consultar os disparos dos webhooks de acordos por período e o status do envio por meio da coluna Enviado.

Além disso, é possível usar o botão Reprocessar para forçar o envio dos webhooks de acordos um determinado período que eventualmente não foram enviados. Isso pode ser especialmente útil em caso de queda temporária do sistema de terceiros.

Lista de payloads de acordos com destaque para a coluna Enviado e botão Reprocessar

Classe do evento do payload

O webhook disparará uma ação de POST para o endpoint informado no formato JSON com os seguintes campos:

• int id: código do webhook;
• int id_credor: código do credor;
• int id_acordo: código do acordo;
• int id_cliente: código do devedor;
• int id_consultor: código do consultor do acordo;
• string nome_cliente: nome do devedor;
• string cpf_cnpj: CPF ou CNPJ do devedor;
• string nome_credor: nome do credor;
• string nome_consultor: nome do consultor do acordo;
• string data: data do acordo;
• int atraso: atraso em dias da dívida mais antiga negociada no acordo;
• string datavencto_original: data de vencimento da dívida mais antiga negociada no acordo;
• decimal valor_original: valor das dívidas negociadas sem descontos;
• decimal valor_acordo: valor final do acordo (com descontos);
• int parcelas: quantidade de parcelas geradas pelo acordo, incluindo a entrada quando houver;
• string periodicidade: periodicidade definida entre as parcelas do acordo. Exibe os valores M, Q ou S para periodicidade mensal, quinzenal ou semanal respectivamente,
• string dataprivencto: data de vencimento da primeira parcela do acordo;
• string entrada: define se foi cobrada ou não entrada no acordo. Aceita os valores S ou N para sim ou não respectivamente;
• string data_entrada:

  "valor_entrada":0.00,
  "feito_via_portal_negociacao":"N",
  "valor_desconto_juros_multa_correcao":0.00,
  "valor_desconto_principal":0.00,
  "valor_juros_proporcional_acordado":16.66,
  "valor_multa_proporcional_acordada":20.00,
  "valor_correcao_proporcional_acordada":9.90,
  "obs":null,
  "obs_publicas":null,
  "cancelado":"N",
  "data_cancelamento":null,
  "motivo_cancelamento":null,
  "situacao":"A",
  "lista_dividas":[
     {
        "id":962399,
        "datavencto":"2022-02-15T00:00:00",
        "datapagto":null,
        "valor":990.00,
        "descricao":"Divida",
        "obs":null,
        "contrato":null,
        "unidade":null,
        "competencia":null,
        "codigo":null,
        "situacao":"N"
     }
  ],
  "lista_parcelas":[