Documentación · Datos masivos
Uso de los datos masivos
Todas las colecciones que publicamos pueden descargarse completas como un conjunto de archivos, reconstruidos a partir del registro y publicados en direcciones fijas. Esta guía le ayuda a decidir si los archivos masivos se ajustan a su trabajo, qué colección elegir y dónde continuar la lectura.
¿Debo usar datos masivos?
Hay tres maneras de usar nuestros datos. Elija la que se ajuste a cuántos nombres verifica y dónde debe ejecutarse su proceso de coincidencia.
| Enfoque | Adecuado para | Punto de partida |
|---|---|---|
| API de verificación | Verificar clientes o contrapartes uno por uno, o en lotes pequeños (hasta 20 consultas por solicitud), con nuestro motor de coincidencias que puntúa cada resultado. | Primeros pasos con la API, herramienta de verificación |
| Archivos masivos | Ejecutar su propio proceso de coincidencias o resolución de entidades, cargar los datos en un almacén de datos o un grafo, realizar análisis e investigación, o trabajar sin conexión. | Esta sección |
| Implementación autoalojada | Ejecutar el servicio de verificación dentro de su propio entorno. | Implementación local (on-premise) |
Los archivos masivos le entregan todos los registros de una vez, pero el proceso de coincidencias queda a su cargo: variantes de nombres, transliteración, fechas e identificadores deben tratarse de su lado. Si solo necesita saber si unos pocos miles de nombres aparecen en una lista, la API suele implicar menos trabajo.
Comprensión del modelo de datos
Cada fila de un registro de origen se convierte en un registro (una Person, Company, Organization, Vessel, Airplane o LegalEntity), con un id de la forma crown-<number>. Su inclusión en ese registro es una entidad Sanction independiente, crown-<number>-sanction, que contiene el registro, el programa, el enlace a la fuente y la fecha de inclusión. Cuando hemos identificado registros de distintos registros como la misma parte, comparten un canonical_id.
Cada registro lleva un tema de riesgo, tomado del tipo de lista de su registro:
| Tipo de lista del registro | Tema en los archivos |
|---|---|
| Sanciones | sanction |
| Personas expuestas políticamente | role.pep |
| Inhabilitación y exclusión | debarment |
| Órdenes fiscales, insolvencia | reg.action |
Más información en la referencia del modelo, la estructura de entidades, los temas de riesgo y el modelo de datos de declaraciones. La misma descripción se publica como JSON en /downloads/meta/model.json, de modo que un cargador pueda leerla.
Elección de una colección
Una colección es un conjunto de registros que se publican juntos. Hay cinco disponibles como archivos masivos:
| Colección | Contiene | Registros | Registros | Compilada |
|---|---|---|---|---|
default | Todos los registros siguientes en un solo conjunto de archivos | — | — | — |
sanctions | Registros de sanciones | — | — | — |
peps | Personas expuestas políticamente | — | — | — |
crime | Inhabilitación para contratar, exclusión y sanciones administrativas | — | — | — |
maritime | Embarcaciones y registros que incluyen un número IMO | — | — | — |
Recomendamos default. Las colecciones más pequeñas son subconjuntos de esta, por lo que no pierde nada al tomar la colección completa y filtrarla usted mismo, y mantiene un solo flujo de procesamiento cuando cambian sus necesidades. Filtre por el tema o por el registro de origen (el campo datasets). Por ejemplo, con jq:
# only politically exposed persons
jq -c 'select(.properties.topics // [] | index("role.pep"))' entities.ftm.json
# only records from one register, by its short identifier
jq -c 'select(.datasets | index("ofac_sdn"))' targets.nested.json¿Solo desea PEPs? Consulte Uso de datos de PEP.
Los archivos contienen únicamente registros cuyos términos permiten la redistribución (consulte las posiciones de licencia), por lo que sus totales son menores que las cifras consultables en el sitio. Por ejemplo, la búsqueda contiene 1,283,679 registros de PEP, mientras que la descarga de peps contiene —.
Los datos de referencia de registros mercantiles (registros de empresas, beneficiarios finales, identificadores de valores) no se publican como archivos masivos: consulte Conozca a su empresa y Valores.
Formatos de datos y actualizaciones
Cada colección se publica en varios formatos a partir de la misma compilación, por lo que los ids de los registros coinciden entre archivos. Formatos de datos los compara; Mantener los datos al día explica las direcciones, el índice de compilaciones y las sumas de verificación; Archivos delta explica las actualizaciones incrementales.
El catálogo de todas las colecciones, con versiones, cifras y tamaños de archivo, está en /downloads/collections/index.json.
Licencias
La descarga no requiere cuenta ni clave. Conforme a nuestra licencia de datos, el uso no comercial es gratuito, siempre que se cite la fuente. El uso comercial, como verificar a sus clientes o incorporar los datos a un producto, requiere una licencia comercial; consulte también uso gratuito y no comercial. Los términos propios de cada registro prevalecen cuando son más estrictos.
Dondequiera que reproduzca los datos, cite la fuente con este formato (de la sección 5.1 de la licencia de datos):
Source: [Source Publisher name], compiled by Crown Intelligence (crownintelligence.net).
Data as of [date shown on record]. Verify against the original source before relying on this information.Nuestros textos legales son borradores pendientes de revisión por asesores jurídicos canadienses; las versiones publicadas los reemplazarán.
Relacionado: Crown Default · Sanciones · PEPs · Marítimo · Conozca a su empresa · Valores · Enriquecimiento de datos
Última actualización 2026-10-03