Antes da conclusão,
o método.

01 / Fontes públicas

Procedência, não caixa-preta.

O DATAX apresenta indicadores econômicos obtidos em fontes públicas do Banco Central do Brasil, grupos do IPCA publicados pelo IBGE no SIDRA e declarações de finanças municipais consultadas no Siconfi, do Tesouro Nacional. Cada série identifica seu publicador, unidade, período de referência, coleta e endereço da fonte.

Selic, IPCA e dólar têm conceitos e frequências distintos. O título, a descrição e a unidade de cada indicador identificam a série efetivamente consultada. A taxa mensal de inflação, por exemplo, não é uma taxa acumulada em 12 meses. A cotação publicada não é uma oferta de câmbio nem uma cotação em tempo real.

Para reproduzir uma consulta, use a fonte específica indicada na página do indicador ou no relatório municipal, e não apenas a página inicial da instituição.

02 / Referência e coleta

Um dado tem mais de uma data.

Referência / competência

O dia, mês ou exercício ao qual o valor se refere. Uma declaração anual pode ser publicada ou revisada muito depois do encerramento do exercício.

Frequência da série

A periodicidade das observações na fonte: diária, mensal ou anual. Não significa que o DATAX execute uma nova coleta nesse mesmo intervalo.

Coleta pelo DATAX

O momento de obtenção dos dados, exibido no horário de Brasília. Uma coleta recente pode trazer uma referência antiga e válida.

Consulta do panorama

O momento de geração do retrato exibido pela aplicação. Não comprova uma nova consulta à instituição de origem.

Uma fonte marcada como “Coleta defasada” pode ter valores preservados em cache. Confira a data de coleta antes de usar os dados. Não há promessa de atualização em tempo real ou de uma rotina de coleta já ativada.

03 / Gráficos e contexto

Descrever não é prever.

Os gráficos exibem observações da série disponível, sem inventar valores para preencher lacunas. As linhas conectam os pontos publicados; o trecho entre dois pontos não é uma nova observação. O eixo vertical usa escala ajustada, identificada junto ao gráfico, e pode não começar em zero.

As janelas de três meses e um ano são calculadas a partir da última observação disponível, não da data de hoje. “Toda a série” significa todo o recorte armazenado, e não necessariamente o histórico integral da fonte. A tabela e o CSV permitem conferir os valores exatos.

A variação de um indicador não demonstra, por si, efeito sobre outro. Unidades, frequências, períodos e métodos precisam ser compatíveis antes de qualquer comparação. O conteúdo não substitui orientação financeira, jurídica ou contábil.

04 / Contas municipais

O estágio contábil faz parte do número.

O recorte de Piracicaba usa o código IBGE 3538709 e os anexos DCA I-C e I-D disponíveis. O exercício aparece junto às três métricas de destaque; a tabela permite consultar as demais linhas válidas dos anexos coletados, mantendo conta, coluna, período e origem. Não é a totalidade dos demonstrativos do município. Declarações podem ser retificadas pela fonte. Os valores são nominais em reais, sem correção pela inflação e sem conversão per capita.

Receita bruta realizada

Valor bruto de receita declarado na coluna correspondente da fonte. Não equivale a receita líquida nem a uma previsão orçamentária.

Despesa empenhada

Valor associado ao compromisso de despesa assumido no estágio de empenho. Não significa que todo esse valor tenha sido pago.

Despesa liquidada

Valor no estágio de verificação do direito do credor. Liquidação não equivale automaticamente a pagamento.

Não subtraímos essas métricas para produzir um “saldo fiscal”. Também não somamos indiscriminadamente as linhas da tabela: contas agregadoras e seus desdobramentos podem se sobrepor. Não compare exercícios diferentes como se pertencessem ao mesmo período.

05 / Análises cruzadas

O cálculo vem antes do texto.

As análises cruzam declarações anuais de contas (DCA, Siconfi) com o IPCA do Banco Central para comparar dois exercícios nas mesmas contas, colunas e estágios. Todos os números — diferenças, variações, deflator e participações — são calculados no servidor a partir das respostas brutas, guardadas com hash. A página e as exportações mostram as mesmas células de origem.

Lente nominal

Reais de cada ano, como declarados. É sempre exibida e identificada.

Lente IPCA (aproximação)

O valor do exercício-base é multiplicado pela razão entre as médias dos níveis mensais do IPCA nacional de cada ano, encadeados a partir de uma base comum. Não é média de taxas, soma de taxas nem variação de dezembro a dezembro. Não representa a inflação de Piracicaba nem o custo exato dos serviços públicos.

