Documentación · Modelo de datos

Estructura de las entidades

Nuestros archivos masivos y nuestra API describen el mundo como entidades: personas, empresas, embarcaciones y los listados que las nombran. Esta página explica el objeto JSON de una entidad, cómo se refieren entre sí las entidades y cómo se organizan los archivos de entidades.

Entidades

Una entidad es un objeto JSON con unos pocos campos fijos y un objeto properties. Esta es una persona de la lista de congelación de activos de Mónaco tal como aparece en entities.ftm.json:

{
  "id": "crown-379759982",
  "caption": "SULTAN AZIZ AZAM",
  "schema": "Person",
  "properties": {
    "name": [
      "SULTAN AZIZ AZAM"
    ],
    "topics": [
      "sanction"
    ],
    "alias": [
      "AZIZ AZAM",
      "SULTAN AZIZ",
      "SULTAN AZZIZ AZZAM",
      "SULTAN AZIZ EZZAM"
    ],
    "birthDate": [
      "1985"
    ],
    "nationality": [
      "af"
    ],
    "notes": [
      "Nat: AFGHANISTAN · DOB: 1985"
    ]
  },
  "referents": [],
  "datasets": [
    "monaco_siccfin_liste_nationale_de_gel_des_fonds"
  ],
  "first_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_change": "2026-09-24T11:22:17.136797+00:00",
  "target": true,
  "canonical_id": "crown-e-d9d87cf7-081f-41c3-bcd3-42a1194a9e9d"
}

Todo valor de propiedad es una lista, incluso cuando el publicador da un solo valor, porque muchos publicadores indican varios nombres o fechas de nacimiento para la misma persona. Las propiedades que admite cada esquema se encuentran en el diccionario de datos.

Campos fijos

Campo	Tipo	Descripción
`id`	string	El ID de nuestro registro: `crown-` más el número de registro en nuestro registro. Es estable mientras el publicador mantenga el listado. Consulte Identificadores y deduplicación.
`schema`	string	El tipo de entidad, como `Person` o `Vessel`. Consulte Tipos de esquema.
`caption`	string	Un nombre para mostrar de la entidad. Consulte Cómo se eligen los títulos.
`properties`	objeto	Nombres de propiedades asociados a listas de valores.
`datasets`	lista de cadenas	El registro de origen del que proviene el registro, como nombre corto. Hoy siempre es un solo valor, porque cada registro proviene de un único registro de origen.
`referents`	lista de cadenas	IDs anteriores que ahora apuntan a esta entidad. Hoy siempre está vacío: todavía no retiramos ni fusionamos IDs entre sí.
`target`	booleano	Verdadero para la parte listada; ausente en la entidad `Sanction`. Consulte Objetivo.
`canonical_id`	string	Presente cuando el registro se ha agrupado con registros de la misma parte en otros registros: `crown-e-` más un UUID. Consulte Cómo se fusionan los registros.
`first_seen`	timestamp	Consulte Marcas de tiempo.
`last_seen`	timestamp	Consulte Marcas de tiempo.
`last_change`	timestamp	Consulte Marcas de tiempo.

Cómo se eligen los títulos

El título de una parte es su nombre principal exactamente como lo escribió el publicador, incluidas sus mayúsculas y el orden de las palabras (AZAM, SULTAN AZIZ en una lista, SULTAN AZIZ AZAM en otra). Todavía no elegimos una grafía preferida entre registros. El título de una entidad Sanction es su programa o, cuando no hay programa, el nombre del registro.

Marcas de tiempo

Las marcas de tiempo usan el formato ISO 8601 en UTC con un desfase de zona horaria.

Campo	Significado actual
`first_seen`	Cuando nuestro recolector cargó por primera vez este registro desde el publicador.
`last_seen`	Cuando el registro se confirmó por última vez en la lista del publicador, en la ejecución exitosa más reciente de esa fuente.
`last_change`	Por ahora se establece con el mismo valor que `last_seen`. Una fecha real de «último cambio» requiere instantáneas por ejecución, que están previstas (elemento 18 del backlog de datos).

Estas fechas describen nuestra recopilación, no el listado. Cuando necesite la fecha en que se listó a una persona, use listingDate de la entidad Sanction si el publicador la proporciona, o consulte el registro del propio publicador.

Referencias entre entidades

Una propiedad de tipo entity contiene el ID de otra entidad. Hoy la única propiedad de este tipo es entity en la entidad Sanction, que apunta a la parte listada. El listado de la persona anterior es una línea aparte en el mismo archivo:

{
  "id": "crown-379759982-sanction",
  "schema": "Sanction",
  "caption": "Personne physique",
  "properties": {
    "entity": [
      "crown-379759982"
    ],
    "authority": [
      "Monaco SICCFIN — Liste nationale de gel des fonds"
    ],
    "program": [
      "Personne physique"
    ]
  },
  "datasets": [
    "monaco_siccfin_liste_nationale_de_gel_des_fonds"
  ],
  "first_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_change": "2026-09-24T11:22:17.136797+00:00"
}

Aquí el publicador colocó el tipo de parte («Personne physique») en su columna de programa, y conservamos su redacción. Interprete los campos Sanction como del publicador, no como una clasificación nuestra.

Relaciones

FollowTheMoney modela vínculos como la propiedad, los cargos directivos, los lazos familiares y los asociados como entidades propias que apuntan a dos partes. Todavía no publicamos ninguna entidad de relación. Las declaraciones de beneficiario final (por ejemplo, el registro del Reino Unido de personas con control significativo) se conservan en nuestras tablas de registros, pero no forman parte de los archivos de entidades. La creación de un modelo de relaciones es un trabajo planificado (elemento 23 del backlog de datos).

Archivos de entidades

Nuestros archivos de entidades están en formato JSON Lines: un objeto JSON completo por línea, sin un arreglo que los envuelva, de modo que un archivo de cualquier tamaño pueda leerse línea por línea. En entities.ftm.json, a cada parte le sigue en la línea siguiente su entidad Sanction. Los archivos de cada colección, con tamaños y sumas de verificación, se enumeran en Uso de los datos masivos; la forma de aplicar los cambios entre compilaciones se explica en Archivos delta.

# after downloading a collection's file
head -2 entities.ftm.json          # first party and its listing
wc -l entities.ftm.json            # number of entities (parties + listings)

Herramientas para datos de FollowTheMoney

Como nuestros archivos siguen FollowTheMoney, las herramientas escritas para ese modelo pueden leerlos. Son proyectos de terceros; no los mantenemos nosotros.

Documentación de FollowTheMoney, que incluye la referencia de cada esquema y tipo de propiedad.
El paquete de Python followthemoney, que lee, valida y convierte archivos de entidades.

Véase también: Temas de riesgo, Glosario: conjunto de datos, Todas las fuentes de datos.

Última actualización: 2026-10-04