## DETRAN / SC / Guias de Débitos
Faz download de guias de pagamento de dívidas de veículos abertas no Departamento Estadual de Trânsito (DETRAN) de Santa Catarina (SC). Existe um limite diário de downloads por login utilizado, imposto pela fonte.
### Site URL
- https://servicos.detran.sc.gov.br/consulta-dossie-veiculo
### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/detran/sc/download-guia`
| 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. |
| login_cpf** | Este parâmetro é necessário caso o login no GOV.BR seja feito com CPF e senha. Deve ser informado o CPF para fazer login no GOV.BR. |
| login_senha** | Este parâmetro é necessário caso o login no GOV.BR seja feito com CPF e senha. Deve ser informada a senha para fazer login no GOV.BR. |
| pkcs12_cert** | Este parâmetro é necessário caso o login no GOV.BR seja feito com certificado digital. Conteúdo do arquivo do certificado digital A1 encriptado seguindo as instruções de criptografia. |
| pkcs12_pass** | Este parâmetro é necessário caso o login no GOV.BR seja feito com certificado digital. Senha do certificado digital A1 encriptada seguindo as instruções de criptografia. |
> * 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",
"api_version_full": "2.2.28-20250716172658",
"product": "Consultas",
"service": "detran/sc/download-guia",
"parameters": {
"login_cpf_md5": "e379c59a3573be16480533ae3f53ea1b",
"login_senha_md5": "e379c59a3573be16480533ae3f53ea1b",
"placa": "AAA1111",
"renavam": "1111111111"
},
"client_name": "Minha Empresa",
"token_name": "Token de Produção",
"billable": true,
"price": "0.26",
"requested_at": "2025-07-18T10:49:58.000-03:00",
"elapsed_time_in_milliseconds": 495,
"remote_ip": "111.111.111.111",
"signature": "U2FsdGVkX18x9mQ+vSt8sIdZcFaQIyH03upyd2qhXr9mKjIfHxJfFDQjuowtkBAIpb5eWTRVsKHau+psTt1pRQ=="
},
"data_count": 1,
"data": [
{
"debitos": [
{
"classe": "IPVA (Cota Unica) 2025",
"vencimento": "01/09/2025",
"valor_nominal": 872.76,
"normalizado_vencimento": "11/11/1111",
"normalizado_valor_nominal": 872.76,
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url",
"guia_mensagem": "Exemplo de Mensagem"
},
{
"classe": "IPVA (1a. Cota) 2025",
"vencimento": "11/08/2025",
"valor_nominal": 290.92,
"normalizado_vencimento": "11/11/1111",
"normalizado_valor_nominal": 290.92,
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url",
"guia_mensagem": "Exemplo de Mensagem"
},
{
"classe": "IPVA (2a. Cota) 2025",
"vencimento": "10/09/2025",
"valor_nominal": 290.92,
"normalizado_vencimento": "11/11/1111",
"normalizado_valor_nominal": 290.92,
"guia_mensagem": "Exemplo de Mensagem",
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url"
},
{
"classe": "IPVA (3a. Cota) 2025",
"vencimento": "10/10/2025",
"valor_nominal": 290.92,
"normalizado_vencimento": "11/11/1111",
"normalizado_valor_nominal": 290.92,
"guia_mensagem": "Exemplo de Mensagem",
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url"
},
{
"classe": "Licenciamento Anual 2025",
"vencimento": "31/10/2025",
"valor_nominal": 149.37,
"normalizado_vencimento": "11/11/1111",
"normalizado_valor_nominal": 149.37,
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url",
"guia_mensagem": "Exemplo de Mensagem"
}
],
"divida_ativa": [
{
"numero_identificacao": 11111111111,
"exercicios": "2025, 2024, 2023",
"guia_pdf_url": "https://www.exemplo.com/exemplo-de-url",
"guia_mensagem": "Exemplo de Mensagem"
}
],
"veiculo": {
"placa": "AAA1111",
"renavam": "1111111111"
},
"site_receipt": "https://www.exemplo.com/exemplo-de-url"
}
],
"site_receipts": [
"https://www.exemplo.com/exemplo-de-url"
]
}
```
### Preview file
The preview file (`site_receipts`) in the response JSON may be **synthesized by Infosimples** using data from the source (website/app) that processed the automation if the file generated by the source is not suitable for viewing.
### Code snippets
#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests
import base64
# pip install aes-bridge
import aes_bridge
url = 'https://api.infosimples.com/api/v2/consultas/detran/sc/download-guia'
args = {
"placa": "VALUE_OF_PARAMETER_PLACA",
"renavam": "VALUE_OF_PARAMETER_RENAVAM",
"login_cpf": "VALUE_OF_PARAMETER_LOGIN_CPF",
"login_senha": "VALUE_OF_PARAMETER_LOGIN_SENHA",
"pkcs12_cert": aes_bridge.encrypt(base64.b64encode(open("certificate.pfx", "rb").read()).decode(), "ENCRYPTION_KEY").decode("ascii").replace("+", "-").replace("/", "_").rstrip("="),
"pkcs12_pass": aes_bridge.encrypt("CERTIFICATE_PASSWORD", "ENCRYPTION_KEY").decode("ascii").replace("+", "-").replace("/", "_").rstrip("="),
"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.