Modelo de datos de empresas: esquema KYB

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

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.

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`

{
  "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

{
  "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

Operaciones

Crear, actualizar, cambiar el estado, eliminar.

Historial KYB

Recuperar todas las sesiones vinculadas a la empresa.

Referencia de la API

Esquema de GET /v3/businesses//.

Última modificación el 1 de noviembre de 2026

Visión general

Precios

Flujos y verificación

Revisión y operaciones

Entidades (usuarios y empresas)

Ajustes y personalización

Seguridad y cumplimiento

Didit Academy

Recursos

Modelo de datos de empresas: esquema KYB

Campos de identidad

Estado

Campos agregados de sesiones

El mapa `features`

Marcas de tiempo de actividad

Metadatos

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

Ejemplo de respuesta

Próximos pasos

Operaciones

Historial KYB

Referencia de la API

​Campos de identidad

​Estado

​Campos agregados de sesiones

​El mapa features

​Marcas de tiempo de actividad

​Metadatos

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

​Ejemplo de respuesta

​Próximos pasos

Operaciones

Historial KYB

Referencia de la API

Campos de identidad

Estado

Campos agregados de sesiones

El mapa `features`

Marcas de tiempo de actividad

Metadatos

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

Ejemplo de respuesta

Próximos pasos