## DETRAN / MA / Licenciamento
Consulta e emite guias (boletos) dos débitos de licenciamento de veículos do estado do Maranhão.


### Site URL
- http://www.detran.ma.gov.br/

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/detran/ma/licenciamento`



| Parameter | Description                                                 |
| --------- | ----------------------------------------------------------- |
| token*    | The token that will authenticate and authorize the request. |
| placa*    | License plate of the vehicle to be queried.                 |
| renavam*  | RENAVAM of the vehicle to be queried.                       |

> * Required parameter.

> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.


### Response examples (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "product": "Consultas",
    "service": "detran/ma/licenciamento",
    "parameters": {
      "placa": "AAA1111",
      "renavam": "1111111111"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.24",
    "requested_at": "2022-02-07T11:28:03.000-03:00",
    "elapsed_time_in_milliseconds": 799,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX19s3kuT2ts8VXF1ufDE89TqIPOyTVcdE1RTgZDWDCbMeDzL6FECmXsOFPfjVfdjA0XRYH2AcIuBJw=="
  },
  "data_count": 1,
  "data": [
    {
      "boleto_debitos_html_url": "https://www.exemplo.com/exemplo-de-url",
      "boleto_infracoes_autuacao_html_url": "https://www.exemplo.com/exemplo-de-url",
      "categoria_veiculo": "1 - PARTICULAR",
      "codigo_verificacao": "2a8b1c47-7fa4-41ea-9fff-9e0cdda30e1c",
      "combustivel": "16 - ALCOOL/GASOLINA",
      "cor": "4 - BRANCA",
      "data_aquisicao": "28/11/2018",
      "data_validade_licenciamento": "1111 em 11/11/1111, Licenciamento Anual",
      "debitos": [
        {
          "descricao": "Exemplo de descrição",
          "vencimento": "29/09/2016",
          "valor_nominal": "85,13",
          "normalizado_valor_nominal": 0.0,
          "valor_corrigido": "85,13",
          "normalizado_valor_corrigido": 85.13,
          "valor_desconto": "0,00",
          "normalizado_valor_desconto": 0.0,
          "valor_juros": "0,00",
          "normalizado_valor_juros": 0.0,
          "valor_multa": "0,00",
          "normalizado_valor_multa": 0.0,
          "valor_atual": "85,13",
          "normalizado_valor_atual": 85.13
        }
      ],
      "debitos_autuacao": [
        {
          "descricao": "Exemplo de descrição",
          "vencimento": "30/12/2022",
          "valor_nominal": "R$293,47",
          "normalizado_valor_nominal": 0.0,
          "valor_desconto": "R$58,70",
          "normalizado_valor_desconto": 58.7,
          "valor_atual": "R$234,77",
          "normalizado_valor_atual": 234.77
        }
      ],
      "especie_veiculo": "1 - PASSAGEIRO",
      "impedimentos": "Transferido",
      "informacao_gravame": "Nenhuma informação pendente até esta data",
      "informacoes_adicionais": "Nenhuma informação adicional até esta data",
      "infracoes_autuacao": [
        {
          "auto": "000111111-1",
          "descricao": "Exemplo de descrição",
          "local_complemento": "BR-135 KM-50 UF-MA Em BACABEIRA no dia 11/11/1111 11:11",
          "valor": "R$293,47",
          "normalizado_valor": 293.47
        },
        {
          "auto": "000111111-1",
          "descricao": "Exemplo de descrição",
          "local_complemento": "BR-135 KM-50 UF-MA Em BACABEIRA no dia 11/11/1111 11:11",
          "valor": "R$195,23",
          "normalizado_valor": 195.23
        }
      ],
      "ipva": [
        {
          "ano": 2025,
          "data_vencimento": "11/03/2021",
          "numero_parcela": 0,
          "valor_multa": "R$10,00",
          "valor_juros": "R$10,00",
          "valor_reducao": "R$10,00",
          "valor_parcela": "R$10,00",
          "valor_original": "R$10,00",
          "saldo_devedor": "R$10,00",
          "normalizado_valor_multa": 10.0,
          "normalizado_valor_juros": 10.0,
          "normalizado_valor_reducao": 10.0,
          "normalizado_valor_parcela": 10.0,
          "normalizado_valor_original": 10.0,
          "normalizado_saldo_devedor": 10.0
        }
      ],
      "marca_modelo": "4885 - HONDA/CG 160 CARGO",
      "normalizado_data_validade_licenciamento": "11/11/1111",
      "numero_lugares": "5",
      "outros_debitos_sefaz": [
        {
          "ano": 2021,
          "numero_documento": "111111111",
          "data_vencimento": "11/03/2021",
          "valor_principal": "R$10,00",
          "valor_multa": "R$10,00",
          "valor_juros": "R$10,00",
          "saldo_devedor": "R$10,00",
          "tipo": "AUTO INFRAÇÃO / NOTIFICAÇÃO",
          "normalizado_valor_principal": 10.0,
          "normalizado_valor_multa": 10.0,
          "normalizado_valor_juros": 10.0,
          "normalizado_saldo_devedor": 10.0
        }
      ],
      "penalidades_multas": [
        {
          "auto": "000111111-1",
          "descricao": "Exemplo de descrição",
          "local_complemento": "BR-135 KM-50 UF-MA Em BACABEIRA no dia 11/11/1111 11:11",
          "valor": "R$85,13",
          "normalizado_valor": 85.13
        },
        {
          "auto": "000111111-1",
          "descricao": "Exemplo de descrição",
          "local_complemento": "BR-135 KM-50 UF-MA Em BACABEIRA no dia 11/11/1111 11:11",
          "valor": "R$85,13",
          "normalizado_valor": 85.13
        }
      ],
      "placa": "AAA1111",
      "placa_anterior": "V.NOVO /SP",
      "potencia": "",
      "proprietario": "Nome de Exemplo",
      "recursos_infracoes": [
        {
          "processo": "Exemplo de texto",
          "renainf": "",
          "auto": "Exemplo de texto",
          "detalhamento": "Exemplo de texto",
          "situacao": "Recurso deferido em 14/12/2021"
        }
      ],
      "renavam": "1111111111",
      "tipo_carroceria": "999 - NAO APLICAVEL/NENHUMA",
      "tipo_veiculo": "6 - AUTOMOVEL"
    }
  ],
  "site_receipts": [
    "https://www.exemplo.com/exemplo-de-url"
  ]
}
```


### Preview file

The preview file (`site_receipts`) in the response JSON is **generated by the source (website/app)** that processed the automation.

### Code snippets


#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/detran/ma/licenciamento'
args = {
  "placa":   "VALUE_OF_PARAMETER_PLACA",
  "renavam": "VALUE_OF_PARAMETER_RENAVAM",
  "token":   "WRITE_YOUR_TOKEN_HERE",
  "timeout": "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.
