Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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:

...

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

...

Include Page
URL Base
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

Code Block
{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

...

Code Block
{
  "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.

Code Block
languagejson
{
  "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..."
}

...