Docs · Datasheet
IPVA
de São Paulo: valor venal dos veículos.
Valor venal de cada modelo e versão de veículo usado no cálculo do IPVA em São Paulo, por ano-modelo, publicado todo ano pela Secretaria da Fazenda e Planejamento (pesquisa contratada à Fipe), com o IPVA estimado pela alíquota da lei.
Motivação
A Secretaria da Fazenda publica a tabela no Diário Oficial como um PDF de quase 300 páginas; a única consulta pronta é por placa, com captcha. Quem compra ou vende veículo, despachantes, contadores, seguradoras e jornalistas precisam procurar por marca, modelo e ano e ver quanto de imposto isso dá, com a fonte ao lado.
Composição
- Unidade
- Linha da tabela oficial (marca, modelo/versão, código IPVA e código complementar) em um ano-modelo, com o valor venal em reais.
- Tipos
- Automóveis, camionetas e utilitários, caminhões, ônibus e micro-ônibus, motos e similares (as categorias A a E do Anexo I).
- Campos
- tipo, marca, modelo, codigo_ipva, codigo_complementar, ano_modelo, valor_venal (R$), aliquota_pct, ipva_estimado (R$).
- Alíquotas
- Lei estadual 13.296/2008, art. 9º (redação da Lei 17.473/2021): 4% automóveis e demais veículos; 2% ônibus, micro-ônibus, motos e caminhonetes de cabine simples; 1,5% caminhões.
Cobertura: Exercícios 2025 (13.087 linhas, preços de setembro/2024) e 2026 (13.571 modelos e versões, preços de setembro/2025). Cada ano-modelo com valor é um registro.
Como é coletado
- Fonte oficial
- Secretaria da Fazenda e Planejamento de SP: Anexo I da Resolução SFP 40, de 10/12/2025 (exercício 2026) e da Resolução SFP 42, de 13/12/2024 (exercício 2025), publicadas no Diário Oficial do Estado e hospedadas em legislacao.fazenda.sp.gov.br. A consulta por placa do Sivei não é usada.
- Método
- Coletor próprio (lib/ipva-sp.ts) identificado no User-Agent como "PIRANOT-DataX/1.0": baixa o PDF oficial e extrai a tabela com pdftotext, atribuindo cada valor à coluna do ano-modelo pela posição na página. Exercício já gravado não é pedido de novo.
- Cadência
- Anual: a Fazenda publica em dezembro, para vigorar no exercício seguinte. A checagem roda toda segunda em dezembro e janeiro.
- Orçamento de requisições
- 1 download de cerca de 8 MB por exercício novo, nenhum quando já gravado; no máximo 1 por segundo (2 s nas cargas); timeout de 60 s; backoff exponencial em 429 e 5xx. O recheque noturno reaproveita 1 download para as 5 conferências.
- Túnel
- Não há.
Pré-processamento e limpeza
- Os valores são os da tabela, em reais inteiros; nada é arredondado nem reajustado.
- A marca é o cabeçalho de agrupamento do PDF; o modelo é a descrição da linha. O mesmo modelo pode ter mais de uma linha (código complementar).
- IPVA estimado = valor venal × alíquota do tipo, com centavos. Em camionetas e utilitários a tabela não distingue cabine simples (2%) de cabine dupla (4%): a resposta traz os 4% e, ao lado, os 2%.
Checks de qualidade aplicados
- Esquema: toda linha tem tipo, marca, descrição, código IPVA e ao menos um valor; qualquer linha que o leitor do PDF não consiga interpretar reprova a carga.
- Continuidade: a numeração LIN. do PDF vai de 1 ao total, sem buracos (13.571 em 2026).
- Unicidade e coluna: código IPVA + complementar sem repetição; um único valor por ano-modelo em cada linha, entre 1990 e o exercício.
- Faixa: valor entre R$ 500 e R$ 40 milhões. Salto: a mediana de cada tipo não pode variar fora de 0,6 a 1,6 contra o exercício anterior.
- Verificação antes de publicar: o que reprova fica em quarentena e a API segue entregando a última versão boa. Recheque noturno por amostra: 5 células sorteadas são comparadas com o PDF oficial baixado de novo.
Licença e usos
- Licença
- Ato oficial publicado no Diário Oficial do Estado; cite "Fonte: Secretaria da Fazenda e Planejamento de SP".
- Usos
- Consultar o valor venal e estimar o IPVA de um modelo, pautas, avaliações e relatórios. Não substitui a consulta oficial do lançamento (Sivei/IPVANET) nem o valor cobrado de um veículo específico.
Limitações conhecidas
- O valor venal é o de mercado de setembro do ano anterior, não o preço atual; a Secretaria pode ajustar o valor de um modelo (Resolução, art. 4º).
- O IPVA estimado ignora locadoras (1%), gás natural em veículo a gasolina até 2008 (3%), isenções e descontos.
- A tabela não distingue caminhonete de cabine simples; veículos de modelo lançado depois da publicação não constam (Resolução, art. 3º).
- Dado anual: vale para o exercício indicado; a tabela do exercício seguinte entra quando a Fazenda a publica.
Distribuição
| Endpoint | Descrição |
|---|---|
GET /api/v1/veiculos/ipva-sp | Busca por marca, modelo, ano-modelo e tipo, com valor venal e IPVA estimado; parâmetros marca, modelo, ano, tipo, exercicio e limite. |
Metadados (DCAT / schema.org Dataset)
- dct:identifier
- ipva-sp
- dct:publisher
- PIRANOT
- dct:source
- Secretaria da Fazenda e Planejamento de SP
- dct:license
- ato oficial publicado no Diário Oficial do Estado
- dct:temporal
- 2025 a 2026
- dct:spatial
- São Paulo (UF)
- dct:accrualPeriodicity
- anual
- dcat:distribution
- JSON via API v1
Histórico de versões
| Versão | Mudança |
|---|---|
| 1.0 (28/10/2026) | Exercícios 2025 e 2026, API /api/v1/veiculos/ipva-sp e página /dados/ipva-sp. |
Reportar erro
POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].
Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.