Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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:

...

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

...

Include Page
URL Base
URL Base

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

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

...

Code Block
{
  "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

...

  • 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.

Code Block
languagejson
{
  "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..."
}

...

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

Placa, CPF ou CNPJ inválido:

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