O que é
Na consulta Detran TO - Consulta Veículo - você verifica informações e restrições de um veículo com placa registrada na Paraíba:
informações como marca, modelo, categoria, cor, ano de fabricação
se possui débitos, restrições, multas
Veja mais informações em nossa central de ajuda: Detran TO - Consulta Veículo
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/detran-to/veiculos/consulta-veiculo
URL Base:
Parâmetros do header
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
Callback | String | Não | URL para onde o resultado da requisição será enviado via HTTP POST. |
Parâmetros do body
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
placa | string | Sim | Placa do veículo a ser pesquisado. |
renavam | string | Sim | Renavam do veículo a ser pesquisado. |
cpfCnpj | string | Sim | CPF ou CNPJ do proprietário do veículo , com ou sem máscara. Exemplos: 99999999999 ou 999.999.999-99 |
Retornos possíveis da requisição
Status | Significado | Descrição | Informações retornadas |
---|---|---|---|
201 | Created | Solicitação criada | Campo requestId, com o ID da requisição criada. |
422 | Unprocessable Entity | A solicitação contém erro | Em quais campos houve erro. |
Exemplos de retornos
Status 201
{ "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42" } |
Status 422
{ "message": "The given data was invalid.", "errors": { "cpf": [ "O campo cpf é obrigatório." ], "nome": [ "O campo name é obrigatório." ] } } |
Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )
Resposta com registro encontrado
Observações:
Informações relacionadas a débitos são apresentadas de 2 formas:
A propriedade “itens“ apresenta os débitos, quando existem
A propriedade “mensagem“ exibe alguma mensagem quando não há débitos. Exemplos de mensagens: “Nenhuma observação encontrada“, “Nenhuma restrição encontrada“.
As mensagens são exibidas exatamente como retornadas da fonte original.
{ "endpoint": "detran-to-veiculos-consulta-veiculo", "placa": "AAA0000", "renavam": "00000000000", "placaAnterior": "AAAA0000/TO", "tipo": "17-CAMINHAO TRATOR", "categoria": "2-ALUGUEL", "especie": "5-TRACAO", "lugares": "2", "marca": "315254-SCANIA", "modelo": "G 420 A4X2 (Nacional)", "anoFabricacao": "2010", "anoModelo": "2010", "potencia": "420", "combustivel": "3-DIESEL", "cor": "15-VERMELHA", "carroceria": "999-NAO APLICAVEL", "restricoes": { "mensagem": "", "itens": [ "Alienação Fiduciária em favor de ..." ] }, "informacoesPendentes": { "mensagem": "Nenhuma informação pendente até esta data", "itens": [] }, "impedimentos": { "mensagem": "Nenhum impedimento registrado até esta data", "itens": [] }, "crlv": "", "debitos": [ { "descricao": "UF:RD-000000-T000000000-0000/00", "vencimento": "01/07/2019", "nominal": 195.23, "corrigido": 195.23, "desconto": 0.00, "juros": 0.00, "multa":0.00, "atual": 195.23 } ], "infracoesAutuacao": { "mensagem": "", "itens": [ { "numeroAuto": "UF:RD-000000-T000000000-0000/00 Renainf: 0000000000 Em aberto", "descricao": "CONDUZIR VEIC COM VIDRO TOTAL/PARCIALMENTE COBERTO POR PELÍCULA... no dia 19/12/2016 às 09:10", "local": "BR-316 KM-297 UF-PI", "valor": 195.23 }, { "numeroAuto": "UF:RD-000000-T000000000-0000/00 Renainf: 0000000000 Em aberto", "descricao": "CONDUZIR VEIC COM VIDRO TOTAL/PARCIALMENTE COBERTO POR PELÍCULA... no dia 11/09/2020 às 08:52", "local": "BR-153 KM-332 UF-TO", "valor": 195.23 } ] }, "multas": { "mensagem": "Nenhuma multa em aberto cadastrada para este veu00edculo atu00e9 o momento.", "itens": [ { "numeroAuto":" UF:RD-000100-T126416087-6645/00 Renainf: 2843264286 Em aberto", "descricao": "CONDUZIR O VEICULO COM EQUIP OBRIGATÓRIO EM DESACORDO COM O ESTAB PELO CONTRAN Em IBOTIRAMA no dia 01/09/2017 às 20:20", "local":"BR-242 KM-582 UF-BA", "valor": 195.23 } ] }, "recursosInfracao": { "mensagem": "", "itens": [ { "numeroAuto":"", "descricao": "", "local":"", "valor": 0.00 } ] }, "pdf": "JVBER..." }
Resposta com erro
Renavam inválido:
{ "status":"erro", "mensagem":"Renavam informado não confere com a Placa." }
Placa, CPF ou CNPJ inválido:
{ "status":"erro", "mensagem":"Dados não conferem." }