O que é
Na consulta Detran DF - Consulta Veículos - você verifica informações e a situação de um veículo com placa registrada no Distrito Federal. As informações incluem:
placa, município, ano, categoria, cor, chassi e outras em geral,
licenciamento mais recente,
se possui autuações, multas, impedimentos, restrições.
Veja mais informações em nossa central de ajuda: Detran DF - Consulta Veículos
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/detran-df/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. |
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
|
Status 422
|
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-df-veiculos-consulta-veiculo", "placa": "AAA0000", "renavam": "0000000000", "chassi": "999AAA9AAAA999999", "marca": "CITROEN", "modelo": "C3 PICASSO GLX M", "cor": "PRATA", "anoFabricacao": "2011", "tipo": "AUTOMOVEL", "combustivel": "ALCOOL/GASOLINA", "potencia": "113", "cilindradas": "1587", "categoria": "PARTICULAR", "capacidade": "005", "especie": "PASSAGEIRO", "nacionalidade": "NACIONAL", "municipio": "BRASILIA", "uf": "DF", "rouboFurto": "NADA CONSTA", "situacao": "EM CIRCULACAO", "anoUltimoLicenciamento": "2020", "restricoes": [ "ALIENACAO FIDUCIARIA" ], "crlv":{ "dataMovimentacao": "01/09/2018", "tipoEntrega": "CORREIO", "numeroAr": "AA000000000BR" }, "debitos": { "licenciamento": { "mensagem": "", "itens": [ { "ano": "2020", "vencimento": "28/02/2020", "valor": 75.3, "multa": 7.62, "mora": 6.7, "outros": 0.88, "pago": 0, "total": 90.5 } ] }, "licencaUtilizacaoAnual": { "mensagem": "Não existe(m) débito(s) de Licença de Utilização Anual até o presente momento.", "itens": [] }, "ipva": { "mensagem": "A consulta e emissão dos débitos de IPVA só poderá ser feita através da Secretaria de Fazenda do Distrito Federal. Clique na imagem ao lado para acessar o site da Secretaria de Fazenda." }, "dpvat": { "mensagem": "", "itens": [ { "ano": "2020", "vencimento": "28/02/2020", "valor": 5.23 } ] }, "servicosDetran": { "mensagem": "Não existe(m) débito(s) de Serviço(s) até o presente momento.", "itens": [] }, "parcelamentoServicosDetran": { "mensagem": "Não existe(m) débito(s) de Parcelamento de Serviço(s) atá o presente momento.", "itens": [] } }, "infracoes": { "vencidas": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [ { "codigoRenainf": "00000000000", "codigoInfraest": "", "autoInfracao": "E000000000", "orgaoAutuador": "( 000300 ) DNIT", "descricao": "( 745-5 ) TRANSITAR VELOCIDADE SUPERIOR MAX PERMIT ATE 20%", "regulamento": "218 * I", "dataHoraInfracao": "01/01/2014 10:08", "dataPenalidade": "01/04/2016", "dataNotificacao": "01/06/2014", "responsavel": "CONDUTOR", "local": "BR-040 KM 5.6 - BRASILIA / DN", "dataVencimento": "01/05/2016", "natureza": "MEDIA", "pontuacao": 4, "valor": 85.13, "correcao": 0, "valorCorrecao": 85.13, "velocidadePermitida": "060 Km/h", "velocidadeAferida": "068 Km/h" } ] }, "vencer": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [] }, "rercursoJari": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [] }, "efeitoSuspensivo": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [] }, "subJudice": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [] }, "parceladas": { "quantidade": 0, "valor": 0, "valorComDesconto": 0.00, "itens": [] }, "notificacaoAutuacao": { "quantidade": 1, "valor": 195.23, "valorComDesconto": 0.00, "itens": [ { "codigoRenainf": "00000000000", "codigoInfraest": "", "autoInfracao": "AA0000000", "orgaoAutuador": "( 107100) DETRAN - DF", "descricao": "( 518-5 ) DEIXAR O CONDUTOR DE USAR O CINTO SEGURANCA", "regulamento": "167", "dataHoraInfracao": "01/09/2020 10:32", "dataPenalidade": "", "dataNotificacao": "01/09/2020", "responsavel": "RESPONSAVEL", "local": "LOCAL", "dataVencimento": "", "natureza": "GRAVE", "pontuacao": 5, "valor": 195.23, "correcao": 0, "valorCorrecao": 195.23, "velocidadePermitida": "", "velocidadeAferida": "" } ] }, "quantidade": 1, "total": 195.23 }, "recursosInfracoes": { "mensagem": "", "itens": [ { "processo": "000.000000/2016", "tipo": "RECURSO JARI", "dataAbertura": "01/09/2016", "situacao": "CONCLUIDO" } ] }, "pdf": "JVBE..." } |
Resposta com erro
{ "status":"erro", "mensagem":"Veículo não encontrado" } |