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.
Veja mais informações em nossa central de ajuda: Detran AP - Consulta de Veículos
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 |
---|---|---|---|
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
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
{ "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:
{ "status":"erro", "mensagem":"Nenhum valor encontrado para as informações solicitadas." }