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
{
"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-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"
}