Detran SE - Consulta Dados de Veículo

O que é

Na consulta Detran SE - Consulta Dados de Veículo - você verifica informações e a situação de um veículo com placa registrada no Sergipe:

proprietário, placa, modelo, marca,
pagamentos mais recentes e débitos de IPVA, taxa de licenciamento,
se possui autuações, multas, restrições, comunicado de venda, registro de roubo.

Veja mais informações em nossa central de ajuda: Detran SE - Consulta Dados de Veículo

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-se/veiculos/consulta-dados-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
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
codigo	string	Sim	Código de segurança, informado no documento do veículo

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."
    ]
  }
}

Resposta com registro encontrado

Observações:

Informações relacionadas a débitos são apresentadas de 2 formas:
- A propriedade “itens“ apresenta os débitos, quando existem
- A propriedade “mensagem“ exibe alguma mensagem quando não há débitos. Exemplos de mensagens: “Nenhuma observação encontrada“, “Nenhuma restrição encontrada“.
- A propriedade “mensagem“ é preenchida quando o objeto de débitos relacionados é vazio. Da mesma forma, quando o objeto de débitos possui informação, a propriedade “mensagem“ é vazia.
- As mensagens são exibidas exatamente como retornadas da fonte original.

{
    "renavam": "999999999",
    "placa": "AAA0000",
    "proprietario": "NOME DO PROPRIETÁRIO",
    "proprietarioAnterior": "NOME DO PROPRIETÁRIO ANTERIOR",
    "placaAnterior": "",
    "municipio": "NOME DO MUNICÍPIO",
    "especie": "CARGA",
    "tipo": "CAMINHAO",
    "combustivel": "DIESEL",
    "dataAquisicao": "01/01/2017",
    "marca": "M.BENZ",
    "modelo": "ATRON 2324",
    "anoFabricacao": 2015,
    "anoModelo": 2015,
    "capacidade": "3",
    "potencia": "238",
    "categoria": "ALUGUEL",
    "cor": "AZUL",
    "numeroLacre": "99999999",
    "ultimoLicenciamento": "2019",
    "ultimaEmissaoLicenciamento": "30/12/2019 (CRLV ENVIADO PARA OS CORREIOS EM 20/09/2019 CR RS999999999BR )",
    "rouboFurto": "NAO POSSUI ROUBO/FURTO",
    "principalCondutor": "** NAO POSSUI REGISTRO PRINCIPAL CONDUTOR",
    "observacoes": "",
    "multas": [
        {
            "auto": "E999999999",
            "data": "01/01/2016",
            "orgaoAutuador": "DPRF",
            "competencia": "DPRF",
            "situacao": "PAGO",
            "valor": 127.69
        },
    ],
    "valorTotalMultasPagar": 0,
    "restricoes": {
        "financeira": {
            "mensagem": "",
            "dados": {
                "descricao": "ALIEN. FIDUC.",
                "tipo": "3",
                "placa": "AAA9999",
                "licenciamentoUf": "SE",
                "anoModelo": "2015",
                "identificacaoRemarcacaoChassi": "2",
                "anoFabricacao": "2015",
                "dataSituacao": "01/01/2019",
                "horaSituacao": "01:00",
                "gravameNumero": "999999",
                "gravameUf": "SE",
                "informacaoRestricao": "FINANCEIRA",
                "detranUf": "",
                "contratoNumero": "999999999999",
                "contratoData": "01/01/2015",
                "financiado": "FINANCIADO...",
                "cpf": "000 ... 000",
                "nomeAgenteFinanceiro": "BANCO MERCEDES-BENZ DO BRASIL SA",
                "codAgenteFinanceiro": "999",
                "cnpjAgenteFinanceiro": "99999999999999",
                "registroContrato": "2",
                "situacao": "VEICULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO"
            }
        },
        "judiciais": {
            "mensagem": "Veículo não possui restrições judiciais.",
            "dados": null
        },
        "outras": {
            "mensagem": "Veíulo não possui outros tipos de restrições",
            "dados": []
        }
    },
    "debitos": {
        "mensagem": "** VEICULO JA LICENCIADO (CRLV JA EMITIDO)",
        "itens": []
    }
}

Resposta com erro

Veículo não encontrado:

{
  "status": "erro",
  "mensagem": "** 2- PLACA NAO INFORMADA PARA VERIFICACAO DE MULTAS, VEICULO NAO PERTENCE A SERGIPE"
}

Código de segurança incorreto:

{
  "status": "erro",
  "mensagem": "** CODIGO DE SEGURANCA NAO ASSOCIADO AO VEICULO"
}