Tabela de erros
Essas tabelas representam os erros que podem ser retornados de forma síncrona.
As tabelas abaixo apresentam os possíveis erros que podem ser retornados em nossas APIs de debito veicular.
API de Consulta de Debitos Veiculares
Alguns erros na nossa api são dinâmicos, isso significa que ao validarmos as propriedades recebidas no input, por se tratarem de erros relacionados ao preenchimento do body da request, definimos um único código de erro para apresentar as validações e retornar as mensagens de erro.
| Mensagem de erro | Código do erro | Resolução |
|---|---|---|
| Renavam inválido(s). ClientRequestId, Placa não informado(s) | 809 | Deve ser informado um clientRequestId e placa na requisição. |
| Placa inválido(s). ClientRequestId, Renavam não informado(s) | 809 | Deve ser informado um clientRequestId e renavan na requisição. |
| Documento inválido(s). Placa não informado(s) | 809 | Deve ser informado um docuemnto valido e uma placa para realizar a requisição. |
| Estado inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido um estado valido e um ClientRequestId. |
| Renavam inválido(s) | 809 | Deve ser preenchido um renavan valido. |
| Estado, Renavam inválido(s). ClientRequestId não informado(s). | 809 | Deve ser preenchido um estado e renavan valido, também deve ser preenchido o ClientRequestId |
| Estado inválido(s). ClientRequestId, Placa não informado(s). | 809 | Deve ser preenchido um estado valido, também deve ser preenchido o ClientRequestId e uma placa valida. |
| Placa, Documento inválido(s). ClientRequestId, Renavam não informado(s) | 809 | Deve ser preenchido uma placa e documento valido, também deve ser preenchido o renavan do veículo. |
| ClientRequestId, Documento não informado(s). | 809 | Deve ser preenchido um documento valido e um ClientRequestId. |
| Placa, Estado, Renavam inválido(s) | 809 | Deve ser preendhido uma placa, estado e renavan validos. |
| Estado inválido(s). ClientRequestId, Renavam, Placa não informado(s) | 809 | Deve ser preenchido um estado valido, também é obrigatorio o preenchimento de uma placa, renavan e ClientRequestId valido. |
| Placa, Documento inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido a placa e um documento valido, também é obrigatório o preenchimento de um ClientRequestId valido. |
| Renavam, Documento inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido um Renavan e documento valido, também é obrigatório o preenchimento de um ClientRequestId valido. |
| Estado, Renavam inválido(s) | 809 | Deve ser preenchido um estado e renavan valido. |
| Placa inválido(s). Renavam não informado(s). | 809 | Deve ser preenchido uma placa valida, também é obrigatorio o preenchimento de renavan valido. |
| Placa, Estado, Renavam inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido uma placa,estado e renavan valido, também é obrigatorio o preenchimento de um ClientRequestId valido. |
| Renavam não informado(s) | 809 | Deve ser preenchido um renavan valido. |
| Renavam inválido(s). Estado não informado(s) | 809 | Deve ser preenchido um renavan valido, também é obrigatório o preenchimento de um estado valido. |
| Renavam inválido(s). Estado, Placa não informado(s) | 809 | Deve ser preenchido um e renavan valido, também é obrigatório o preenchimento de um estado e placa do veículo valido. |
| ClientRequestId, Placa não informado(s). | 809 | Deve ser preenchido uma placa e clientrequestid valido. |
| Renavam inválido(s). ClientRequestId, Estado, Placa não informado(s) | 809 | Deve ser preenchido um renavan valido, também é obrigatório o preenchimento de um ClientRequestId, estado e placa valido. |
| Estado, Renavam inválido(s). Placa não informado(s) | 809 | Deve ser preenchido um estado e renavan valido, também é obrigatório o preenchimento de uma placa valida. |
| Placa, Renavam inválido(s). ClientRequestId, Estado não informado(s) | 809 | Deve ser preenchido uma placa e renavan valido, também é obrigatório o preenchimento de um ClientRequestId e estado valido. |
| Documento inválido(s). ClientRequestId, Renavam não informado(s). | 809 | Deve ser preenchido um documento valido, também é obrigatório o preenchimento de um ClientRequestId valido. |
| Estado, Renavam, Placa não informado(s) | 809 | Deve ser preenchido uma placa, renavan e estado valido |
| Placa inválido(s). | 809 | Deve ser preenchido uma placa valida. |
| Placa inválido(s). ClientRequestId, Estado não informado(s). | 809 | Deve ser preenchido uma placa valida, também é obrigatório o preenchimento de um estado valido. |
| Estado, Renavam não informado(s) | 809 | Deve ser preenchido um estado e renavam valido. |
| Renavam inválido(s). ClientRequestId, Estado, Placa não informado(s) | 809 | Deve ser preenchido um renavan valido, também é obrigatório o preenchimento de um estado, placa e clientrequestid valido. |
| Renavam inválido(s). Placa não informado(s). | 809 | Deve ser preenchido um renavan e placa valida. |
| Placa, Renavam inválido(s). ClientRequestId, Estado não informado(s). | 809 | Deve ser preenchido um renavan e placa valido, também é obrigatório o preenchimento de um estado e clientrequestid valido. |
| ClientRequestId, Estado não informado(s) | 809 | Deve ser preenchido um clienterequestid e estado valido. |
| Renavam inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido um renavan valido, também é obrigatório o preenchimento de um clientrequestid valido. |
| Placa, Renavam inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido uma placa e renavan valido, também é obrigatório clientrequestid valido. |
| Placa inválido(s). ClientRequestId, Estado, Renavam não informado(s). | 809 | Deve ser preenchido uma placa valida, também é obrigatório o preenchimento de um estado e renavan valido. |
| Renavam inválido(s). ClientRequestId não informado(s). | 809 | Deve ser preenchido um renavan valido, também é obrigatório o preenchimento de um clientrequestid valido. |
| Documento inválido(s). ClientRequestId, Renavam não informado(s) | 809 | Deve ser preenchido um renavan e placa valido, também é obrigatório o preenchimento de um estado e clientrequestid valido. |
| Estado inválido(s). Placa não informado(s) | 809 | Deve ser preenchido um estado valida, também é obrigatório o preenchimento de uma placa valida. |
| Renavam, Placa não informado(s) | 809 | Deve ser preenchido um renavan e placa valido. |
| Renavam inválido(s). Estado não informado(s) | 809 | Deve ser preenchido um renavan e estado valido. |
| ClientRequestId, Estado, Renavam, Placa não informado(s) | 809 | Deve ser preenchido um clientrequestid,renavan e placa valido. |
| Placa inválido(s). ClientRequestId, Estado não informado(s). | 809 | Deve ser preenchido um clientrequestId e estado valido. |
| Estado, Renavam inválido(s). ClientRequestId não informado(s) | 809 | Deve ser preenchido um clientrequestId, revan e estado valido. |
| Documento inválido(s). Renavam não informado(s) | 809 | Deve ser preenchido um documento valido, também é obrigatório o preenchimento de um renavan valido. |
| ClientRequestId, Renavam não informado(s) | 809 | Deve ser preenchido um renavan e clientrequesid valido. |
| Estado, Renavam, Placa não informado(s) | 809 | Deve ser preenchido um renavan e placa e estadp valido. |
| Placa, Renavam inválido(s). Estado não informado(s). | 809 | Deve ser preenchido um renavan e placa valido, também é obrigatório o preenchimento de um estado valido. |
| Placa, Estado inválido(s). Renavam não informado(s). | 809 | Deve ser preenchido um renavan e placa valido, também é obrigatório o preenchimento de um estado e clientrequestid valido. |
| Renavam não informado(s). | 809 | Deve ser preenchido um renavan valido |
| Placa, Estado inválido(s) | 809 | Deve ser preenchido um renavan e placa valido. |
| Detran disponível para consulta entre XX:XX:XX e YY:YY:YY | 804 | Deve ser realizado novamente a consulta dentro do horário de disponibilidade informado. |
| Consulta Cancelada | 826 | A consulta foi cancelada, desta forma se faz necessário uma nova consulta. |
| Detran indisponível - Indisponibilidade com Detran. Tentar novamente | 807 | Recomendar ao cliente realizar a consulta novamente em alguns minutos. |
| Erro não especificado. - Tentar novamente | 999 | Entrar em contato com suporte da Celcoin informando o erro para que eles possam analisar e realizar as devidas correções. |
| Produto não Liberado | 900 | Deve ser entrado em contato com suporte solicitando a liberação do produto. |
| O estado {uf} não está disponível para consulta e pagamento. | 901 | Verifique os Estados Suportados pela API de Débito Veicular |
API de Pagamentos de Debitos Veiculares
| Mensagem de erro | Código do erro | Resolução |
|---|---|---|
| Identificador da Consulta não encontrado, verifique se os dados estão corretos e tente novamente. DebtId: N4CS480I8F1U | 811 | Deve ser preenchido um transactionId valido em uma solicitação de pagamento. |
| Saldo insuficiente para a transação | 803 | Deve ser inserido saldo na conta bolsão para realizar o pagamento de um débito veicular. |
| Baixa de débitos indisponível | 805 | Deve ser realizado uma nova consulta, onde será gerado um novo transactionId e com ele deve ser realizado a tentativa do(s) débito veicular. |
| Detran indisponível - Indisponibilidade com Detran. Tentar novamente | 807 | Deve ser solicitado para realizar o pagamento novamente em alguns segundos. |
| Um Pagamento já foi realizado com esse transactionId. Por favor, refaça a consulta | 813 | Deve ser realizado uma nova consulta, onde será gerado um novo transactionId e com ele deve ser realizado a tentativa do(s) débito veicular. |
| Erro não especificado - Tentar novamente | 999 | Deve ser realizado um contao com a equipe de suporte informando ocorrido para o time avaliar e realizar as devidas tratativas. |
| Existem débitos dependentes que devem ser pagos juntos ao débito informado | 815 | Nesse cenário existe a necessidade de realizar o pagamento de um, ou mais débitos em conjunto, por tanto deve ser validado no retorno do webhook de consulta dos débitos veiculares, quais são as dependências, para realizar o pagamento. |
| Existem débitos obrigatórios que devem ser pagos | 816 | Nesse cenário existe a necessidade de realizar o pagamento de um, ou mais débitos obrigatórios, para isso basta validar a propriedade required retornada no webhook de consulta dos debitos veiculares, caso ela seja true, mostra que o debito precisa ser pago obrigatoriamente no momento da solicitação de pagamento. |
| Existem débitos que não podem ser pagos em conjunto | 817 | Nesse existe a necesidade realizar o pagamento de alguns debitos separadamente, por tanto é necessario validar no retorno do webhook da consulta dos debitos veiculares, se a propriedade distinct está preenchida, ou seja, dentro do array tem algum valor. Caso positivo, deve ser realizado a escolha de um desses objetos para realizar o pagamento. Para esclarecer melhor esse erro imagine o seguinte cenário, no mês de janeiro é apresentado para um veiculo a opção de pagar o IPVA parcelado, ou em uma cota unica. Esse debito é considerado distinto, pois o usuario final precisa escolher uma das opções de pagamento. |
| Não é possível efetuar pagamentos já vencidos | 818 | Deve ser realizado uma nova consulta para o debito, pois o mesmo teve sua data de vencimento ultrapassada. |
| Não foram encontrados debitos para essa transacao de pagamento | 833 | Não foram encontrados debitos para essa transacao de pagamento |
| Existe identificador de débito em duplicidade na solicitação. | 834 | Deve ser retirado(s) os identificadores que estão em duplicidade da solicitação de pagamento |
| Produto não Liberado | 900 | Deve ser entrado em contato com suporte solicitando a liberação do produto. |
| ClientRequestId já Utilizado | 822 | Deve ser realizado uma nova consulta gerando um novo clienteRequestId, pois o utilizado na request já foi utilizado. |
Updated 5 months ago