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

# Empresas proveedoras: registro KYB persistente

> Las empresas en Didit unifican historial KYB, datos de registro, UBO, directivos, AML, documentos y transacciones en un perfil único y persistente.

Una **entidad empresarial** representa a una persona jurídica (sociedad, LLC, fondo, fundación, empresa unipersonal, fideicomiso) en cada verificación KYB, transacción e interacción de cumplimiento que tiene con tu plataforma en Didit.

Al igual que las entidades de usuario, las entidades de empresa se identifican por `vendor_data` y agrupan todas las sesiones y transacciones vinculadas en un único perfil.

## Qué contiene una empresa

| Categoría | Campos / objetos |
| - | - |
| **Identidad** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Estado** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sesiones** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Actividad** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Personas clave** | Directivos, directores, UBO y beneficiarios finales vinculados (cada uno puede vincularse a una entidad de usuario para KYC) |
| **Documentos** | Certificados de constitución, estatutos sociales, libros de registro de accionistas, POA, estados financieros, documentos personalizados |
| **AML** | Resultados del análisis de sanciones, PEP y medios adversos a nivel de empresa |
| **Metadatos** | JSON arbitrario para tus propios datos |

Consulta el [modelo de datos de empresa](https://docs.didit.me/es/entities/businesses/data-model.md) completo para ver los tipos de campo y los casos límite.

## Cuándo se crea una empresa

**1. Automáticamente: desde una sesión de Verificación de empresas (KYB)**

Cuando creas una sesión de Verificación de empresas (KYB) con un `vendor_data` que Didit nunca ha visto, se crea una entidad de empresa en estado `ACTIVE` y se vincula a esa sesión.

**2. Explícitamente: mediante POST /v3/businesses/create/**

Crea la empresa por adelantado, antes de ejecutar cualquier sesión de Verificación de empresas (KYB). Resulta útil para cargar metadatos iniciales o hacer el onboarding masivo de empresas.

**3. Desde la consola**

Tu equipo crea la empresa desde la página Empresas; por ejemplo, al hacer manualmente el onboarding de una empresa verificada mediante un proceso fuera de línea.

## Qué puedes hacer

| Operación | Cómo |
| - | - |
| [Listar empresas](https://docs.didit.me/es/entities/businesses/operations.md#listar-empresas) | `GET /v3/businesses/` con filtros |
| [Obtener una empresa](https://docs.didit.me/es/entities/businesses/operations.md#obtener-una-empresa) | `GET /v3/businesses/{vendor_data}/` |
| [Crear una empresa](https://docs.didit.me/es/entities/businesses/operations.md#crear-una-empresa) | `POST /v3/businesses/create/` |
| [Actualizar el perfil](https://docs.didit.me/es/entities/businesses/operations.md#actualizar-una-empresa) | `PATCH /v3/businesses/{vendor_data}/` |
| [Cambiar el estado](https://docs.didit.me/es/entities/businesses/operations.md#cambiar-el-estado) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Eliminar empresas](https://docs.didit.me/es/entities/businesses/operations.md#eliminar-empresas-por-lotes) | `POST /v3/businesses/delete/` (por lotes) |
| [Revisar el historial KYB](https://docs.didit.me/es/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Revisar transacciones](https://docs.didit.me/es/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Inspeccionar personas clave](https://docs.didit.me/es/entities/businesses/key-people.md) | Mediante las decisiones de las sesiones de Verificación de empresas (KYB) |
| [Añadir a la lista de bloqueo](https://docs.didit.me/es/entities/businesses/blocklist.md) | Consola + API de listas |
| [Importar / exportar](https://docs.didit.me/es/entities/businesses/import-export.md) | Solo en la consola (CSV) |
| [Gestionar en la consola](https://docs.didit.me/es/entities/businesses/console.md) | Recorrido completo por la interfaz |

## Relaciones empresa ↔ usuario

Una entidad Business rara vez existe de forma aislada. Durante el [KYB](https://docs.didit.me/es/business-verification/overview.md), Didit identifica a cada administrador, director, UBO y beneficiario final. Cada una de esas personas puede vincularse a una entidad de usuario para su KYC individual:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

Cuando uno de los usuarios vinculados tiene un KYC fallido o una coincidencia AML, esto se propaga al perfil de riesgo de la empresa. Consulta [Personas clave](https://docs.didit.me/es/entities/businesses/key-people.md) para ver el patrón de vinculación.

## Empresa frente a sesión de empresa

Una **sesión de empresa** es un único evento de verificación KYB. Una **entidad de empresa** es el perfil permanente que agrupa todas las sesiones.

Una misma empresa puede tener muchas sesiones de Verificación de empresas (KYB): verificación inicial, reenvíos, re-KYB periódico. El mapa `features` de la empresa refleja el estado más reciente de todas las sesiones.

## Próximos pasos

> [card] [Modelo de datos](https://docs.didit.me/es/entities/businesses/data-model.md)
>
> Cada campo, tipo e índice.

> [card] [Operaciones](https://docs.didit.me/es/entities/businesses/operations.md)
>
> Crear, actualizar, cambiar el estado, eliminar.

> [card] [Historial KYB](https://docs.didit.me/es/entities/businesses/kyb-history.md)
>
> Cada sesión de Verificación de empresas (KYB) vinculada a la empresa.

> [card] [Personas clave](https://docs.didit.me/es/entities/businesses/key-people.md)
>
> Administradores, UBO y vinculación de directores.

> [card] [Lista de bloqueo](https://docs.didit.me/es/entities/businesses/blocklist.md)
>
> Bloquear empresas para que no realicen transacciones.

> [card] [Consola](https://docs.didit.me/es/entities/businesses/console.md)
>
> Recorrido completo por la interfaz de Empresas.


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