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.
{ "chassi": "9AAAA99A999999999", "placa": "AAA9999", "renavam": "99999999999", "anoUltimoLicenciamento": 2021, "marca": "RENAULT", "modelo": "DUSTER 20 D 4X2A", "anoFabricacao": "2007", "anoModelo": "2008", "situacao": "EM CIRCULACAO", "uf": "DF", "categoria": "PARTICULAR", "tipo": "CAMINHONETE", "placaMercosul": false, "debitosLicenciamento": [ { "anoReferencia": 2022, "dataValidade": "31/12/2022", "dataVencimento": "23/02/2022", "valorOriginal": 87.66, "valorPago": 0, "valorTotal": 111.34, "quitado": false, "isento": false, "valorMulta": 9.2, "valorMora": 10.12, "valorOutros": 4.36, "valorDiferenca": 0 } ], "infracoes": [ { "numeroAuto": "FT00472453", "orgaoAutuador": "DETRAN - DF", "siglaOrgaoAutuador": "DETRAN - DF", "situacao": "Multa c/ Autuacao Notificada", "situacaoBordero": "LANCADO", "dataCometimento": "20/09/2022", "emiteBordero": false, "parcelada": false, "pontua": false, "sobJudice": false, "recursoJari": false, "efeitoSuspensivo": false, "emAutuacao": true, "dataNotificacao": "", "dataNotificacaoAutuacao": "29/09/2022", "dataLimiteDefesaPrevia": "19/11/2022", "dataGoraInfracao": "20/09/2022 07:07", "dataVencimento": "16/01/2023", "vencida": false, "ufDocumentoInfrator": "DF", "nomeInfrator": "MARIA DE LOURDES WERNECK", "nomeMunicipioLocalInfracao": "BRASILIA", "nomeMunicipioLocal": "BRASILIA", "ufLocal": "DF", "localMulta": "VIA S3 SBS ALT. QD. 04 SENT. SBS/L2 SUL - CRUZ. 015", "valor": 130.16, "valorDesconto": 104.13, "valorCorrigido": 130.16, "descricaoInfracao": "TRANSITAR VELOCIDADE SUPERIOR MAX PERMIT ATE 20%", "responsavelInfracao": "CONDUTOR", "descricaoResumoInfracao": "POR EXCESSO DE VELOCIDADE", "grupoInfracao": "MEDIA", "pontosInfracao": 4, "emCobranca": false, "emDividaAtiva": false } ], "debitosIpva": [ { "anoExercicio": "2022", "cotas": [ { "valorPrincipal": 229.1, "cotaReferencia": "01", "anoExercicio": 2022, "valorMora": 23.16, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 275.17 }, { "valorPrincipal": 229.1, "cotaReferencia": "02", "anoExercicio": 2022, "valorMora": 23.16, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 275.17 }, { "valorPrincipal": 229.1, "cotaReferencia": "03", "anoExercicio": 2022, "valorMora": 21.07, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 273.08 }, { "valorPrincipal": 229.1, "cotaReferencia": "04", "anoExercicio": 2022, "valorMora": 18.47, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 270.48 }, { "valorPrincipal": 229.1, "cotaReferencia": "05", "anoExercicio": 2022, "valorMora": 15.9, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 267.91 }, { "valorPrincipal": 229.1, "cotaReferencia": "06", "anoExercicio": 2022, "valorMora": 13.31, "valorMulta": 22.91, "valorOutros": 0, "valorTotal": 265.32 }, { "valorPrincipal": 1374.6, "cotaReferencia": "89", "anoExercicio": 2022, "valorMora": 115.07, "valorMulta": 137.46, "valorOutros": 0, "valorTotal": 1627.13 } ] } ], "pdf": "JVBE..." } |
Resposta com erro
{ "status":"erro", "mensagem":"041 - Veículo não cadastrado" } |