Documentación · Modelo de datos
Modelo de datos de declaraciones
Detrás de cada entidad hay una lista de declaraciones: una fila por cada valor de propiedad, que indica qué registro lo aportó y cuándo lo vimos. Es un tema avanzado; la mayoría de los usuarios necesita entidades o los archivos simplificados.
Por qué declaraciones
Una declaración es una afirmación: el registro X indica que la entidad Y tiene la propiedad P con el valor V. Almacenar afirmaciones en lugar de entidades ya terminadas nos permite:
- Mostrar de dónde proviene cada valor. Cada nombre, alias y fecha de nacimiento lleva el registro que lo publicó.
- Rastrear cuándo aparecieron y desaparecieron los valores, mediante las fechas de primera y última vez visto de cada valor.
- Agrupar y desagrupar registros de una misma parte sin perder qué registro dijo qué, porque la agrupación es una columna aparte.
Un ejemplo
Las tres primeras declaraciones de la persona de Estructura de la entidad (la inclusión de Mónaco de SULTAN AZIZ AZAM), tomadas de statements.csv en la colección de sanciones:
id,entity_id,canonical_id,prop,prop_type,schema,value,dataset,lang,original_value,first_seen,last_seen
44bed04083bd94817f36cb504c78db790fe7beac,crown-379759982,crown-e-d9d87cf7-081f-41c3-bcd3-42a1194a9e9d,name,name,Person,SULTAN AZIZ AZAM,monaco_siccfin_liste_nationale_de_gel_des_fonds,,,2026-09-24T11:22:17.136797+00:00,2026-09-24T11:22:17.136797+00:00
b6ed8c613f329697bad4942d1e965b7ecc7aa906,crown-379759982,crown-e-d9d87cf7-081f-41c3-bcd3-42a1194a9e9d,topics,topic,Person,sanction,monaco_siccfin_liste_nationale_de_gel_des_fonds,,,2026-09-24T11:22:17.136797+00:00,2026-09-24T11:22:17.136797+00:00
a5fa4189ae50a6cf856505cecec63bc9c4ac02ac,crown-379759982,crown-e-d9d87cf7-081f-41c3-bcd3-42a1194a9e9d,alias,name,Person,AZIZ AZAM,monaco_siccfin_liste_nationale_de_gel_des_fonds,,,2026-09-24T11:22:17.136797+00:00,2026-09-24T11:22:17.136797+00:00
La inclusión en la lista tiene sus propias declaraciones bajo el ID crown-379759982-sanction, una para cada uno de entity, authority y program.
Columnas de statements.csv
| Columna | Tipo | Descripción |
|---|---|---|
id | string | Una huella de la declaración: el hash SHA-1 del ID de la entidad, la propiedad y el valor. La misma afirmación conserva el mismo ID entre compilaciones. |
entity_id | string | El ID del registro (crown-…) al que pertenece el valor. |
canonical_id | string | La entidad combinada a la que pertenece el registro (crown-e-…), o de nuevo el ID del registro cuando no se ha combinado. Las declaraciones de una inclusión en la lista siempre repiten su propio ID. Consulte Identificadores y deduplicación. |
prop | string | El nombre de la propiedad, como name o birthDate. |
prop_type | string | El tipo de la propiedad, como name, date o country. Consulte Tipos de propiedad. |
schema | string | El esquema de la entidad, como Person o Sanction. |
value | string | El valor, normalizado al formato de su tipo. |
dataset | string | El registro de origen que aportó el valor. |
lang | string | Idioma del valor. Actualmente vacío. |
original_value | string | El valor antes de la normalización, cuando difiere. Actualmente vacío. |
first_seen | timestamp | Cuándo se cargó por primera vez el registro que contiene este valor. |
last_seen | timestamp | Cuándo el publicador confirmó el registro por última vez. |
Los archivos de declaraciones de FollowTheMoney suelen incluir también una columna target; los nuestros no. Use en su lugar el campo target de la entidad.
Hasta qué fecha se remontan los datos
Comenzamos a registrar las fechas de primera vez visto cuando se cargó cada fuente por primera vez. La fecha de primera vez visto más antigua en Crown Default es —. Un valor visto por primera vez en esa fecha pudo haberse publicado mucho antes. Actualmente las fechas son por registro y no por valor: todas las declaraciones de un registro comparten las fechas del registro.
Descargar
statements.csv se publica para cada colección. En Crown Default contiene — declaraciones; los enlaces, tamaños y sumas de verificación están en Uso de los datos masivos y en la página de Crown Default. El uso de los archivos se rige por nuestra licencia de datos.
Cómo se comparan y agrupan los registros se explica en Metodología.
Última actualización: 2026-10-04