Docs · Datasheet
Correção
monetária: IPCA, INPC, IGP-M, INCC e outros índices.
Séries mensais dos 8 índices usados em reajuste e correção de valores e a correção de um valor entre dois meses, com fator, percentual e memória mês a mês, pelo método da Calculadora do Cidadão do Banco Central.
Motivação
Advogados, contadores, engenheiros e imobiliárias corrigem valores todos os dias e precisam da memória de cálculo citável. O BCB publica as séries no SGS e o método na Calculadora do Cidadão; o DataX guarda as séries uma vez, aplica o método publicado e devolve a memória.
Composição
- Índices
- IPCA (SGS 433), INPC (188) e IPCA-15 (7478), do IBGE; IGP-M (189), IGP-DI (190) e INCC (192), da FGV IBRE; IPC-Fipe (193), da Fipe; Selic acumulada no mês (4390), do BCB.
- Unidade
- Variação mensal em %, um ponto por mês, como publicado no SGS.
- Saída da correção
- valor, de, ate, meses, fator, percentual, corrigido e memoria[] (mes, taxa, fator, acumulado, valor), com metodo e metodo_url.
Cobertura: Séries mensais desde 01/1994 (IGP-DI e IPC-Fipe desde 1944) até o último mês publicado pelo BCB; Brasil (IPC-Fipe: cidade de São Paulo).
Como é coletado
- Fonte oficial
- Banco Central do Brasil, Sistema Gerenciador de Séries Temporais (api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados).
- Método
- Coletor próprio (lib/correcao.ts) identificado no User-Agent; carga longa uma vez, depois só os meses que faltam (incremental, mesclagem por mês). A correção é a da Calculadora do Cidadão: produto dos fatores mensais (1 + taxa/100) do mês inicial ao final, inclusive; mês ausente é erro, nada é interpolado.
- Cadência
- Rotina diária às 06h10 (Brasília); o mês novo entra quando o BCB publica.
- Orçamento de requisições
- 8 requisições ao SGS por dia (uma por série), timeout de 25 s.
- Túnel
- Não há.
Pré-processamento e limpeza
- Datas convertidas de dd/mm/aaaa para ISO (primeiro dia do mês); valores numéricos como publicados, sem arredondar.
- Pontos repetidos no mesmo mês: o mais novo vence.
Checks de qualidade aplicados
- Esquema: data válida e valor numérico em todo ponto; série sem ponto novo não sobrescreve a anterior.
- Continuidade: meses em ordem crescente e sem mês futuro.
- Verificação antes de publicar: a série passa pelos checks antes de ir ao ar; falha retém a coleta e a API segue com a última versão boa.
Licença e usos
- Licença
- BCB (SGS): ODbL 1.0; índices do IBGE, da FGV e da Fipe reproduzidos como publicados pelo SGS. Atribuição: "Fonte: IBGE, FGV e Fipe, via Banco Central (SGS), processamento PIRANOT".
- Usos
- Correção de contratos, aluguéis (IGP-M), obras (INCC), honorários e dívidas; memória de cálculo em petições e laudos. Não é parecer jurídico: o índice do contrato é o que o contrato diz.
Limitações conhecidas
- O último mês do IPCA e do INPC entra depois da divulgação do IBGE, em geral na segunda semana do mês seguinte.
- IPC-Fipe mede a cidade de São Paulo, não o Brasil.
- Selic acumulada no mês é taxa de juros, não inflação; o cálculo de "juros reais" é outra operação.
Distribuição
| Endpoint | Descrição |
|---|---|
GET /api/v1/correcao | indice, valor, de e ate (AAAA-MM); ou indice, valor e aniversario=AAAA-MM para aluguel. |
Metadados (DCAT / schema.org Dataset)
- dct:identifier
- indices-correcao
- dct:publisher
- PIRANOT
- dct:source
- Banco Central do Brasil (SGS); IBGE, FGV IBRE e Fipe
- dct:license
- ODbL 1.0 (SGS)
- dct:temporal
- desde 1994 (IGP-DI e IPC-Fipe desde 1944)
- dct:spatial
- Brasil
- dct:accrualPeriodicity
- mensal
Histórico de versões
| Versão | Mudança |
|---|---|
| 1.0 (27/10/2026) | Oito séries do SGS, ferramenta /ferramentas/correcao e rota /api/v1/correcao com memória mês a mês. |
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.