verificar-dados-publicos

Verifica los datos públicos antes de publicarlos

Los datos públicos son fáciles de obtener y fáciles de malinterpretar. La mayoría de los errores no están en la llamada a la API, sino en lo que significa el número. Ejecuta esta lista de verificación antes de dar una respuesta, dibujar un gráfico o publicar una página, y coloca lo que encuentres en la salida (una nota al pie, una línea de advertencia, una nota de "cómo calculamos"). Nunca ocultes una advertencia para que un resultado parezca más limpio.

Cada regla a continuación proviene de un caso real. Los ejemplos usan datos portugueses, pero las comprobaciones aplican a cualquier país.

Cómo usarlo

1. Escribe la afirmación en una oración ("Arouca gasta 845 € por residente en contratos públicos").
2. Revisa las ocho comprobaciones. Para cada una, confírmala o añade una advertencia.
3. Termina la salida con: fuentes, período(s) de referencia, fecha de extracción, método en una línea y las advertencias.

Las ocho comprobaciones

1. Período de referencia

• Cada número recibe un año (o rango de fechas) explícito. "Último" no es un año.
• Al combinar fuentes, compara sus años. Si difieren, indícalo en el gráfico, no solo en una nota al pie.
• Verifica que el último período realmente tenga valores: algunas APIs devuelven un último año vacío (Eurostat lastTimePeriod=1 devolvió value: {}), e INE marca los años recientes como "Dado preliminar".
• Presta atención a qué fecha usa un conjunto de datos. Los archivos del Portal BASE tienen un campo "año" que es el año del contrato, mientras que el portal dice que las fechas son de publicación; elige uno y decláralo.
• Un año en curso necesita una etiqueta en todas partes ("2026 hasta 4 Oct"), y no debe compararse con un año completo sin decirlo.

Ejemplo: los contratos son de 2025, la población INE más reciente es de 2023 → "€/residente = contratos 2025 ÷ población 2023".

2. Unidades y escala

• Lee los metadatos antes que los datos. Los indicadores de finanzas municipales del INE están en miles de euros (potencia de 10 = 3): 23754 son 23,8 M €, no 23.754 €.
• Verifica moneda, nominal vs real (inflación), base de caja vs devengo, y si "%" significa proporción o cambio.
• Las cifras per cápita necesitan la población de la misma área y, idealmente, del mismo año.

3. Lo que mide el número

• Nombra el concepto exactamente. Los contratos públicos no son el gasto total: cubren lo contratado (y publicado), no salarios, transferencias ni todo lo pagado. Los ingresos y gastos municipales provienen de la ejecución presupuestaria (DGAL, vía INE).
• El valor del contrato ≠ cantidad pagada. En el Portal BASE, el campo "precio efectivo" suele ser 0 o faltar; no lo trates como real.
• Las estimaciones, pronósticos y transcripciones generadas por IA no son registros oficiales. Di cuál es.

4. Cobertura y lagunas

• Verifica entidades y años faltantes (p. ej., un municipio sin datos de presupuesto por un año; escuelas suprimidas cuando hay menos de 15–20 alumnos).
• Los valores suprimidos ("*", "-99.0", "dado não disponível") son faltantes, nunca cero. Exclúyelos de los promedios y di cuántos hay.
• Si un conjunto de datos está abandonado (p. ej., el feed OCDS de BASE, congelado desde 2020; la API api.openar.pt, archivada en 2026), no lo mezcles con datos activos.

5. Números pequeños y atípicos

• Un elemento grande puede dominar un total: en Arouca, un proyecto (Parque da Saúde) fue el 35% de los contratos de 2025. Dilo siempre que un elemento sea más de ~20% del total.
• Las poblaciones pequeñas hacen que las cifras per cápita sean volátiles. Clasifica lugares pequeños y grandes juntos solo con una advertencia, o agrupa por tamaño.
• Muestra la incertidumbre o el tamaño de la muestra donde exista (p. ej., indicadores de escuelas "observado vs esperado" con pocos alumnos).

6. Entidades y duplicados

• El mismo proveedor, escuela u organismo aparece con diferentes nombres → empareja por un identificador (NIF/NIPC, código de escuela DGEEC, código geográfico INE), no por el nombre.
• Verifica duplicados en archivos (archivos anuales que se superponen, el mismo contrato modificado posteriormente).
• Los códigos de clasificación pueden no ser fiables (códigos CPV en contratos): úsalos como señal, verifica e informa la proporción aún "en revisión".
• Nunca publiques datos personales de individuos privados. Enmascara los números de identificación fiscal personales; los concejales y funcionarios en funciones públicas están bien.

7. Comparación justa

• Compara como con como: mismo período, misma definición, misma unidad, tamaño o contexto similar.
• Prefiere indicadores ajustados por contexto a clasificaciones brutas cuando existan (p. ej., "observado vs esperado para un perfil similar" de escuelas).
• Presenta patrones como patrones, no como acusaciones ("calificaciones por encima del perfil esperado", no "inflación de calificaciones por parte de la escuela X").

8. Licencia y atribución

• Registra la licencia de cada conjunto de datos o recurso; en dados.gov.pt el mismo conjunto puede aparecer con licencias diferentes.
• Casos típicos: Portal BASE other-pd (dominio público); INE cc-by (citar INE + código del indicador); IPMA sin uso comercial; Eurostat y BCE, gratuitos incl. comercial con atribución; Assembleia da República requiere atribución.
• Si la licencia es notspecified o no está clara, dilo y no pongas los datos en un producto comercial hasta que se confirme.

Plantilla de salida

Termina cada respuesta de datos o página con un bloque como este:

Fuentes: Portal BASE/IMPIC vía dados.gov.pt (contratos 2025, dominio público) · INE, población residente 2023 (indicador 0008273, CC BY)
Extraído: 2026-11-02
Método: valor de los contratos 2025 ÷ población residente 2023
Advertencias: diferentes años de referencia; contratos ≠ gasto total; un proyecto = 35% del total de Arouca

Pase rápido (cuando hay poco tiempo)

¿Año? ¿Unidad? ¿Qué mide exactamente? ¿Falta algo? ¿Un elemento domina? ¿Misma entidad contada dos veces? ¿Comparación justa? ¿Licencia? — Si alguna respuesta es "no estoy seguro", dilo en la salida.