Detran PI - Situação do veículo

O que é

Na consulta Detran PI - Situação do veículo - você verifica informações e a situação de um veículo com placa registrada no Piauí: débitos do detran, multas, situação do IPVA e do licenciamento.

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-pi/veiculos/situacao-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
placa	string	Sim	Placa do veículo a ser pesquisado.
renavam	string	Sim	Renavam do veículo a ser pesquisado.

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": {
    "placa": [
      "O campo placa é obrigatório."
    ],
    "renavam": [
      "O campo renavam é obrigatório."
    ]
  }
}

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

Resposta com registro encontrado

{
    "placa": "AAA1A11",
    "renavam": "0000000000",
    "chassi": "00A000A00000000",
    "marcaModelo": "SR/GUERRA AG GR",
    "cor": "CINZA",
    "anoFabricacaoModelo": "2014 / 2015",
    "tipo": "S.REBOQUE",
    "combustivel": "******",
    "categoria": "ALUGUEL",
    "especie": "CARGA",
    "nacionalidade": "NACIONAL",
    "rouboFurto": "NADA CONSTA",
    "potenciaCilindrada": "000 / 0000",
    "capacidade": "000",
    "municipio": "PIRACURUCA - PI",
    "situacao": "EM CIRCULACAO",
    "ultimoLicenciamento": "2024",
    "restricao": "ALIENACAO FIDUCIARIA",
    "debitos": [
        {
            "itens": [
                {
                    "tipo": "Taxa de Licenciamento",
                    "vencimento": "2025-03-31",
                    "valor": 189.6
                }
            ],
            "total": 212.35,
            "ano": "2025"
        }
    ],
    "infracoes": {
        "itens": [
            {
                "situacao": "Vencidas",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": "sem direito a desconto"
            },
            {
                "situacao": "Não Vencidas",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": 0
            },
            {
                "situacao": "Sub Judice",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": "sem informação"
            },
            {
                "situacao": "Parceladas",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": "sem direito a desconto"
            },
            {
                "situacao": "Notificação de Autuação",
                "quantidade": 1,
                "valor": 130.16,
                "valorComDesconto": 104.13
            }
        ],
        "total": 130.16
    },
    "pdf": "..."
}

Resposta com erro

Veículo não cadastrado:

{
  "status":"erro",
  "mensagem":"Veículo não cadastrado",
  "pdf": "JVBER..."
}