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

# Modelo de datos de empresas: esquema KYB

> Modelo de entidad Empresa de Didit: datos de registro, UBO, directivos, estado AML, documentos, sesiones KYB y transacciones vinculadas.

Esta página documenta todos los campos de una empresa y cómo Didit rellena cada uno.

## Campos de identidad

| Campo | Tipo | Descripción |
| - | - | - |
| `uuid` | UUID | Clave primaria asignada por Didit. Estable y única. |
| `didit_internal_id` | string | Identificador interno legible. |
| `vendor_data` | string | Tu identificador para la empresa. Único por aplicación. [Más información](https://docs.didit.me/es/entities/vendor-data-linking.md). |
| `display_name` | string | Nombre personalizado que se muestra en la consola. Por defecto, `legal_name` o `vendor_data`. |
| `legal_name` | string | Razón social tal como figura en el registro. Se toma de la consulta al registro de la última sesión de Verificación de empresas (KYB) aprobada. |
| `registration_number` | string | Número de registro oficial de la empresa. Se toma del registro. |
| `country_code` | string (ISO 3166-1 alpha-3) | País de constitución. |

> [!NOTE]
>
> `legal_name`, `registration_number` y `country_code` son de solo lectura cuando proceden de una consulta verificada al registro. Puedes modificarlos manualmente en la consola o mediante `PATCH /v3/businesses/{vendor_data}/`, pero las modificaciones quedan marcadas en el registro de auditoría.

## Estado

| Campo | Tipo | Valores | Descripción |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Controla la aplicación de restricciones en futuras sesiones y transacciones. Consulta el [ciclo de vida](https://docs.didit.me/es/entities/lifecycle.md). |

## Campos agregados de sesiones

| Campo | Tipo | Descripción |
| - | - | - |
| `session_count` | int | Total de sesiones de Verificación de empresas (KYB) creadas para esta empresa |
| `approved_count` | int | Sesiones finalizadas con `Approved` |
| `declined_count` | int | Sesiones finalizadas con `Declined` |
| `in_review_count` | int | Sesiones actualmente en `In Review` |
| `features` | object | Estado de la última verificación de la empresa, en la clave `KYB` |

### El mapa `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

El mapa contiene una sola clave, `KYB`, con el estado de la última verificación de la empresa: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` o `"Resub Requested"`.
Para conocer el estado de cada función individual de KYB, consulta la decisión de la sesión.

Usa el mapa `features` como vía rápida para comprobar si una empresa está completamente verificada en este momento sin recorrer todas sus sesiones.

## Marcas de tiempo de actividad

| Campo | Tipo | Se actualiza cuando |
| - | - | - |
| `first_session_at` | Marca de tiempo ISO | Se creó la primera sesión de Verificación de empresas (KYB) |
| `last_session_at` | Marca de tiempo ISO | Se creó o actualizó la sesión más reciente |
| `last_activity_at` | Marca de tiempo ISO | Se produce cualquier cambio: sesión, transacción, estado, perfil, notas |
| `created_at` | Marca de tiempo ISO | Se creó la fila de la entidad |
| `updated_at` | Marca de tiempo ISO | Se actualizó por última vez la fila de la entidad |

## Metadatos

| Campo | Tipo | Descripción |
| - | - | - |
| `metadata` | object (JSON) | JSON de formato libre que controlas |
| `tags[]` | array | Etiquetas gestionadas desde la consola o la API |

## Relaciones (no se almacenan en la registro de la empresa)

| Relación | Cómo acceder |
| - | - |
| Sesiones de Verificación de empresas (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Usuarios vinculados (cargos directivos, UBO, directores) | Se muestran en la página de detalle de la empresa en la consola; proceden de la última sesión de Verificación de empresas (KYB) aprobada |
| Transacciones (como solicitante o contraparte) | Filtra las transacciones por el `vendor_data` de la empresa |
| Documentos | A través de las decisiones de las sesiones de Verificación de empresas (KYB) |
| Coincidencias AML | A través de las decisiones de las sesiones de Verificación de empresas (KYB) |

## Ejemplo de respuesta

```json theme={null}
{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}
```

## Próximos pasos

> [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)
>
> Recuperar todas las sesiones vinculadas a la empresa.

> [card] [Referencia de la API](https://docs.didit.me/es/management-api/businesses/get.md)
>
> Esquema de GET /v3/businesses/{vendor_data}/.


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