Pitch: Criei uma API estática open source com todas as tabelas IBPT desde 2017 — 91 versões, até 2026
Se você já precisou buscar alíquotas históricas do IBPT para auditoria retroativa, sabe a dor que é: o site oficial (deolhonoimposto.ibpt.org.br) só entrega a tabela vigente, e os repos existentes no GitHub (como o nfe/ibpt) estão congelados em 2019.
Criei o tabelas-ibpt para resolver isso.
O que tem
- 91 versões das tabelas IBPTax de 2017 a 2026 (incluindo todas as revisões A, B, C... de cada semestre)
- API estática via GitHub Pages — sem backend, sem rate limit, sem cadastro
- Dados em
.json.gzcom gzip nível 9 (1,7 GB → 314 MB, 82% de redução) - Cobre NCM, NBS e LC116, para todos os 27 estados
- Página de consulta interativa totalmente client-side: ibpt.valraw.com.br
- CSV consolidado
todos.csv.gzpara quem quiser carregar tudo de uma vez
Estrutura da API
GET https://ibpt.valraw.com.br/api/meta.json
GET https://ibpt.valraw.com.br/api/{ano}/index.json
GET https://ibpt.valraw.com.br/api/{ano}/{tabela}/{tipo}/{uf}.json.gz
Exemplo real:
curl https://ibpt.valraw.com.br/api/2024/24.2.A/ncm/SP.json.gz | gunzip | jq
Formato de resposta
{
"tabela": "24.2.A",
"dados": [
{
"codigo": "01012100",
"descricao": "Cavalos reprodutores de raça pura",
"aliquotaNacionalFederal": 13.45,
"aliquotaImportadosFederal": 15.45,
"aliquotaEstadual": 18.00,
"aliquotaMunicipal": 0.00,
"vigenciaInicio": "01/01/2024",
"vigenciaFim": "31/03/2024"
}
]
}
Casos de uso
- Auditoria fiscal retroativa em NF-e
- ERPs/sistemas de emissão que precisam de fallback offline
- Pesquisa e análise de carga tributária ao longo do tempo
Tech stack
TypeScript + Node.js 22, build local com npm run construir, deploy automático via GitHub Actions para GitHub Pages.
Repo: https://github.com/luizinhoh2o1/tabelas-ibpt
Consulta: https://ibpt.valraw.com.br
Licença: Apache 2.0 — uso livre, inclusive comercial.
Feedback, issues e PRs são bem-vindos.