Versions Compared

Key

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

O que é

Na consulta Detran AC - Emissão dos Débitos do Veículo - você verifica informações e a situação de um veículo com placa registrada no Acre:

...

Veja mais informações em nossa central de ajuda: Detran AC - Emissão dos Débitos do Veículo

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-ac/veiculos/emissao-debitos-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.

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

Status 422

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

Code Block
languagejson
{
    "endpoint": "detran-ac-veiculos-emissao-debitos-veiculo",
    "placa": "AAA0000",
    "renavam": "99999999999",
    "chassi": "000000000AV000000",
    "marca": "HONDA",
    "modelo": "CG 125 TITAN KS",
    "cor": "",
    "anoFabricacao": "2001",
    "anoModelo": "2001",
    "tipo": "MOTOCICLO",
    "combustivel": "GASOLINA",
    "potencia": "000",
    "cilindradas": "0124",
    "categoria": "PARTICULAR",
    "capacidadePassageiros": "002",
    "especie": "PASSAGEIRO",
    "nacionalidade": "NACIONAL",
    "municipio": "RIO BRANCO - AC",
    "rouboFurto": "NADA CONSTA",
    "situacao": "EM CIRCULACAO",
    "anoUltimoLicenciamento": "2014",
    "restricoes": [
        "SEM RESTRICAO",
        "SEM RESTRICAO",
        "SEM RESTRICAO",
        "SEM RESTRICAO"
    ],
    "taxaLicenciamento": {
        "mensagem": "",
        "dados": [
            {
                "ano": "2019",
                "vencimento": "30/04/2019",
                "valor": 149.87,
                "valorPago": 0,
                "valorDiferenca": 149.87
            },
            {
                "ano": "2020",
                "vencimento": "30/04/2020",
                "valor": 136.2,
                "valorPago": 0,
                "valorDiferenca": 136.2
            }
        ]
    },
    "ipva": {
        "mensagem": "",
        "dados": [
            {
                "ano": "2019",
                "vencimento": "28/02/2019",
                "valor": 24.92
            },
            {
                "ano": "2020",
                "vencimento": "28/02/2020",
                "valor": 23.11
            }
        ]
    },
    "dpvat": {
        "mensagem": "",
        "dados": [
            {
                "ano": "2019",
                "vencimento": "28/02/2019",
                "valor": 84.58
            },
            {
                "ano": "2020",
                "vencimento": "28/02/2020",
                "valor": 12.3
            }
        ]
    },
    "infracoes": {
        "mensagem": "Não existem débitos de Multas até o presente momento",
        "dados": [
            {
                "situacao": "Vencidas",
                "quantidade": 1,
                "valor": 314.54,
                "valorComDesconto": 0
            },
            {
                "situacao": "A vencer",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": 0
            },
            {
                "situacao": "Sub judice",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": 0
            },
            {
                "situacao": "Parceladas",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": 0
            },
            {
                "situacao": "Notificação de Autuação",
                "quantidade": 0,
                "valor": 0,
                "valorComDesconto": 0
            }
        ]
    },
    "valorTotalTaxaLicenciamento": 885.55,
    "valorTotalIpva": 48.03,
    "valorTotalDpvat": 96.88,
    "valorTotalInfracoes": 314.54
}

Resposta com erro

Chassi ou renavam inválido:

Code Block
languagejson
{
    "status":"erro",
    "mensagem":"Veículo não encontrado"
}

O site não mostra mensagem de erro. Quando o veículo não é encontrado, a tela de resultados é mostrada com todos os campos em branco.

O Plexi se comporta da mesma forma, repassando as informações que recebe do site.

Quando um veículo não é encontrado ou alguma informação foi enviada incorretamente, o Plexi retorna os campos da API em branco e um conteúdo em PDF igual ao conteúdo mostrado na tela.