## SEFAZ / SP / IPVA (Veículo Zero KM) Pesquisa dados de Imposto sobre Propriedades de Veículos Automotores (IPVA), exclusivamente para veículos Zero KM. ### URL do site - https://www.ipva.fazenda.sp.gov.br/ipvanet/default.aspx ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/sefaz/sp/ipva-zero-km` | Parâmetro | Descrição | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. | | tipo_veiculo* | Automóvel, Caminhão, Caminhonete, Moto, etc. | | marca* | Fiat, Ford, M.Benz, Volkswagen, etc. | | modelo* | 1524700-FIAT/PALIO 1.8 R FLEX, 1548400-VW/GOL CL MC, etc. | | combustivel* | GASOLINA, ALCOOL, GNV, etc. | | especie* | PASSAGEIRO, CARGA, etc. | | categoria* | PARTICULAR, ALUGUEL, etc. | | carroceria* | OUTROS, CARROCERIA FECHADA, etc. | | placa* | Placa do veículo a ser consultado. | | chassi* | Número do chassi do veículo a ser consultado. | | ano_fabricacao* | Ano_fabricacao | | municipio* | Municipio | | n_passageiros* | N_passageiros | | numero_df_di* | Numero_df_di | | valor* | Valor | | data_emissao* | Data no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | > * Parâmetro obrigatório. > ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente. ### Exemplos de respostas (OK) ```json { "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": { "api_version": "v2", "product": "Consultas", "service": "sefaz/sp/ipva-zero-km", "parameters": { "ano_fabricacao": "2021", "carroceria": "JIPE", "categoria": "PARTICULAR", "chassi": "1AA11111AA1111111", "combustivel": "ALCOOL/GASOLINA", "data_emissao": "1111-11-11", "especie": "Exemplo de espécie", "marca": "FIAT", "modelo": "2084130-FIAT/FIORINO ENDURANCE", "municipio": "SAO PAULO / SP", "n_passageiros": "2", "numero_df_di": "1111111", "placa": "AAA1111", "tipo_veiculo": "6 - AUTOMOVEL", "valor": 80237.62 }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.2", "requested_at": "2022-02-16T11:05:32.000-03:00", "elapsed_time_in_milliseconds": 261, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX19D2b358ryxTeJj5F5FrN3eFO+Jff33hO96IumahNMU5Q3ndAHZMocCT13RKqIQ3Rg2B8OG5XZz/Q==" }, "data_count": 1, "data": [ { "ano_fabricacao": "2021", "boleto_html_url": "https://www.exemplo.com/exemplo-de-url", "boleto_linha_digitavel": "123456789012345678901234567890123456789012345678", "carroceria": "JIPE", "categoria": "PARTICULAR", "codigo_ipva": "1111111", "codigo_receita": "111-1", "combustivel": "ALCOOL/GASOLINA", "data_vencimento": "11/11/1111", "especie": "Exemplo de espécie", "exercicio": "2021", "marca_modelo": "FIAT/FIORINO ENDURANCE", "municipio": "SAO PAULO / SP", "normalizado_valor_imposto": 66.86, "normalizado_valor_infracao": 0.0, "normalizado_valor_juros": 0.7, "normalizado_valor_multa": 3.53, "normalizado_valor_total": 71.09, "placa": "AAA1111", "procedencia": "NACIONAL", "renavam": "1111111111", "tipo": "Caminhonete", "valor_imposto": "66,86", "valor_infracao": "", "valor_juros": "0,70", "valor_multa": "3,53", "valor_total": "71,09", "site_receipt": "https://www.exemplo.com/exemplo-de-url" } ], "site_receipts": [ "https://www.exemplo.com/exemplo-de-url" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/sefaz/sp/ipva-zero-km' args = { "tipo_veiculo": "VALOR_DO_PARAMETRO_TIPO_VEICULO", "marca": "VALOR_DO_PARAMETRO_MARCA", "modelo": "VALOR_DO_PARAMETRO_MODELO", "combustivel": "VALOR_DO_PARAMETRO_COMBUSTIVEL", "especie": "VALOR_DO_PARAMETRO_ESPECIE", "categoria": "VALOR_DO_PARAMETRO_CATEGORIA", "carroceria": "VALOR_DO_PARAMETRO_CARROCERIA", "placa": "VALOR_DO_PARAMETRO_PLACA", "chassi": "VALOR_DO_PARAMETRO_CHASSI", "ano_fabricacao": "VALOR_DO_PARAMETRO_ANO_FABRICACAO", "municipio": "VALOR_DO_PARAMETRO_MUNICIPIO", "n_passageiros": "VALOR_DO_PARAMETRO_N_PASSAGEIROS", "numero_df_di": "VALOR_DO_PARAMETRO_NUMERO_DF_DI", "valor": "VALOR_DO_PARAMETRO_VALOR", "data_emissao": "VALOR_DO_PARAMETRO_DATA_EMISSAO", "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO", "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']) ``` ## Estamos prontos para ajudar Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.