Detran RS - Consulta Individual de Veículo

O que é

Consulta pública sobre informações de situações de veículos cadastrados no Detran do Rio Grande do Sul.

Veja mais informações em nossa central de ajuda: Detran RS - Consulta Individual de Veículo.

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-rs/veiculos/consulta-individual-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.

Estrutura da resposta

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 quando você faz a requisição:

Status 201

Status 422

Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )

Resposta com registro encontrado

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 { "marca": "FORD", "modelo": "ECOSPORT FSL1.6FLEX", "renavam": "99999999", "placa": "AAA0000", "municipio": "PORTO ALEGRE", "tipo": "Camioneta", "especie": "Misto", "chassi": "9A9A99999AAAAA99990", "situacao": "Em circulação", "furtado": false, "emDeposito": false, "anoFabricacao": 2013, "anoModelo": 2013, "cpfProprietario": "99999999999", "cor": "Preta", "validadeUltimoLicenciamento": "30/04/2017", "dataUltimoLicenciamento": "27/01/2017", "ipva": [ { "vencimento": "06/04/2020", "valorOriginal": 932.38, "exercicio": 2020, "dividaAtiva": true, "situacao": "Com DAT" } ], "infracoes": [ { "orgaoAutuador": 999999, "serie": "E99999999", "dataHora": "31/03/2020 14:46", "descricao": "TRANSITAR EM VELOCIDADE SUPERIOR À MÁXIMA PERMITIDA EM ATÉ 20%", "valor": 130.16, "local": "AV XXX, 843 - SANTA ISABEL", "pontuacao": 4, "situacao": "A Vencer" } ], "licenciamento": { "codigoSegurancaCrlv": null, "descricaoDocumento": "CRLV", "crlve": false, "exercicio": 2016, "fac": false, "codigoRastreamentoSedex": "AA999999999BR", "postadoCorreios": "27/01/2017", "situacaoDocumento": "Documento entregue ao destinatário" }, "restricoes": [ { "descricao": "SNG - Alienação Fiduciária", "campos": [ { "nome": "Data do Contrato", "valor": "20/04/2011" } ] } ], "dpvat": [ { "exercicio": "2020", "valor": 5.23, "situacao": "Seguro não pago" }, { "exercicio": "2019", "valor": 16.21, "situacao": "Seguro não pago" } ], "pdf":"..." }

Resposta com erro

Placa não encontrada:

1 2 3 4 { "status": "erro", "mensagem": "Nenhum veículo encontrado com os critérios informados." }

Renavam inválido:

1 2 3 4 { "status": "erro", "mensagem": "O Código RENAVAM informado não é deste veículo." }

Placa incorreta e renavam correto:

1 2 3 4 { "status": "erro", "mensagem": "A placa do veículo é: AAA0000. Informe esta placa para efetuar a consulta." }