Detran MT - Consulta Veículo

O que é#

Na consulta Detran MT - Consulta Veículo você verifica informações e restrições de um veículo com placa registrada no Mato Grosso:

informações como marca, modelo, categoria, cor, ano de fabricação
se possui débitos, restrições, multas

Sobre a requisição#

Método: POST

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

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	Sim	Renavam do veículo a ser pesquisado.
cpfCnpj	string	Sim	CPF ou CNPJ do proprietário 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

A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.

JSON

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

Status 422

Significa que ocorreu um erro de validação dos dados enviados.

JSON

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

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

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".
- As mensagens são exibidas exatamente como retornadas da fonte original.

Resposta com registro encontrado

JSON

{
  "placa": "ABC1234",
  "renavam": "99999999999",
  "placaAnterior": "XYZ9876/MT",
  "tipo": "13-CAMIONETA",
  "categoria": "1-Particular",
  "especie": "3-Misto",
  "lugares": "5",
  "marca": "201423-I",
  "modelo": "BMW X1 SDRIVE1.8I VL31(Importado)",
  "anoFabricacao": "2012",
  "anoModelo": "2013",
  "potencia": "150",
  "combustivel": "2-Gasolina",
  "cor": "11-PRETA",
  "carroceria": "999-NENHUMA",
  "nomeProprietario": "FULANO DE TAL",
  "situacaoLacre": "Lacrado conforme Portaria 272/2007/DENATRAN",
  "proprietarioAnterior": "BELTRANO DE TAL",
  "origemDadosVeiculo": "CADASTRO",
  "municipioEmplacamento": "CUIABA",
  "licenciadoAte": "2020 em 01/01/2020, Licenciamento Anual (CRLV emitido por DETRANNET) (Via 1)",
  "adquiridoEm": "01/01/2020",
  "situacao": "Em circulação",
  "restricaoVenda": "Alienação Fiduciária em favor de BANCO EXEMPLO S.A.",
  "informacoesPendentes": "Registro de Baixa de Alienação Fiduciária informado ...",
  "impedimentos": "Nenhum impedimento registrado até esta data",
  "dividaAtivaLicenciamento": "Nenhuma informação registrada até esta data",
  "tipoAvaria": "Media Monta",
  "debitos": {
    "mensagem": "",
    "itens": [
      {
        "descricao": "P.EXEMPLO-000000-SG0000000-0000/00(TRANSITAR/VELOCIDADE SUPERIOR A MAXIMA EM ATE 20%)",
        "vencimento": "01/01/2020",
        "nominal": 130.16,
        "corrigido": 130.16,
        "desconto": 0,
        "juros": 1.61,
        "multa": 1.3,
        "atual": 133.07
      }
    ],
    "total": 264.36
  },
  "infracoesAutuacao": {
    "mensagem": "",
    "itens": [
      {
        "numAuto": "P.EXEMPLO-000000-SG0000000-0000/00 Renainf: 0000000000 Em aberto",
        "descricao": "TRANSITAR/VELOCIDADE SUPERIOR A MAXIMA EM ATE 20% Em CUIABA no dia 01/01/2020 às 15:40",
        "localComplemento": "Av. Exemplo, 123",
        "valor": 130.16
      }
    ]
  },
  "multas": {
    "mensagem": "",
    "itens": [
      {
        "numeroAuto": "P.EXEMPLO-000000-SG0000000-0000/00 Renainf: 0000000000 Em aberto",
        "descricao": "TRANSITAR/VELOCIDADE SUPERIOR A MAXIMA EM ATE 20% Em CUIABA no dia 01/01/2020 às 10:03",
        "localComplemento": "Av. Exemplo, 123",
        "valor": 130.16
      }
    ]
  },
  "debitosMultasConveniados": {
    "mensagem": "Nenhum débito em aberto cadastrado para este veículo.",
    "itens": [
      {
        "orgaoAutuador": "PREFEITURA DE CUIABA - MT",
        "numeroAuto": "F00000000",
        "dataInfracao": "01/01/2020 16:24",
        "vencimento": "01/01/2020",
        "valor": 85.13,
        "dataInclusao": "01/01/2020 22:06"
      }
    ],
    "total": 0
  },
  "recursoInfracao": {
    "mensagem": "",
    "itens": [
      {
        "processo": "JARI: 0000/2020 Em 01/01/2020 ",
        "numeroProcesso": "",
        "numeroAuto": "P.EXEMPLO-0000000-L000000000-0000/00",
        "detalhamentoInfracao": "TRANSITAR/VELOCIDADE SUPERIOR A MAXIMA EM ATE 20% Em CUIABA no dia 01/01/2020 às 1035 AV EXEMPLO...",
        "resultadoProcesso": "Recurso deferido em 01/01/2020 - Homologado em 01/01/2020"
      }
    ]
  },
  "ultimoProcesso": {
    "numero": "00000000/2020",
    "interessado": "000.000.000-00",
    "servicos": [
      {
        "servico": "Transferência de Propriedade",
        "operacao": "01/01/2020 às 17:38h"
      }
    ]
  },
  "recalls": {
    "mensagem": "",
    "itens": [
      {
        "id": "9999999999",
        "nome": "RELÉS DA UNIDADE DE DISTRIBUIÇÃO DE POTÊNCIA",
        "defeito": "OS RELÉS DE IGNIÇÃO E DE INJEÇÃO DA PDU COM MAU CONTATO...",
        "ataRegistro": "01/01/2020",
        "prazoServico": "01/01/2020 a 01/01/2021",
        "situacao": "BAIXADO",
        "concessionaria": "0000000000 - NOME DA CONCESSIONÁRIA",
        "realizadoEm": "01/01/2020",
        "dataInclusao": "01/01/2020 03:00:17"
      }
    ]
  },
  "historicoImpedimentosVeiculo": {
    "mensagem": "",
    "itens": [
      {
        "impedimento": "Comunicação de venda para EMPRESA EXEMPLO LTDA em 01/01/2020",
        "tribunal": "",
        "processo": null,
        "tipoBloqueio": "Licenciamento",
        "situacao": "Baixado em 01/01/2020",
        "buscaApreensao": null,
        "orgaoJudiciario": null,
        "complemento": null,
        "dataInclusao": "01/01/2020 14:55",
        "observacao": ""
      }
    ]
  },
  "pdf": "JVBER"
}

Resposta com erro

Renavam inválido:

JSON

{
  "status": "erro",
  "mensagem": "Renavam informado não confere com a Placa."
}

Veículo de outro estado ou placa e renavam inválidos:

JSON

{
  "status": "erro",
  "mensagem": "Veículo não Cadastrado no DETRAN/MT."
}