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.gz com 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.gz para 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.