View Source

O que é

Na consulta Detran MA - Dados do Veículo - você verifica informações e a situação de um veículo com placa registrada no Maranhão:

proprietário, carroceria, modelo, cor, entre outros
débitos, IPVA, infrações, taxa de licenciamento, penalidades recursos, entre outros

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/detran-ma/veiculos/dados-veiculo

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
renavam	string	Sim	Renavam do veículo a ser pesquisado.
placa	string	Sim	Placa 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

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

Status 422

{
  "message": "The given data was invalid.",
  "errors": {
    "placa": [
      "O campo placa é obrigatório."
    ],
    "renavam": [
      "O campo ranavam é 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, IPVA, infrações, recursos e penalidades 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“.
- A propriedade “mensagem“ é preenchida quando o objeto de débitos relacionados é vazio. Da mesma forma, quando o objeto de débitos possui informação, a propriedade “mensagem“ é vazia.
- As mensagens são exibidas exatamente como retornadas da fonte original.

{
    "placa": "ABC1234",
    "renavam": "112233444",
    "placaAnterior": "V.NOVO /MA",
    "marcaModelo": "112233 - VOLVO/FH 460 6X4T",
    "cor": "4 - PRETA",
    "proprietario": "EMPRESA LTDA",
    "documentoProprietario": "11223344555666",
    "carroceria": "999 - NAO APLICAVEL/NENHUMA",
    "licenciadoAte": "2022 em 27/05/2021, Licenciamento Anual",
    "tipo": "17 - CAM.TRATOR",
    "especie": "5 - TRACAO",
    "impedimentos": "Alienação Fiduciária em favor de EMPRESA X S/A (CNPJ:00.000.000/0000-00)",
    "categoria": "2 - ALUGUEL",
    "lugares": "2",
    "potencia": "460",
    "dataAdquiridoEm": "30/01/2018",
    "informacoesFinanceiraSng": "Nenhuma informação pendente até esta data",
    "informacoesAdicionais": "Nenhuma informação adicional até esta data",
    "debitos": {
        "mensagem": null,
        "itens": [
            {
                "descricao": "15/09/2021-UF:RD-000000-T000000000-0000-0-TRANSITAR EM DESACORDO C/ AUTORIZAÇÃO EXPEDIDA P/VEÍCULO C/ DIMENSÕES EXCEDENTES  Venc. 15/04/2030",
                "dataVencimento": "15/04/2022",
                "nominal": 195.23,
                "corrigido": 195.23,
                "desconto": 0,
                "juros": 0,
                "multa": 0,
                "atual": 195.23
            },
            {
                "descricao": "LICENCIAMENTO DO VEICULO 2022",
                "dataVencimento": "20/05/2022",
                "nominal": 85,
                "corrigido": 85,
                "desconto": 0,
                "juros": 0,
                "multa": 0,
                "atual": 85
            }
        ]
    },
    "debitosEmAutuacao": {
        "mensagem": null,
        "itens": [
            {
                "descricao": "07/08/2014-:RD-000000-T000000000-0000-0 transitar pela contramão de direção em via com duplo sentido de circulação. Venc. 24/11/2014",
                "dataVencimento": "17/03/2050",
                "nominal": 127.69,
                "desconto": 25.54,
                "atual": 102.15
            }
        ]
    },
    "ipva": {
        "mensagem": null,
        "itens": [
            {
                "chassi": "ABCDEFGHIZK12345",
                "ano": "2022",
                "dataLancamento": "02/01/2022",
                "dataVencimento": "20/04/2022",
                "dataPagamento": "",
                "valor": 0,
                "situacao": "DEBITO EM ABERTO"
            }
        ]
    },
    "infracoesEmAutuacao": {
        "mensagem": null,
        "itens": [
            {
                "numeroAuto": "26/06/2021-UF:RD-000000-T000000000-0000-0- Transitar c/ veíc e/ou carga c/ dimensões superior LIMITE LEGAL S/ AUTORIZACAO Renainf: 00000000 Em Aberto",
                "descricao": "TRANSITAR C/VEIC/CARGA C/DIMENS SUPERIOR LIMITE LEGAL AUT.",
                "localComplemento": "TO 336 KM 01 Em COUTO MAGALHAES no dia 26/06/2021 07:18",
                "valor": 195.23
            }
        ]
    },
    "penalidadesMultas": {
        "mensagem": null,
        "itens": [
            {
                "numeroAuto": "01/01/2022-UF:RD-000000-T000000000-0000-0-TRANSITAR EM DESACORDO  C/ AUTORIZAÇÃO EXPEDIDA P/VEÍCULO C/ DIMENSÕES EXCEDENTES Renainf: 00000000 Em Aberto",
                "descricao": "TRANSITAR DESACORDO C/ AUTORIZ EXPEDIDA P/VEÍC.C/DIM EXCEDE",
                "localComplemento": "BR-999 KM-999 UF-MA Em CAXIAS no dia 15/09/2021 10:50",
                "valor": 195.23
            }
        ]
    },
    "recursosInfracao": {
        "mensagem": "Nenhuma recurso cadastrado para este veículo até o momento",
        "itens": []
    },
    "pdf": "...",
}

Resposta com erro

{
  "status":"erro",
  "mensagem":"Operação cancelada. Veículo não emplacado na base local"
}