A API de consulta de débitos veiculares permite que o cliente consulte os débitos de um veículo a partir de um fluxo assíncrono.
Antes de realizar uma consulta, você deverá cadastrar uma URL para receber as atualizações de status da pesquisa via webhook através deste endpoint.
Neste link você poderá encontrar um guia com maiores detalhes de como cadastrar um endpoint webhook para receber os resultados da sua pesquisa.
Ao realizar a requisição com sucesso, você receberá um código através do campo batch_id. Segundos depois, você receberá um webhook com a url para consultar o resultado final.
Além disso, com o batch_id também é possível consultar o status da requisição de pesquisa. Através do endpoint status
Eventos de Pesquisa de Débitos Veiculares que poderão aparecer nos eventos vinculados a aquele veículo são.
| Evento | Descrição |
|---|---|
| vehicle_debts_found | Foram encontrados débitos para o veículo pesquisado. |
| vehicle_debt_not_found | Não foram encontrados débitos para o veículo pesquisado. |
| vehicle_not_found | O veículo informado não foi encotrado. |
| vehicle_debt_search_error | Houve algum erro ao tentar realizar a pesquisa de débitos do veículo (Detalhes serão informados no corpo do evento) |
| vehicle_enriched_partially | A pesquisa não foi concluída porque não foi possível encontrar dados adicionais do veículo. |
Em nosso guia de uso, você poderá encontrar exemplos de payloads que seu endpoint receberá de acordo com cada um dos eventos listados acima.
Para testar o comportamento dessa API e diferentes tipos de retorno em ambiente sandbox, separamos um conjunto de placas de testes para você neste link.