Detran DF - Consulta Veículos

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

Nome

Tipo

Obrigatório?

Descrição

Authorization

String

Sim

Chave de API gerada no cadastro no Plexi, prefixada com Bearer

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

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

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

1 2 3 {   "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42" }

Status 422

1 2 3 4 5 6 7 8 9 10 11 {   "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.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 { "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

1 2 3 4 { "status":"erro", "mensagem":"Veículo não encontrado" }