> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de UBO: extracción de beneficiarios finales > Didit extrae beneficiarios finales (UBO) de registros de empresas con cadena de propiedad, porcentajes y screening AML. Desde $2.00 por consulta. Identificar quién posee y controla en última instancia una empresa es la esencia del KYB. Didit obtiene la estructura de propiedad del registro cuando está disponible, permite que el administrador de la empresa la confirme y la amplíe en el flujo alojado y, a continuación, ejecuta una verificación adaptada al rol de cada persona clave. ## Beneficiarios finales (UBO) Un **beneficiario final (UBO, Ultimate Beneficial Owner)** es una persona física que, en última instancia, posee o controla una entidad jurídica. Los UBO aparecen en la decisión de la sesión en `key_people_checks[].registry.beneficial_owners[]` (obtenidos del registro) y en `key_people_checks[].submitted.parties[]` (enviados por el usuario), junto con cualquier otro rol, como accionista o director, en la misma lista. ## Datos recopilados de cada persona clave El flujo alojado recopila un conjunto de campos predeterminado más los campos personalizados que configures en el flujo de verificación (workflow). Los campos predeterminados son: | Campo | Persona | Empresa | | - | :-: | :-: | | `name` o `first_name` + `last_name` | ✅ obligatorio | ✅ obligatorio (`company_name`) | | `email` | ✅ obligatorio | ✅ obligatorio | | `nationality` / país | ✅ obligatorio | ✅ obligatorio | | `role` (uno o más por parte) | ✅ obligatorio | ✅ obligatorio | | `ownership_percent` / `voting_percent` (por rol) | opcional | opcional | | `date_of_birth` | opcional | — | | `phone_number` | opcional | — | | `position` (cargo en texto libre) | opcional | — | | `registration_number` | — | opcional | | `entity_type` | `person` | `company` | `entity_type` se asigna automáticamente según si la parte es una persona física o una entidad corporativa. ### Campos personalizados Los flujos pueden exigir campos adicionales por persona o por empresa, sin límite de cantidad. Se configuran en la Business Console, en el flujo KYB, y aparecen en el objeto `custom_fields` de cada parte en la respuesta de la decisión. Usa los campos personalizados para cosas como declaraciones de origen del patrimonio, residencia fiscal, identificadores internos de cliente o divulgaciones específicas del sector. ## Accionistas corporativos y propiedad anidada Cuando un accionista es a su vez una empresa (y no una persona física), Didit registra: * El nombre de la empresa y su número de registro. * El porcentaje de propiedad que tiene ese accionista corporativo. * El país de constitución. Así puedes seguir la cadena a través de varios niveles hasta llegar a las personas físicas finales. ### KYB anidado para UBO corporativos Cuando el flujo activa el KYB anidado para UBO corporativos, cada entidad corporativa dispara su propia subsesión KYB secundaria: la empresa se verifica con el mismo proceso que ejecutas en el nivel superior y su resultado se incorpora a la sesión principal. Está desactivado por defecto; actívalo en cada flujo. ## Umbrales de propiedad La mayoría de las jurisdicciones clasifican como UBO a quien tiene **un 25% o más**. El umbral se configura por flujo: | Jurisdicción | Umbral habitual de UBO | | - | - | | UE (AMLD) | 25% de propiedad o control | | Reino Unido | 25% de las acciones o de los derechos de voto | | EE. UU. (CTA) | 25% de propiedad o control sustancial | | Singapur | 25% de las acciones o del poder de voto | Configúralo en *Workflows → \[tu flujo KYB] → Risk → UBO threshold*. Tu flujo también puede marcar el caso o enviarlo a revisión cuando ningún UBO alcanza el umbral (algo habitual en empresas cotizadas con accionariado muy disperso). ## Derechos de voto frente a derechos económicos Las declaraciones de propiedad distinguen dos tipos de control: | Derecho | Qué significa | | - | - | | **% económico (propiedad)** | Participación en el valor económico de la empresa / derechos a dividendos | | **% de voto** | Participación en el poder de voto en los acuerdos de accionistas | Normalmente coinciden, pero pueden diferir cuando una empresa emite acciones de doble clase o acciones preferentes. Didit registra ambos. Las reglas y los umbrales pueden comprobar cualquiera de los dos: la mayoría de las jurisdicciones exigen declarar al UBO cuando *cualquiera* de ellos supera el 25%. ## Propiedad efectiva a través de una cadena Cuando la propiedad pasa por un accionista corporativo, la propiedad efectiva de una persona física de un nivel inferior de la cadena se calcula multiplicando los porcentajes a lo largo de la cadena. ### Ejemplo: cadena de 3 niveles ``` Acme Corp (target) └─ 60% → Acme Holdings Ltd └─ 75% → Jane Doe (natural person) └─ 40% → John Smith (natural person) ``` UBO calculados: * **Jane Doe**: propiedad efectiva de Acme Corp = 60% × 75% = **45%** (UBO). * **John Smith**: propiedad efectiva de Acme Corp = **40%** (UBO). Con un umbral de UBO del 25%, se declaran tanto Jane como John. Con un umbral del 50%, ningún UBO lo alcanza, y Didit lo marca como un problema de transparencia. ## Cómo la configuración de roles determina la verificación Cada rol se configura de forma individual en cada flujo KYB: si está activado o desactivado, si requiere KYC, qué flujo KYC se usa para ese rol y si el usuario final puede optar por omitirlo. Cuando se envía una persona clave: 1. Didit compara los roles de la parte enviada con la configuración de roles del flujo. 2. Para los roles que requieren verificación, se inicia una sesión de verificación secundaria: * **Partes de tipo persona** → sesión secundaria de Verificación de usuarios (KYC), con el flujo KYC específico del rol o con el predeterminado. * **UBO corporativos** (cuando el KYB anidado está activado) → subsesión secundaria de Verificación de empresas (KYB). 3. Para los roles marcados como omitibles, el usuario final ve la opción "omitir verificación" y puede no realizarla; las partes omitidas quedan registradas, pero no bloquean la sesión principal. 4. Las partes por debajo del umbral de propiedad del flujo no activan una verificación individual, aunque el rol la requiera en otras circunstancias. Configura todo esto en *Workflows → \[tu flujo KYB] → Key People* en la Business Console. ## Monitorización de accionistas y UBO > [!NOTE] > > La monitorización del registro estará **disponible próximamente**. Ningún país del catálogo minorista de staging revisado el 7 de septiembre de 2026 tiene la monitorización habilitada. La tarifa configurada es de USD 2.00 por empresa al año; que exista un precio no significa que la función esté disponible. El comportamiento que se describe a continuación corresponde al servicio previsto tras su lanzamiento. Una empresa verificada en el nivel **Shareholders** o **UBO** puede mantenerse bajo **monitorización continua del registro**. El registro envía los cambios en el estado de la empresa, los directivos, la propiedad y el domicilio social; con cada cambio, Didit: * devuelve la sesión de la empresa de *Aprobado* a *En revisión* y registra el cambio en la sesión; * envía un [webhook](https://docs.didit.me/es/business-verification/webhooks.md) `data.updated` con `trigger: "kyb_registry_change"`; * mantiene actualizado el registro de la empresa. La monitorización **solo está disponible en los países donde está permitido**: el proveedor del registro debe ofrecer un servicio de vigilancia para esa jurisdicción. La lista completa está en la [tabla de países con monitorización continua](https://docs.didit.me/es/business-verification/supported-countries.md#monitorización-continua-del-registro). Una empresa verificada en el nivel Lite, o en un país que no figura en esa lista, no se inscribe, y la página de la empresa indica el motivo. Actívala en cada flujo desde *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Cuesta **\$2.00 por empresa al año** y se factura en la inscripción y en cada renovación anual. Cuando la wallet no puede cubrir una renovación, la monitorización se detiene para esa empresa en lugar de seguir funcionando sin pagar. Puedes cancelarla en cualquier momento desde la página de la empresa (*KYB Registry Check → Registry monitoring*). ## Conciliación entre el registro y los datos enviados por el usuario La respuesta muestra ambas fuentes una junto a otra en `key_people_checks[]`: * `registry.officers[]` y `registry.beneficial_owners[]`: lo que divulgó el proveedor. * `submitted.parties[]`: lo que el administrador de la empresa envió explícitamente a través del flujo, con `source: "USER"`. Los analistas comparan visualmente ambos grupos en la consola para detectar UBO que faltan, partes adicionales no declaradas o porcentajes de propiedad que no coinciden. No existe un endpoint de comparación automática: puedes hacer la conciliación por tu cuenta cruzando nombre, rol y propiedad cuando corresponda. ## Análisis AML Cada persona clave identificada se analiza automáticamente frente a listas de vigilancia AML globales, tanto con los datos del registro como con los datos enviados. Consulta [Análisis AML de empresas](https://docs.didit.me/es/business-verification/aml.md) para ver cómo se combinan los análisis AML a nivel de empresa y a nivel de persona. ## Próximos pasos > [card] [Personas clave](https://docs.didit.me/es/business-verification/key-people.md) > > El flujo de personas clave de principio a fin. > [card] [Directivos y representantes](https://docs.didit.me/es/business-verification/officers.md) > > Los roles de gobernanza dentro del modelo de personas clave. > [card] [Evaluación de riesgos](https://docs.didit.me/es/business-verification/risk-assessment.md) > > Qué determina el resultado de un KYB. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.