View Source

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.

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 `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
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.

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