> ## 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.

# Entidades: usuarios y empresas en Didit

> Usuarios y empresas son las dos entidades principales de Didit. Cada una reúne sesiones KYC, transacciones, documentos, biometría y riesgo en un solo perfil.

Didit organiza todo lo que ocurre en tu aplicación en torno a dos tipos de entidad principales:

| Entidad | Representa | Vinculada a |
| - | - | - |
| **Usuario** | Una persona física | Sesiones de verificación de usuarios (KYC), biometría facial, transacciones (como solicitante o contraparte), listas de bloqueo |
| **Empresa** | Una persona jurídica (sociedad, LLC, empresario individual, fondo) | Sesiones de verificación de empresas (KYB), directivos, UBO, transacciones (como solicitante o contraparte), listas de bloqueo |

Cada sesión de verificación, cada transacción y cada entrada de la lista de bloqueo puede vincularse a una entidad. Una vez vinculada, la entidad se convierte en un perfil duradero que reúne el historial, las señales de riesgo y el estado de cumplimiento a lo largo del tiempo.

## Entidad frente a sesión

Una **entidad** y una **sesión** son cosas distintas.

| Concepto | Alcance | Duración | Ejemplo |
| - | - | - | - |
| **Sesión** | Un evento de verificación | Un único flujo (de minutos a días mientras está en revisión) | Un solo intento de KYC |
| **Entidad** | Un perfil duradero | Vive mientras el usuario o la empresa exista en tu plataforma | La clienta "Jane Doe" con 3 sesiones de verificación de usuarios (KYC) a lo largo de 2 años |

Una misma entidad puede tener muchas sesiones: reverificaciones, reenvíos, comprobaciones adicionales, monitorización continua periódica. La entidad agrega los resultados.

## Creación automática o precreación manual

Las entidades se crean de una de estas tres formas:

**1. Creada automáticamente desde una sesión**

Cuando creas una sesión con un identificador `vendor_data` y no existe ninguna entidad que coincida, Didit crea la entidad automáticamente. Es el camino más habitual.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

Una entidad Usuario para `user-42` se crea en el momento en que empieza la sesión.

**2. Precreada mediante la Management API**

Crea primero la entidad y después inicia sesiones asociadas a ella. Es útil cuando quieres sembrar señales de riesgo (estado, etiquetas, metadatos personalizados) antes de la primera verificación.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

**3. Creada en la consola**

Tu equipo de cumplimiento puede crear usuarios o empresas directamente desde la Business Console, algo útil para altas manuales, importaciones o flujos de subsanación.

## Cómo las entidades lo vinculan todo

El campo `vendor_data` es la clave de vinculación. Cuando envías `vendor_data` en cualquier sesión o transacción, Didit la dirige a la entidad correspondiente.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

Consulta más detalles en la [guía de vinculación con `vendor_data`](https://docs.didit.me/entities/vendor-data-linking).

## Qué puedes hacer con una entidad

Con cada entidad Usuario o Empresa puedes:

| Operación | Finalidad |
| - | - |
| **Crear / actualizar** | Definir o cambiar los datos del perfil de la entidad (nombre, país, metadatos personalizados) |
| **Cambiar el estado** | Marcarla como `ACTIVE`, `FLAGGED` o `BLOCKED`: la aplicación del bloqueo se propaga a las futuras sesiones y transacciones |
| **Adjuntar biometría** | Subir una referencia facial para búsqueda 1:N, detección de duplicados o listas de bloqueo |
| **Revisar el historial KYC/KYB** | Obtener todas las sesiones vinculadas a la entidad, con los resultados por función |
| **Revisar el historial de transacciones** | Obtener todas las transacciones en las que la entidad es solicitante o contraparte |
| **Añadir a una lista de bloqueo** | Bloquear futuras sesiones o transacciones que involucren a esta entidad |
| **Importar / exportar** | Cargar entidades de forma masiva desde CSV o exportarlas a herramientas externas de cumplimiento |
| **Eliminar** | Eliminar la entidad (el historial se conserva para auditoría) |

Los tutoriales detallados están en [Usuarios](https://docs.didit.me/entities/users/overview.md) y [Empresas](https://docs.didit.me/entities/businesses/overview.md).

## Relaciones entre usuarios y empresas

Un mismo usuario puede estar vinculado a una o varias empresas. Esto ocurre de forma natural durante el KYB:

* Un usuario puede ser **director** de una empresa y **UBO** de otra.
* La sesión de verificación de usuarios (KYC) de un usuario puede vincularse con la sesión de verificación de empresas (KYB) de una empresa mediante el flujo de [personas clave](https://docs.didit.me/business-verification/key-people.md).

Didit conserva estas relaciones: al consultar una entidad Empresa puedes ver todos los usuarios vinculados, y al consultar una entidad Usuario puedes ver todas las empresas con las que está asociada.

## Ciclo de vida y estados

Cada entidad tiene un estado que determina si Didit aplica bloqueos a la nueva actividad:

| Estado | Efecto |
| - | - |
| `ACTIVE` | Normal: las sesiones y transacciones siguen según lo configurado en los flujos y reglas |
| `FLAGGED` | Las sesiones y transacciones se permiten, pero se envían automáticamente a revisión manual |
| `BLOCKED` | Las sesiones y transacciones se rechazan automáticamente y no se pueden crear nuevas sesiones |

Consulta el [ciclo de vida de la entidad](https://docs.didit.me/entities/lifecycle.md) completo para ver las transiciones y los eventos de webhook.

## Siguientes pasos

> **[Ciclo de vida](https://docs.didit.me/entities/lifecycle.md)**
>
> Estados, transiciones y eventos del ciclo de vida de cada entidad.

> **[Vinculación con vendor\_data](https://docs.didit.me/entities/vendor-data-linking.md)**
>
> Cómo `vendor_data` vincula sesiones, transacciones y entidades.

> **[Usuarios](https://docs.didit.me/entities/users/overview.md)**
>
> Análisis en profundidad de las entidades Usuario, sus operaciones y los flujos de la consola.

> **[Empresas](https://docs.didit.me/entities/businesses/overview.md)**
>
> Análisis en profundidad de las entidades Empresa, sus operaciones y los flujos de la consola.

> **[Webhooks de entidades](https://docs.didit.me/entities/webhooks.md)**
>
> Eventos en tiempo real para cada cambio en una entidad.

> **[Lista de bloqueo](https://docs.didit.me/console/blocklist-users.md)**
>
> Cómo interactúan las entradas de la lista de bloqueo con las entidades Usuario y Empresa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.