Detran TO - Consulta Veículo

O que é

Na consulta Detran TO - Consulta Veículo - você verifica informações e restrições de um veículo com placa registrada na Paraíba:

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

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

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-to/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	Sim	Renavam do veículo a ser pesquisado.
cpfCnpj	string	Sim	CPF ou CNPJ do proprietário do veículo , com ou sem máscara. Exemplos: 99999999999 ou 999.999.999-99

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

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

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

{
  "endpoint": "detran-to-veiculos-consulta-veiculo",
  "placa": "AAA0000",
  "renavam": "00000000000",
  "placaAnterior": "AAAA0000/TO",
  "tipo": "17-CAMINHAO TRATOR",
  "categoria": "2-ALUGUEL",
  "especie": "5-TRACAO",
  "lugares": "2",
  "marca": "315254-SCANIA",
  "modelo": "G 420 A4X2 (Nacional)",
  "anoFabricacao": "2010",
  "anoModelo": "2010",
  "potencia": "420",
  "combustivel": "3-DIESEL",
  "cor": "15-VERMELHA",
  "carroceria": "999-NAO APLICAVEL",
  "restricoes": {
    "mensagem": "",
    "itens": [
      "Alienação Fiduciária em favor de ..."
    ]
  },
  "informacoesPendentes": {
    "mensagem": "Nenhuma informação pendente até esta data",
    "itens": []
  },
  "impedimentos": {
    "mensagem": "Nenhum impedimento registrado até esta data",
    "itens": []
  },
  "crlv": "",
  "debitos": [
        {
            "descricao": "UF:RD-000000-T000000000-0000/00",
            "vencimento": "01/07/2019",
            "nominal": 195.23,
            "corrigido": 195.23,
            "desconto": 0.00,
            "juros": 0.00,
            "multa":0.00,
            "atual": 195.23
        }
  ],
  "infracoesAutuacao": {
    "mensagem": "",
    "itens": [
      {
        "numeroAuto": "UF:RD-000000-T000000000-0000/00 Renainf: 0000000000 Em aberto",
        "descricao": "CONDUZIR VEIC COM VIDRO TOTAL/PARCIALMENTE COBERTO POR PELÍCULA... no dia 19/12/2016 às 09:10",
        "local": "BR-316 KM-297 UF-PI",
        "valor": 195.23
      },
      {
        "numeroAuto": "UF:RD-000000-T000000000-0000/00 Renainf: 0000000000 Em aberto",
        "descricao": "CONDUZIR VEIC COM VIDRO TOTAL/PARCIALMENTE COBERTO POR PELÍCULA... no dia 11/09/2020 às 08:52",
        "local": "BR-153 KM-332 UF-TO",
        "valor": 195.23
      }
    ]
  },
  "multas": {
    "mensagem": "Nenhuma multa em aberto cadastrada para este veu00edculo atu00e9 o momento.",
    "itens": [
        {
            "numeroAuto":" UF:RD-000100-T126416087-6645/00 Renainf: 2843264286  Em aberto",
            "descricao": "CONDUZIR O VEICULO COM EQUIP OBRIGATÓRIO EM DESACORDO COM O ESTAB PELO CONTRAN Em IBOTIRAMA no dia 01/09/2017 às 20:20",
            "local":"BR-242 KM-582 UF-BA",
            "valor": 195.23
        }        

    ]
  },
  "recursosInfracao": {
    "mensagem": "",
    "itens": [
        {
            "numeroAuto":"",
            "descricao": "",
            "local":"",
            "valor": 0.00
        }

    ]
  },
  "pdf": "JVBER..."
}

Resposta com erro

Renavam inválido:

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

CPF ou CNPJ inválido:

{
  "status":"erro",
  "mensagem":"Dados não conferem."
}