Pular para o conteúdo principal
Este documento descreve os eventos relacionados ao sistema de callbacks, detalhando como os dados são enviados e recebidos, bem como os possíveis status e suas respectivas finalidades. Funciona como um guia para integração, implementação e gerenciamento de callbacks. Os callbacks são utilizados para notificar o integrador sobre mudanças no status de propostas, permitindo que ações sejam tomadas de forma automatizada ou manual, conforme necessário. Para evitar problemas de comunicação, é essencial que o endpoint configurado para receber os callbacks seja otimizado para processar as mensagens de forma assíncrona, conforme descrito neste documento. Além disso, são apresentados exemplos práticos de URLs parametrizadas, uma tabela detalhada com os possíveis status das propostas e orientações sobre como interpretar os dados enviados no corpo das mensagens para determinados status específicos.
O endpoint configurado para receber os callbacks deve funcionar principalmente como um repositório, minimizando o processamento no momento da recepção para evitar atrasos. Implementar processos complexos durante o recebimento dos callbacks pode resultar em timeouts e falhas na comunicação, comprometendo a eficiência do sistema. Opte por processar as mensagens recebidas de forma assíncrona para melhorar a performance e confiabilidade do seu sistema de callbacks.

​
Notificação de eventos da proposta

Segue exemplo de URL de como parametrizamos para recebimento: 
www.exemplo-de-url.com.br?proposta={PROPOSTA}&situacao={SITUACAO}&identificador={IDENTIFICADOR}
ParâmetroDescrição do parâmetro
PropostaGuid único gerado no response durante a inclusão da proposta.
SituaçãoID da situação da proposta em nosso sistema.
IdentificadorCaso seja enviado, esse campo representa o código da operação enviado na inclusão da proposta.

​
Tabela de eventos da proposta

IDDescriçãoDescrição detalhada
0Em DigitaçãoProposta encontra-se em digitação.
1Em AnáliseProposta foi enviada para fila de análise.
2AprovadaProposta foi aprovada pela área de análise de crédito.
3RecusadaProposta foi recusada pela área de análise de crédito.
4CanceladaProposta foi cancelada pela área de análise de crédito.
5PendenteProposta foi marcada como pendente pela área de análise de crédito, necessita de intervenção do integrador para retornar à fila de análise.
6FinalizadaProposta foi finalizada.
7ConferidaProposta foi conferida pela área de formalização.
8LiberadaProposta foi liberada pela área de formalização para pagamento.
9PagaProposta foi paga pela área financeira.
10CedidaProposta foi cedida ao fundo.
11Pendente PagamentoProposta pendente de pagamento por inconsistência em dados bancários, exigindo que o integrador informe os dados corretos para retornar à fila de pagamento.

​
Tabela de eventos do split

IDDescrição
100Alteração de Status do Split
101Liberado
102Pago
103Pagamento do Split Pendente Pagamento
Caso ocorra algum problema durante o recebimento do callback de proposta, o sistema realizará até 3 tentativas de envio.
Além dos dados já enviados na consulta (query), como guid da Proposta, Status e Identificador, os callbacks de Pago “9” e Pendente pagamento “11” possuem um body com o campo “Descrição da ocorrência”, que informa o motivo da pendência do pagamento quando for um status “11” e quando for status “9” retorna com o texto “Crédito ou débito efetivado”.
Caso o callback seja enviado com o método POST, além dos dados enviados na Query, o parceiro receberá no corpo da requisição: Status 09: 
{
    "descricaoOcorrencia": "09-Crédito ou Débito efetivado"
}
Status 11: 
{
    "descricaoOcorrencia": "AB-Conta de destistino não localizada ou inválida."
}
⌘I