## ECRVSP / Documentos / Primeiro Emplacamento
Envia o formulário de Primeiro Emplacamento de um veículo dentro do portal e-CRVsp do DETRAN de São Paulo.


### Site URL
- https://www.e-crvsp.sp.gov.br/

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/ecrvsp/docs/emplacamento`

### Body encoding (POST)
[`application/x-www-form-urlencoded`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods/POST)



| Parameter                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token*                                    | The token that will authenticate and authorize the request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| a3*                                       | Identifier of the digital certificate (A3 token) to be used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| a3_pin*                                   | PIN of the digital certificate (A3 token) to be used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| login_cpf*                                | CPF para login no site do ECRV.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| login_senha*                              | Senha para login no site do ECRV. Caso a conta faça login com GOV.BR, deve informar a senha do GOV.BR.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| placa_escolhida**                         | Placa que deve ser reservada para este emplacamento. Se informar uma placa que não estiver disponível, a API retornará erro. Caso não informe, o sistema escolherá uma placa disponível automaticamente.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| placa_final**                             | Dígito final da placa que deve ser reservada para este emplacamento (valor padrão: 0).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| file_pdf**                                | Arquivo PDF a ser anexado no formulário. A API da Infosimples deve receber o conteúdo de um arquivo através do envio de uma string do conteúdo codificada em Base64. Em caso de dúvidas, entre em contato com suporte@infosimples.com.br. Se o PDF não for informado, o PDF não será submetido no formulário.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| chassi*                                   | Chassi do veículo a ser consultado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| categoria*                                | 
        Deve informar um dos valores abaixo:
        <ul>
          <li><strong>0:</strong> NÃO INFORMADO</li>
          <li><strong>1:</strong> PARTICULAR</li>
          <li><strong>2:</strong> ALUGUEL</li>
          <li><strong>3:</strong> OFICIAL</li>
          <li><strong>4:</strong> EXPERIENCIA</li>
          <li><strong>5:</strong> APRENDIZAGEM</li>
          <li><strong>6:</strong> FABRICANTE</li>
          <li><strong>7:</strong> DIPLOMATA</li>
          <li><strong>8:</strong> C. CONSULAR</li>
          <li><strong>9:</strong> ORG.INTERNAC</li>
          <li><strong>10:</strong> CONSULAR</li>
          <li><strong>11:</strong> MISSAO/REPARTIÇÃO/REPRESENTAÇÃO INTERNACIONAL</li>
          <li><strong>12:</strong> ACORDO DE COOPERAÇÃO INTERNACIONAL</li>
        </ul>
       |
| tipo_restricao*                           | 
        Deve informar um dos valores abaixo:
        <ul>
          <li><strong>0:</strong> Nada Consta</li>
          <li><strong>1:</strong> Arrendamento</li>
          <li><strong>2:</strong> Reserva de Domínio</li>
          <li><strong>3:</strong> Alienação Fiduciária</li>
          <li><strong>9:</strong> Penhor Mercantil</li>
        </ul>
                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| cpf**                                     | CPF do proprietário (não informar caso <code>cnpj</code> seja informado).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| cnpj**                                    | CNPJ do proprietário (não informar caso <code>cpf</code> seja informado).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| rg**                                      | RG do proprietário atual (não informar caso <code>cnpj</code> seja informado).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| rg_orgao_expedidor**                      | RG: órgão expedidor (não informar caso <code>cnpj</code> seja informado).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| rg_uf**                                   | RG: UF (não informar caso <code>cnpj</code> seja informado). Para o valor o estado de São Paulo, enviar <code>"SP"</code>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| nfe**                                     | Chave NF-e do veículo (informar apenas dígitos).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| nfe_data_emissao*                         | Data de emissão da NF-e. Deve estar no formato dd/mm/yyyy. Exemplo: 31/12/2020.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| nfe_numero**                              | Número da NF-e. Exemplo: 001111111. Geralmente não é necessário informar porque já vem preenchido, mas caso o usuário deseje ou seja um caso especial, pode informar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| nfe_valor**                               | Valor da NF-e. Exemplo: 111.111,11. Geralmente não é necessário informar porque já vem preenchido, mas caso o usuário deseje ou seja um caso especial, pode informar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| nome*                                     | Nome do proprietário.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| nome_anterior*                            | Nome do proprietário anterior.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| telefone**                                | Telefone do proprietário.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| endereco_cep*                             | CEP do proprietário. Para o CEP 99999-999, enviar <code>"99999999"</code>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| endereco_numero*                          | Número do endereço do proprietário.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| endereco_complemento**                    | Complemento do endereço do proprietário.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| veiculo_pessoa_deficiencia**              | Informe o valor <strong>1</strong> para ativar "Pessoa com deficiência - PcD".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| veiculo_taxi*                             | Veiculo Taxi                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| veiculo_isencao_fiscal**                  | Informe o valor <strong>1</strong> para ativar "Veículo com Isenção Fiscal".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| veiculo_venda_dispensada_renave**         | Informe o valor <strong>1</strong> para ativar "Veículo com Isenção Fiscal".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| veiculo_pessoa_deficiencia_venda_direta** | Informe o valor <strong>1</strong> para ativar "Pessoa Com Deficiência e Venda Direta".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| veiculo_empresa_salvados**                | Informe o valor <strong>1</strong> para ativar "Veículo Empresa Salvados".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tipo_placa_dianteira**                    | Informe o valor <strong>1</strong> para ativar "Tipo de placa: dianteira".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tipo_placa_traseira**                     | Informe o valor <strong>1</strong> para ativar "Tipo de placa: traseira".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| tipo_placa_traseira_segunda**             | Informe o valor <strong>1</strong> para ativar "Tipo de placa: segunda placa traseira".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

> * 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.",
  "header": {
    "api_version": "v2",
    "product": "Consultas",
    "service": "ecrvsp/docs/emplacamento",
    "parameters": {
      "a3_md5": "a43e006a66cb98c37282c850fc40866c",
      "a3_pin_md5": "ab20ad7cdf52e8a3595972ef488b636a",
      "login_cpf_md5": "e379c59a3573be16480533ae3f53ea1b",
      "login_senha_md5": "e379c59a3573be16480533ae3f53ea1b",
      "chassi": "1AA11111AA1111111"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.2",
    "requested_at": "2022-06-28T12:38:13.000-03:00",
    "elapsed_time_in_milliseconds": 311,
    "remote_ip": "111.111.111.111",
    "signature": "fhFvQ9u9W1ZQKZvHFWYBTM8cx6HTkP8hBiSkOU2RYwmNL27oc/jOgggRC4QrEPI2c4rk/cFti0Hn5PwlSAS8Url6fR4mFub6zC5C2A=="
  },
  "data_count": 1,
  "data": [
    {
      "placa": "AAA1111",
      "placas_disponiveis_url": "https://storage.googleapis.com/x/exemplo.pdf",
      "numero_ficha": "0000000/2020",
      "renavam_provisorio": "11111111111",
      "formulario_pdf_url": "https://www.exemplo.com/exemplo-de-url",
      "ficha_pdf_url": "https://www.exemplo.com/exemplo-de-url"
    }
  ],
  "errors": [],
  "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
import base64

url = 'https://api.infosimples.com/api/v2/consultas/ecrvsp/docs/emplacamento'
args = {
  "a3":                                      "VALUE_OF_PARAMETER_A3",
  "a3_pin":                                  "VALUE_OF_PARAMETER_A3_PIN",
  "login_cpf":                               "VALUE_OF_PARAMETER_LOGIN_CPF",
  "login_senha":                             "VALUE_OF_PARAMETER_LOGIN_SENHA",
  "placa_escolhida":                         "VALUE_OF_PARAMETER_PLACA_ESCOLHIDA",
  "placa_final":                             "VALUE_OF_PARAMETER_PLACA_FINAL",
  "file_pdf":                                base64.b64encode(open("path/to/file", "rb").read()).decode("ascii").replace("+", "-").replace("/", "_").rstrip("="),
  "chassi":                                  "VALUE_OF_PARAMETER_CHASSI",
  "categoria":                               "VALUE_OF_PARAMETER_CATEGORIA",
  "tipo_restricao":                          "VALUE_OF_PARAMETER_TIPO_RESTRICAO",
  "cpf":                                     "VALUE_OF_PARAMETER_CPF",
  "cnpj":                                    "VALUE_OF_PARAMETER_CNPJ",
  "rg":                                      "VALUE_OF_PARAMETER_RG",
  "rg_orgao_expedidor":                      "VALUE_OF_PARAMETER_RG_ORGAO_EXPEDIDOR",
  "rg_uf":                                   "VALUE_OF_PARAMETER_RG_UF",
  "nfe":                                     "VALUE_OF_PARAMETER_NFE",
  "nfe_data_emissao":                        "VALUE_OF_PARAMETER_NFE_DATA_EMISSAO",
  "nfe_numero":                              "VALUE_OF_PARAMETER_NFE_NUMERO",
  "nfe_valor":                               "VALUE_OF_PARAMETER_NFE_VALOR",
  "nome":                                    "VALUE_OF_PARAMETER_NOME",
  "nome_anterior":                           "VALUE_OF_PARAMETER_NOME_ANTERIOR",
  "telefone":                                "VALUE_OF_PARAMETER_TELEFONE",
  "endereco_cep":                            "VALUE_OF_PARAMETER_ENDERECO_CEP",
  "endereco_numero":                         "VALUE_OF_PARAMETER_ENDERECO_NUMERO",
  "endereco_complemento":                    "VALUE_OF_PARAMETER_ENDERECO_COMPLEMENTO",
  "veiculo_pessoa_deficiencia":              "VALUE_OF_PARAMETER_VEICULO_PESSOA_DEFICIENCIA",
  "veiculo_taxi":                            "VALUE_OF_PARAMETER_VEICULO_TAXI",
  "veiculo_isencao_fiscal":                  "VALUE_OF_PARAMETER_VEICULO_ISENCAO_FISCAL",
  "veiculo_venda_dispensada_renave":         "VALUE_OF_PARAMETER_VEICULO_VENDA_DISPENSADA_RENAVE",
  "veiculo_pessoa_deficiencia_venda_direta": "VALUE_OF_PARAMETER_VEICULO_PESSOA_DEFICIENCIA_VENDA_DIRETA",
  "veiculo_empresa_salvados":                "VALUE_OF_PARAMETER_VEICULO_EMPRESA_SALVADOS",
  "tipo_placa_dianteira":                    "VALUE_OF_PARAMETER_TIPO_PLACA_DIANTEIRA",
  "tipo_placa_traseira":                     "VALUE_OF_PARAMETER_TIPO_PLACA_TRASEIRA",
  "tipo_placa_traseira_segunda":             "VALUE_OF_PARAMETER_TIPO_PLACA_TRASEIRA_SEGUNDA",
  "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.