View Source

O que é

Na consulta Detran AM - Situação do Veículo - você verifica informações e a situação de um veículo com placa registrada no Amazonas:

placa, renavam, ano, modelo, outras informações gerais
informações sobre multas, débitos, restrições, licenciamento

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-am/veiculos/situacao-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
renavam	string	Somente se chassi não for informado	Renavam do veículo a ser pesquisado.
chassi	string	Somente se renavam não for informado	Chassi 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

{
	"placa": "AAA0000",
	"renavam": "9999999999",
	"proprietario": "NOME DO PROPRIETÁRIO",
	"cor": "PRETA",
	"marca": "PEUGEOT/207HB XR S",
	"tipo": "AUTOMOVEL",
	"anoFabricacao": 2011,
	"anoModelo": 2012,
	"situacao":{
		"vencimentoLicenciamentoAnual": "30/12/2020",
		"ultimoLicenciamento": 2019,
		"chassi": "*****************9999",
		"categoria": "PARTICULAR",
		"observacoes": "HA UMA BAIXA DE ALIENACAO INFORMADA PELA FINANCEIRA."
	},
	"restricoes":[
		"ALIE.FIDUCIARIA => CNPJ :. 00.000.000/0000-00",
		"JUDICIAL => RENAJUD:TJAM/00000-P.00000000000000000000-BLOQ.LICENCIAMENTO",
		"JUDICIAL => RENAJUD:TJAM/00000-P.00000000000000000000-BLOQ.TRANSFERENCIA"
	],
	"debitos":{
		"taxas": 64.13,
		"multasOutrasUfs": 0.00,
		"seguroObrigatorio": 5.23,
		"total": 69.36
	},
	"licenciamento":{
		"valoresPagar":{
				"totalTaxas": 64.13,
				"multasLocais": 0.00,
				"multasOutrasUfs": 0.00,
				"seguroObrigatorio": 5.23,
				"ipvaCotaUnica": 542.86
		},
		"status": "Valores a pagar",
		"total": 612.22
	},
	"multas":[
		{
			"autoInfracao": "AJ00000000",
			"situacao": "Multa Paga",
			"orgaoEmissor": "202550/AM",
			"descricao": "7463 - 0 / TRANSITAR EM VELOCIDADE SUPERIOR A MAXIMA PERMITIDA EM MAIS DE 20% ATE 50%.",
			"dataHoraInfracao": "30/12/2012 23:23",
			"vecimentoPagamento": "30/12/2013",
			"valor": 127.69,
			"infrator": "",
			"local": "RUA TAPAJOS PROXIMO...",
			"placa": "AAA0000",
			"codigoRenainf": "0",
			"municipio": "MANAUS/AM",
			"dataNotificacao": "30/01/2013",
			"limiteDefesa": "30/07/2013",
			"limiteApresentacaoCondutor": "30/07/2013",
			"defesaPrevia": "Não há registro de defesa prévia.",
			"dataEmissao":"30/08/2013",
			"limiteRecurso": "30/09/2013",
			"recursoJari": "Não há registro de recurso à JARI."
		}
	]
}

Resposta com erro

Chassi ou renavam inválido:

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

Veículo transferido:

{
    "status":"erro",
    "mensagem":"Veículo transferido de jurisdição"
}