Detran AP - Consulta de Veículos

O que é

Na consulta Detran AP - Consulta Veículos - você verifica informações e a situação de um veículo com placa registrada no Amapá. As informações incluem:

placa, município, ano, categoria, cor, chassi e outras em geral,
licenciamento mais recente,
se possui débitos, multas, restrições.

Sobre a requisição:

Método: POST

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

{
	"placa": "AAA0000",
	"renavam": "999999999",
	"chassi": "0A0AA0A00AA000000",
	"marca": "I",
	"modelo": "RENAULT CLIO",
	"cor": "BRANCA",
	"anoFabricacao": "2010",
	"anoModelo": "2011",
	"tipo":"AUTOMOVEL",
	"combustivel": "ALCOOL/GASOLINA",
	"potencia": "077",
	"cilindradas": "0999",
	"categoria": "PARTICULAR",
	"capacidade": "055",
	"especie":"PASSAGEIRO",
	"nacionalidade":"ESTRANGEIRA",
	"municipio": "MACAPA/AP",
	"rouboFurto": "",
	"situacao":"EM CIRCULACAO",
	"anoUltimoLicenciamento":"2017",
	"restricoes":[
		"ALIENACAO FIDUCIARIA",
		"RESTRICAO JUDICIAL"
	],	
	"debitosLicenciamento": [
	    {
	    	"ano": "2020",
	    	"vencimento": "15/06/2020",
	    	"valor": 79.35,
	    	"valorPago": 0.00,
	    	"valorDiferenca": 79.35
	    }
	],
	"ipva": [
		{
	    	"ano": "2020",
	    	"vencimento": "15/06/2020",
	    	"valor": 477.02
		}
	],
	"dpvat": [
		{
	    	"ano": "2020",
	    	"vencimento": "15/06/2020",
	    	"valor": 5.23
		}
	],
	"infracoes": [
		{
			"situacao":"Vencidas",
			"quantidade": 1,
			"valor": 136.06,
			"valorComDesconto": "sem direito a desconto"
		},
		{
			"situacao":"A vencer",
			"quantidade": 0,
			"valor": 0.00,
			"valorComDesconto": "0"
		},
		{
			"situacao":"Notificação de autuação",
			"quantidade": 3,
			"valor": 585.69,
			"valorComDesconto": ""
		}
	],
	"valorTotalDebitos": 158.70,
	"valorTotalIpva": 1037.18,
	"valorTotalDpvat": 21.44,
	"valorTotalInfracoes": 721.15
}

Resposta com erro

Dados inválidos: