🚘Débitos veiculares
1. Introdução
Este documento descreve o processo de consulta e pagamento de débitos veiculares por meio da Celcoin, destacando as etapas envolvidas e as considerações importantes.
2. Consulta de Débitos Veiculares - Três Etapas
** Mais informações sobre o fluxo de consulta clicando no link ao lado: Fluxo de Consulta
2.1 Primeira Etapa: Solicitação de Consulta Antes de efetuar o pagamento de débitos veiculares, inicia-se o processo com a solicitação de consulta. Nessa etapa, é realizada a requisição à Celcoin para obter informações detalhadas sobre os débitos pendentes de um veículo específico. Essa consulta não é síncrona e é válida até o final do dia em que foi realizada, ou seja, até às 23:59.2.2 Próxima Etapa: Retorno do Webhook e Processamento na Bemfacil (Empresa) Após a solicitação de consulta, a Celcoin retorna um evento no webhook informando se encontrou com sucesso os débitos do veículo. Em seguida, a Bemfacil processa essas informações, salvando os débitos no banco de dados do servidor (Bemfacil) para referência futura. Além disso, é enviada automaticamente uma notificação por e-mail ao usuário, fornecendo o status da consulta.2.3 Última Etapa: Verificação na Plataforma pelo Usuário. O usuário, então, entra na plataforma da Bemfacil e verifica o resultado da consulta. Todas as informações sobre os débitos associados ao veículo estão disponíveis de maneira clara e acessível.
3. Seleção de Débitos a Pagar e Cálculo do Valor Total. Após a consulta, o usuário pode selecionar quais débitos deseja quitar. Durante o processo de seleção de débitos, o usuário tem a liberdade de escolher quais pendências deseja pagar, personalizando o processo conforme suas necessidades e obedecendo a regras de dependência. Por exemplo, para quitar o IPVA, pode ser necessário pagar multas de trânsito associadas. Ao selecionar os débitos, o servidor realiza o cálculo do valor total a ser pago. Essa etapa é crucial para evitar inconsistências na exibição do valor ao cliente, garantindo uma informação precisa durante a visualização.
4. Pedido de Pagamento e Validação da Consulta
** Mais informações sobre o fluxo de pagamento clicando no link ao lado: Fluxo de Pagamento
Ao realizar um pedido de pagamento, a consulta associada a essa transação não é mais válida. Se o usuário desejar pagar um débito não selecionado durante a consulta, será necessário iniciar uma nova consulta para obter as informações mais recentes. É importante destacar que o pedido de pagamento é apenas uma solicitação e não representa o pagamento efetivo dos débitos. Esse pedido precisa ser processado pela Celcoin junto ao DETRAN para que os débitos sejam devidamente quitados.
5. Webhook para Recebimento de Eventos
** Mais informações sobre o fluxo de pagamento clicando no link ao lado: Fluxo de Webhook
Existe um webhook para receber eventos relacionados aos pedidos de pagamento. Após o processamento da transação pela Celcoin junto ao DETRAN, eventos são enviados para esse webhook. Simultaneamente, uma notificação por e-mail é enviada ao usuário informando o status do débito - se foi pago com sucesso ou não. Cada evento representa o status de um débito específico associado à consulta. Os eventos informam se o pagamento foi bem-sucedido ou não, permitindo à empresa manter seus registros atualizados em tempo real.
6. Atualização da Consulta Baseada em Regras de Status dos Débitos Dentro do Webhook A consulta é atualizada conforme regras estabelecidas, dependendo do status dos débitos, e essa atualização ocorre dentro do webhook. Essa etapa é crucial para garantir que as informações apresentadas estejam sempre precisas e reflitam a situação mais recente do veículo em relação aos débitos. Detalhes sobre essas regras podem ser encontrados ao lado: Status da Consulta (link para a página de detalhes da consulta).
Last updated