Detran RN - Consulta do Veículo

O que é

Na consulta Detran RN - Consulta do Veículo - você verifica informações e a situação de um veículo com placa registrada no Rio Grande do Norte:

proprietário, placa, ano, marca,
pagamentos mais recentes, situação, débitos de IPVA, taxa de licenciamento e seguro DPVAT,
se possui autuações, multas, restrições.

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-rn/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

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

Status 422

{
  "message": "The given data was invalid.",
  "errors": {
    "placa": [
      "O campo placa é obrigatório."
    ],
    "renavam": [
      "O campo renavam é 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“.
- A propriedade “mensagem“ é preenchida quando o objeto de débitos relacionados é vazio. Da mesma forma, quando o objeto de débitos possui informação, a propriedade “mensagem“ é vazia.
- As mensagens são exibidas exatamente como retornadas da fonte original.

{
	"placa": "AAA0000",
	"renavam": "999999999",
	"placaAnterior": "AAA9999/RN",
	"tipo": "6-AUTOMOVEL",
	"categoria": "1-Particular",
	"especie": "1-Passageiro",
	"lugares": "5",
	"marca": "102636-FIAT",
	"modelo": "UNO WAY 1.0 (Nacional)",
	"anoFabricacao": "2011",
	"anoModelo": "2012",
	"potencia": "75",
	"combustivel": "16-Alcool-Gasol",
	"cor": "11-PRETA",
	"carroceria": "999-NAO APLICAVEL",
	"nomeProprietario": "NOME DO PROPRIETÁRIO",
	"recadastradoDetran": "DetranNet",
	"proprietarioAnterior": "NOME DO PROPRIETÁRIO ANTERIOR",
	"situacaoLacre": "REGULAR Portaria 272/2007 DENATRAN",
	"municipioEmplacamento": "NATAL",
	"licenciadoAte": "2019 em 01/01/2020,Licenciamento Anual (CRLV Eletrônico)(Via 1)",
	"adquiridoEm": "01/01/2019",
	"situacao": "Em Circulação",
	"restricaoVenda": "Sem gravame",
	"sequencia": "999999",	
	"informacoesPendentes": "Registro de Baixa de Alienação Fiduciária informado por ...",
	"impedimentos": "RENAJUD",
	"listagemDebitos": {
		"mensagem": "",
		"itens": {
			"debitos": [
				{
				  "classe": "Licenciamento Anual 2020",
				  "numeroGuia": "999999.9.999999999",
				  "vencimento": "20/03/2020",
				  "valorNominal": 90,
				  "valorAtual": 113.4
				}
			],
			"totalDebitosNominal": 90,
			"totalDebitosAtual": 113.4,
			"taxasDetran": 138.4,
			"seguroDpvat": 5.23,
			"ipva": 287.18,
			"multas": 0
		}
	},
	"infracoesAutuacao": {
		"mensagem": "Nenhuma Notificação de Autuação realizada para este veículo até o momento.",
		"itens": [
			{
				"numeroAuto": "UF:DN-999999-9999999999-9999 Em aberto",
				"descricao": "TRANSITAR/VELOCIDADE SUPERIOR A MAXIMA EM ATE 20% Em P... no dia 01/01/2018 às 12h00min",
				"localComplemento": "BR101 KM 108,05",
				"usuario": "RENAINF"
			}
		]
	},
	"multas": {
		"mensagem": "Nenhuma multa em aberto cadastrada para este veículo até o momento.",
		"itens": [
			{
				"numeroAuto": "UF:DN-999999-9999999999-9999 Em aberto",
				"descricao": "ESTACIONAR NO PASSEIO Em NATAL no dia 01/01/2019 às 12h00min",
				"localComplemento": "AV DEODORO DA FONSECA...",
				"usuario": "DDETRAN 99999999999"
			}
		]
	}
}

Resposta com erro

Placa ou renavam inválidos: