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, placacarroceria, marca, anomodelo, cor, entre outros
débitos de , IPVA, infrações, taxa de licenciamento e seguro DPVAT., penalidades recursos, entre outros
Veja mais informações em nossa central de ajuda: Detran MA - Dados do Veículo
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/detran-ma/veiculos/dados-veiculo
...
| Include Page | ||||
|---|---|---|---|---|
|
Parâmetros do header
Nome | Tipo | Obrigatório? | Descrição |
|---|---|---|---|
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
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 |
Somente se o renavam não for informado
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
|
Status 422
|
|
|
|
|
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, 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.
| Code Block | ||
|---|---|---|
| ||
{
"placa": "AAA0000ABC1234",
"renavam": "999999999112233444",
"marcaplacaAnterior": "FORDV.NOVO /MA",
"modelomarcaModelo": "FIESTA112233 - VOLVO/FH 460 6X4T",
"cor": "PRATA4 - PRETA",
"proprietario": "EMPRESA LTDA",
"documentoProprietario": "NOME DO PROPRIETÁRIO",
"municipio": "ITAPECURU MIRIM",
"anoFabricacao": "2002",
"anoModelo": "2003",
"dataHoraConsulta": "01/01/2020 16:18:27",
"ultimoLicenciamento": "2019",
"possuiRestricao": "Não",
"debitos": {
"mensagem": "Nenhum du00e9bito encontrado",
"itens": [
{
"descricao": "TAXA LICENCIAMENTO.:PARCELA UNICA",
"exercicio": "2020",
"situacao": "Vencido",
"vencimento": "08/06/2020",
"valor": 85.00
},
{
"descricao": "INFRACAO ESTADUAL , AUTO: AAA9999999",
"exercicio": "2020",
"situacao": "Vencido",
"vencimento": "05/01/2018",
"valor": 220.27
}
]
}
"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
| Code Block | ||
|---|---|---|
| ||
{
"status":"erro",
"mensagem":"RENAVAM/CHASSI NÃO EXISTE.Operação cancelada. Veículo não emplacado na base local"
} |