Participação por função

Valor da função dividido pelo total da mesma fase e do mesmo ano, excluindo operações intraorçamentárias. A soma das funções é conciliada com esse total. As funções declaradas não esgotam todas as políticas do município.

Fase da despesa

Empenhada, liquidada e paga medem momentos diferentes. Mudar a fase pode mudar a leitura; nenhuma ordem é ranking de qualidade ou eficiência.

Empenho cria obrigação de pagamento, pendente ou não de condição; liquidação verifica o direito do credor com base nos documentos do crédito; a ordem de pagamento determina que a despesa seja paga. Essas definições não comprovam, por um total agregado, qualidade ou resultado do serviço. Referência: Lei nº 4.320, arts. 58, 62, 63 e 64 ↗.

Limites: IPTU e ISS aparecem como tributo bruto agregado, sem separar principal, multas, juros e dívida ativa. Dois exercícios não formam tendência nem indicam causa. As declarações podem ser retificadas e não são auditadas pelo DATAX. Não há valores per capita, saldo fiscal, correlação apresentada como certeza ou projeção.

06 / Inflação e ferramentas

Média nacional, contas pessoais.

A história “A inflação oficial é uma só. A da sua família, não.” e as ferramentas de renda e de despesas usam duas fontes públicas: a série mensal do IPCA do Banco Central e os grupos do IPCA no SIDRA, do IBGE (taxa no mês, taxa acumulada em 12 meses e peso de cada grupo na cesta oficial). Todos os números exibidos vêm desses dados ou de cálculos determinísticos feitos sobre eles; não há texto gerado sob demanda nem previsão.

Renda e proposta

O valor informado vale antes do primeiro mês escolhido. As taxas mensais de cada mês do intervalo, inclusive os extremos, são encadeadas: F = Π(1 + r/100). O valor que repõe o IPCA é o valor inicial × F; a diferença real compara o valor final ou proposto com esse número. Não é média nem soma de taxas.

Cenário de proposta

O prazo é escolhido pelo usuário e só multiplica valores mensais constantes. Não projeta inflação futura, reajustes seguintes, encargos ou direitos trabalhistas.

Simulação de cesta

Cada gasto informado é multiplicado pela taxa do seu grupo no último mês ou nos 12 meses até o último mês disponível. A variação resultante depende da composição informada. Não é o índice oficial reponderado nem uma inflação pessoal validada; o IPCA geral do mesmo período aparece só como referência nacional.

Grupos agregados

Cada grupo reúne muitos itens. Habitação não equivale ao reajuste do aluguel ou a índices de contrato; Transportes mede o consumo das famílias, não insumos de empresas. O IPCA não substitui índice de acordo coletivo, de contrato ou de custo de um negócio.

Privacidade: os valores digitados nas ferramentas ficam no navegador. Não entram na URL, não são enviados ao servidor e não são guardados. Os arquivos JSON, CSV e Markdown são montados no próprio navegador com os mesmos valores, período e fonte da tela. A exportação pública do DATAX traz apenas as observações oficiais do corte.

Limites: a série disponível cobre o período mostrado em cada página; meses sem taxa publicada impedem o cálculo, em vez de serem estimados. Uma coleta defasada continua identificada com a sua competência e a data de coleta.

07 / Ausências e limites

Indisponível não é zero.

Se uma fonte falhar ou não retornar uma observação utilizável, a interface informa a indisponibilidade. Quando houver dados preservados, seu estado e sua coleta ficam visíveis. Não substituímos falhas por números demonstrativos, estimativas ou valores zero.

O recorte pode conter lacunas e não abrange todas as contas, séries ou revisões existentes na instituição de origem. Observações futuras não devem integrar o retrato disponível. A consulta municipal não é auditoria nem atestado de regularidade das contas públicas.

Os CSVs exportam o recorte completo disponível no momento da requisição; filtros e paginação da interface não alteram essa exportação. Dados podem mudar entre a visualização e o download se houver nova coleta. Preserve o arquivo e a informação de coleta ao documentar uma análise.

08 / Escopo do produto

Editorial e inteligência. Sem atalhos comerciais.

O DATAX é a interface de dados do DataHub PIRANOT, com dois braços complementares: contexto editorial de interesse público e inteligência para organizações. Esta é uma reconstrução interna a partir de contratos preservados, não a restauração integral de um aplicativo antigo.

A amplitude do produto não deve ser confundida com capacidades já implementadas. Não há botão de compra, conta premium ou promessa de acesso comercial nesta versão.