Detran RO - Consulta de Veículos

O que é#

Na consulta Detran RO - Consulta de Veículos - você verifica informações e a situação de um veículo com placa registrada em Rondônia. As informações incluem:

placa, cidade, ano, cor e outras em geral,
se possui débitos,
gravame, pendências SNG e dados de licenciamento (CRLV), quando informado o renavam.

Pesquisa sem débitos:

Você pode fazer a pesquisa usando apenas a placa, mas não trará os débitos do veículo.

Pesquisa com débitos:

Você precisa fazer a pesquisa informando a placa e o renavam do veículo.

Sobre a requisição#

Método: POST

Endereço: https://api.plexi.com.br/api/maestro/detran-ro/veiculos/consulta-veiculo

URL Base: https://api.plexi.com.br/

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
placa	string	Sim	Placa do veículo a ser pesquisado.
renavam	string	Não, utilizado para consultar os debitos	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

JSON

{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

Status 422

JSON

{
  "message": "The given data was invalid.",
  "errors": {
    "placa": [
      "O campo placa é obrigatório."
    ]
  }
}

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

Resposta com registro encontrado

Resposta simplificada: informando na busca a placa do veículo.

JSON

{
    "placa": "ABC1234",
    "marcaModelo": "SR/NOMA SR2E20RT2 CG",
    "chassi": "***********111",
    "cor": "BRANCA",
    "anoFabricacao": "2022",
    "cidade": "VILHENA",
    "uf": "RO",
    "situacao": "Em Circulação",
    "mensagemFurtoRoubo": "Veículo sem ocorrência de Roubo/Furto",
    "furtoRoubo": false,
    "debitos": null,
    "restricoes": null,
    "gravame": null,
    "pendenciasSng": null,
    "crlv": null,
    "pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7..."
}

Resposta completa: informando na busca placa e renavam do veículo.

JSON

{
    "placa": "ABC1234",
    "marcaModelo": "SR/NOMA SR2E20RT2 CG",
    "chassi": "***********111",
    "cor": "BRANCA",
    "anoFabricacao": "2022",
    "cidade": "VILHENA",
    "uf": "RO",
    "situacao": "Em Circulação",
    "mensagemFurtoRoubo": "Veículo com ocorrência de Roubo/Furto Em: 26/11/2018",
    "furtoRoubo": true,
    "debitos": {
        "mensagem": null,
        "itens": [
            {
                "descricao": "Licenciamento Anual 2022",
                "dataVencimento": "29/04/2022",
                "valor": 189.59,
                "corrigido": 189.59,
                "desconto": 0,
                "juros": 0,
                "multa": 0,
                "atual": 189.59
            }
        ]
    },
    "restricoes": [
        "1. OBSERVACAO NO DOCUMENTO",
        "2. SO PODE TRANSF P/ RO AP AM RR AC"
    ],
    "gravame": "Alienação Fiduciária em favor de BANCO EXEMPLO S.A(CNPJ:99.999.999/9999-99)",
    "pendenciasSng": "Nenhuma informação pendente até esta data.",
    "crlv": {
        "ultimaExpedicao": {
            "descricao": "2022 em 01/01/2022, Licenciamento Anual (CRLV Gerado por DETRAN_NT\\ServicosDetran)(Via 1)",
            "ano": "2022",
            "data": "01/01/2022",
            "tipo": "Licenciamento Anual",
            "via": 1
        },
        "anoLicenciamento": "2022",
        "mensagem": null
    },
    "pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7..."
}

Campos de gravame, pendências SNG e licenciamento (CRLV)

Retornados apenas quando a pesquisa informa o renavam. Na pesquisa somente com a placa, gravame, pendenciasSng e crlv vêm como null.

Campo	Tipo	Descrição
gravame	string \| null	Texto do campo "Informações" exibido pelo Detran RO, por exemplo a alienação fiduciária com a instituição financeira ou `Sem gravame`. `null` quando o campo não é exibido.
pendenciasSng	string \| null	Texto das "Informações pendentes originadas das financeiras via SNG", por exemplo `Nenhuma informação pendente até esta data.` `null` quando o campo não é exibido.
crlv	object \| null	Dados do bloco CRLV-Digital. `null` quando o Detran RO não exibe o bloco para o veículo.
crlv.ultimaExpedicao	object \| null	Última expedição do CRLV. `null` quando essa linha não é exibida.
crlv.ultimaExpedicao.descricao	string	Texto da última expedição, como exibido pelo Detran RO.
crlv.ultimaExpedicao.ano	string \| null	Ano da última expedição.
crlv.ultimaExpedicao.data	string \| null	Data da última expedição (dd/mm/aaaa).
crlv.ultimaExpedicao.tipo	string \| null	Tipo da expedição, por exemplo `Licenciamento Anual`.
crlv.ultimaExpedicao.via	integer \| null	Número da via.
crlv.anoLicenciamento	string \| null	Ano do licenciamento.
crlv.mensagem	string \| null	Mensagem sobre o envio do CRLV-e, quando o Detran RO exibe um erro de envio. `null` quando não há mensagem.

Os subcampos ano, data, tipo e via vêm como null quando não for possível extraí-los da descrição; o texto completo permanece em descricao.

Exemplo do campo crlv quando o Detran RO exibe erro no envio do CRLV-e:

JSON

{
    "crlv": {
        "ultimaExpedicao": {
            "descricao": "2021 em 01/01/2021, Licenciamento Anual (CRLV Gerado por DETRAN_NT\\ServicosDetran)(Via 1)",
            "ano": "2021",
            "data": "01/01/2021",
            "tipo": "Licenciamento Anual",
            "via": 1
        },
        "anoLicenciamento": "2022",
        "mensagem": "Houve um erro ao enviar CRLVE Mensagem: VEÍCULO ALUGUEL, AUTORIZAÇÃO REGISTRO NÃO ENCONTRADA"
    }
}

Resposta com erro

Veículo não encontrado, placa ou renavam incorretos:

JSON

{
  "status": "erro",
  "mensagem": "Veículo não encontrado na base do detran-ro"
}