verificar-dados-publicos

Verifique dados públicos antes de publicá-los

Dados públicos são fáceis de obter e fáceis de interpretar mal. A maioria dos erros não está na chamada da API, mas no que o número significa. Execute esta checklist antes de dar uma resposta, desenhar um gráfico ou publicar uma página, e coloque o que encontrou na saída (uma nota de rodapé, uma linha de ressalva, uma nota "como calculamos"). Nunca esconda uma ressalva para fazer um resultado parecer mais limpo.

Todas as regras abaixo vêm de casos reais. Os exemplos usam dados portugueses, mas as verificações aplicam-se a qualquer país.

Como usar

1. Escreva a afirmação numa frase ("Arouca gasta 845 € por residente em contratos públicos").
2. Passe pelas oito verificações. Para cada uma, confirme ou adicione uma ressalva.
3. Termine a saída com: fontes, período(s) de referência, data de extração, método numa linha e as ressalvas.

As oito verificações

1. Período de referência

• Cada número tem um ano explícito (ou intervalo de datas). "Último" não é um ano.
• Ao combinar fontes, compare os anos delas. Se diferirem, diga-o no gráfico, não apenas numa nota de rodapé.
• Verifique se o período mais recente realmente tem valores: algumas APIs devolvem um ano vazio (Eurostat lastTimePeriod=1 retornou value: {}), e o INE marca anos recentes como "Dado preliminar".
• Observe qual a data que um conjunto de dados usa. Os ficheiros do Portal BASE têm um campo "ano" que é o ano do contrato, enquanto o portal diz que as datas são datas de publicação; escolha um e declare-o.
• Um ano em curso precisa de um etiqueta em todo o lado ("2026 até 4 de outubro") e não deve ser comparado com um ano completo sem o dizer.

Exemplo: contratos são de 2025, a última população do INE é de 2023 → "€/residente = contratos de 2025 ÷ população de 2023".

2. Unidades e escala

• Leia os metadados antes dos dados. Os indicadores de finanças municipais do INE estão em milhares de euros (potência de 10 = 3): 23754 é 23,8 M€, não 23 754 €.
• Verifique moeda, nominal vs real (inflação), base de caixa vs regime de acréscimo, e se "%" significa parte ou variação.
• Valores per capita precisam da população da mesma área e, idealmente, do mesmo ano.

3. O que o número mede

• Nomeie o conceito exatamente. Contratos públicos não são despesa total: cobrem o que foi contratado (e publicado), não salários, transferências ou tudo o que foi pago. A receita e despesa municipais vêm da execução orçamental (DGAL, via INE).
• Valor do contrato ≠ montante pago. No Portal BASE, o campo "preço efetivo" é frequentemente 0 ou está omisso — não o trate como real.
• Estimativas, previsões e transcrições geradas por IA não são registos oficiais. Diga qual é.

4. Cobertura e lacunas

• Verifique entidades e anos em falta (por exemplo, um município sem dados orçamentais para um ano; escolas suprimidas quando têm menos de 15–20 alunos).
• Valores suprimidos ("*", "-99.0", "dado não disponível") estão em falta, nunca são zero. Exclua-os das médias e diga quantos são.
• Se um conjunto de dados estiver abandonado (por exemplo, o feed OCDS do BASE, congelado desde 2020; a API api.openar.pt, arquivada em 2026), não o misture com dados ativos.

5. Números pequenos e valores atípicos

• Um grande item pode dominar um total: em Arouca, um projeto (Parque da Saúde) foi 35% dos contratos de 2025. Diga-o sempre que um item for superior a ~20% do total.
• Populações pequenas tornam os valores per capita instáveis. Classifique locais pequenos e grandes juntos apenas com uma ressalva, ou agrupe por tamanho.
• Mostre incerteza ou o tamanho da amostra onde existir (por exemplo, indicadores escolares "observado vs esperado" com poucos alunos).

6. Entidades e duplicados

• O mesmo fornecedor, escola ou órgão aparece com nomes diferentes → corresponda por um identificador (NIF/NIPC, código DGEEC da escola, código geográfico do INE), não pelo nome.
• Verifique duplicados entre ficheiros (ficheiros anuais que se sobrepõem, o mesmo contrato alterado posteriormente).
• Códigos de classificação podem ser pouco fiáveis (códigos CPV em contratos): use-os como um sinal, verifique e relate a percentagem ainda "sob revisão".
• Nunca publique dados pessoais de particulares. Mascare números de contribuinte pessoais; vereadores e funcionários em cargos públicos estão ok.

7. Comparação justa

• Compare o que é comparável: mesmo período, mesma definição, mesma unidade, tamanho ou contexto semelhante.
• Prefira indicadores ajustados ao contexto a classificações brutas quando existirem (por exemplo, "observado vs esperado para um perfil semelhante" nas escolas).
• Apresente padrões como padrões, não como acusações ("notas acima do perfil esperado", não "inflação de notas pela escola X").

8. Licença e atribuição

• Registe a licença de cada conjunto de dados ou recurso; em dados.gov.pt o mesmo conjunto pode aparecer com licenças diferentes.
• Casos típicos: Portal BASE other-pd (domínio público); INE cc-by (citar INE + código do indicador); IPMA sem uso comercial; Eurostat e BCE livre incl. uso comercial com atribuição; Assembleia da República requer atribuição.
• Se a licença for notspecified ou pouco clara, diga-o e não coloque os dados num produto comercial até ser confirmada.

Template de saída

Termine cada resposta de dados ou página com um bloco como este:

Fontes: Portal BASE/IMPIC via dados.gov.pt (contratos 2025, domínio público) · INE, população residente 2023 (indicador 0008273, CC BY)
Extraído: 2026-11-02
Método: valor dos contratos de 2025 ÷ população residente de 2023
Ressalvas: anos de referência diferentes; contratos ≠ despesa total; um projeto = 35% do total de Arouca

Verificação rápida (quando o tempo é curto)

Ano? Unidade? O que mede exatamente? Algo em falta? Um item a dominar? Mesma entidade contada duas vezes? Comparação justa? Licença? — Se alguma resposta for "não sei", diga-o na saída.