Docs · Datasheet
Contas
municipais (Siconfi/DCA).
Receitas e despesas declaradas por Piracicaba ao Tesouro Nacional (DCA 2025), com conta, coluna, estágio e unidade identificados.
Motivação
A Declaração de Contas Anuais é pública, mas difícil de ler. O DataX recorta as linhas dos anexos I-C e I-D e três totais, sem somar hierarquias nem estágios, e cruza com o IPCA na análise fiscal.
Composição
- Unidade
- Linha da DCA: conta (código e nome), coluna, exercício, valor nominal em R$ 1,00.
- Métricas
- Receitas brutas realizadas, despesas empenhadas e despesas liquidadas (exercício 2025), cada uma com conta, coluna e estágio explícitos.
- Município
- Piracicaba/SP, código IBGE 3538709.
Cobertura: Exercício 2025, 500 linhas dos anexos I-C (receitas) e I-D (despesas), 2 fontes Siconfi.
Como é coletado
- Fonte oficial
- Tesouro Nacional, Siconfi, API pública da DCA (apidatalake.tesouro.gov.br/ords/siconfi/tt/dca).
- Método
- Requisição por anexo e exercício, timeout de 25 s, cache em arquivo com "último bom". Unidade confirmada no manual oficial da DCA 2025 (item 3 das Regras Gerais): valores em unidades de reais, sem escala de milhares.
- Cadência
- Rotina diária às 06h10; a DCA muda raramente (homologação e retificações anuais).
- Orçamento de requisições
- 2 requisições ao Siconfi por dia.
- Túnel
- Não há.
Pré-processamento e limpeza
- Linhas preservadas como publicadas; nenhuma soma de níveis hierárquicos ou de estágios.
- A data de coleta não é a data de homologação ou retificação (o endpoint não a informa).
Checks de qualidade aplicados
- Esquema: valor numérico e conta identificada; linha incompleta é descartada e contada; data de coleta futura é rejeitada.
- Totais: os três totais publicados (receita realizada, despesa empenhada, despesa liquidada) são lidos de contas e colunas fixas, nunca somados de linhas; comparação interanual só com mesma conta, coluna, estágio e unidade, e a análise declara quando a comparabilidade não foi verificada.
- Cache com "último bom": fonte fora do ar mantém o corte anterior com status "stale". Este dataset ainda não tem checagem automática diária: ele não passa pela verificação antes de publicar nem pelo recheque noturno das outras fichas.
Licença e usos
- Licença
- Dados abertos do Tesouro Nacional.
- Usos
- Análise fiscal com e sem inflação, painéis municipais, comparação entre cidades que tenham o mesmo recorte. Receita realizada, despesa empenhada e liquidada são medidas distintas: não representam saldo fiscal por subtração.
Limitações conhecidas
- Só Piracicaba e só 2025 neste corte.
- Retificações posteriores da prefeitura não têm data no endpoint.
Distribuição
| Endpoint | Descrição |
|---|---|
GET /api/municipio/3538709 | Métricas e linhas da DCA (também em CSV com ?format=csv). |
Metadados (DCAT / schema.org Dataset)
- dct:identifier
- contas-municipais
- dct:publisher
- PIRANOT
- dct:source
- Tesouro Nacional (Siconfi)
- dct:license
- dados abertos
- dct:temporal
- 2025
- dct:spatial
- Piracicaba/SP
- dct:accrualPeriodicity
- anual
- dcat:distribution
- JSON e CSV via API
Histórico de versões
| Versão | Mudança |
|---|---|
| 1.0 (20/10/2026) | DCA 2025 de Piracicaba, três totais e 500 linhas, análise cruzada com o IPCA. |
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.