Detran CE - Consulta Completa do Veículo

O que é

Na consulta Detran CE - Consulta Completa do Veículo - você verifica informações e a situação de um veículo com placa registrada no Ceará:

placa, renavam, chassi, informações gerais
informações sobre multas, restrições, licenciamento

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-ce/veiculos/consulta-completa-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": {
    "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“.
- 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",
	"chassi": "000000000AV000000",
	"municipioEmplacamento": "FORTALEZA",
	"anoFabricacao": "2015",
	"anoModelo": "2016",
	"numeroMotor": "99999999999999",
	"marca": "JEEP/RENEGADE THAWK AT D",
	"cor": "PRETA",
	"tipo": "UTILITARIO",
	"especie": "MISTO",
	"combustivel": "DIESEL",
	"nacionalidade": "NACIONAL",
	"categoria": "PARTICULAR",	
	"anoExercicio": "2019",
	"isentoIpva": "NAO ISENTO",
	"debitoIpva": "NAO",
	"queixaRoubo": "NAO",
	"sng": "",
	"anoSeguro": "2019",
	"debitoLicenciamento": "NAO",
	"pendenciaRecall": "NAO",
	"observacoes": {
		"mensagem": "",
		"itens": [
			{
				"codigo": "120",
				"observacao": "VEIC.MODIF.ESP/PASS.P/CARGA"
			}
		]
	},
	"restricoes": {
		"mensagem": "",
		"itens": [
			{
				"codigo": "8.0",
				"restricao": "VEICULO VENDIDO. EFETUAR TRANSF. ART.134/CTB.",
			}
		]
	},
	"multas": {
		"mensagem": "",
		"itens": [
			{
				"codigoInfracao": "999999",
				"descricaoMulta": "TRANSITAR EM VELOCIDADE SUPERIOR A MAXIMA PERMITIDA EM ATE 20%",
				"situacao": "Ativa",
				"dataVencimento": "01/03/2020",
				"orgaoAutuador": "106100",
				"aitInfracao": "V0000000000",
				"dataHoraInfracao": "01/01/2020 / 12:40",
				"localInfracao": "CE-040, KM 3,7 - FORTALEZA - CE",
				"valorMulta": 130.16,
				"valorPagar": 132.71
			}
		]
	}
}

Resposta com erro

Mensagem de erro quando o dado informado é inválido:

{
  "status":"erro",
  "mensagem":"Veículo não encontrado"
}