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.

Sobre a requisição:

Método: POST

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

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": []
        },
        "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:

Código de segurança incorreto: