Historial KYB de empresas: sesiones e informes

Cada sesión de Verificación de empresas (KYB) que una empresa ha realizado queda vinculada de forma permanente a la entidad Business. Puedes obtener el historial completo, revisar los datos del registro y los resultados AML de cada sesión, iniciar una reverificación y generar informes en PDF para auditorías.

Listar todas las sesiones de Verificación de empresas (KYB) de una empresa

Filtra la lista de sesiones por vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"

La respuesta incluye todas las sesiones de Verificación de empresas (KYB), sea cual sea su estado.

Funciones de KYB

Una sesión de KYB ejecuta estas funciones, y cada una tiene su propio estado en la decisión de la sesión:

Función	Qué cubre
`KYB_REGISTRY`	Consulta en el registro de empresas: existencia, estado y verificación cruzada de identidad
`AML`	Análisis AML a nivel de empresa (sanciones, medios adversos, listas de vigilancia)
`KYB_DOCUMENTS`	Recopilación de documentos y contraste con los datos extraídos por OCR
`KYB_KEY_PEOPLE`	Directivos, UBO y beneficiarios finales: identificación y KYC opcional

El mapa features de la entidad empresarial solo contiene el estado de la última verificación de la empresa:

"features": {
  "KYB": "Approved"
}

Consulta Estados de las funciones de KYB para ver la referencia completa.

Revisar una sesión de Verificación de empresas (KYB)

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

La decisión de KYB incluye:

Datos del registro de empresas (razón social, registro, estado, fecha de constitución, direcciones)
Directivos y UBO extraídos del registro
Estructura de propiedad (cap table, porcentajes de titularidad real)
Resultados AML de la empresa (coincidencias, puntuaciones)
Análisis AML individual de cada UBO y directivo
Resultados de los documentos con los datos extraídos por OCR
Códigos de motivo de la decisión

Consulta Esquema de respuesta de KYB para ver el payload completo.

Activar una reverificación

El re-KYB anual, las revisiones activadas por disparadores o los flujos de remediación empiezan siempre con una nueva sesión:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'

La nueva sesión se vincula a la entidad Business existente y actualiza el mapa features al completarse.

Reenvío frente a nueva sesión de Verificación de empresas (KYB)

Escenario	Qué usar
La consulta en el registro necesita un nombre de empresa corregido	Reenvío: el analista edita los datos y vuelve a ejecutar la consulta en el registro
Se solicita a la empresa un documento adicional	Reenvío: la empresa sube el documento que falta
Re-KYB anual o basado en un disparador	Crear una nueva sesión

Exportar un informe de KYB

Genera un PDF completo de cualquier sesión de Verificación de empresas (KYB):

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf

El PDF incluye los datos del registro, la estructura de propiedad, las coincidencias AML, las imágenes de los documentos, el estado de KYC de los directivos y una portada con el motivo de la decisión.

Compartir una sesión de Verificación de empresas (KYB)

Para flujos de consorcio o con socios:

POST /v3/session/{session_id}/share/: genera un token compartible.
POST /v3/session/import-shared/: importa la sesión en el lado receptor.

Monitorización continua

Las empresas en modo de monitorización continua se someten a nuevos análisis AML periódicos. Cuando se detecta una nueva coincidencia en sanciones o medios adversos, se actualiza el análisis AML de la empresa; consúltalo en aml_screenings[] dentro de la decisión de la sesión. Configura la monitorización continua en la consola, en Workflows → [KYB workflow] → AML → Ongoing monitoring.

Próximos pasos

Visión general de KYB

Cómo funcionan de principio a fin las sesiones de Verificación de empresas (KYB).

Respuesta de KYB

Referencia completa del payload de la decisión.

Personas clave

Directivos, UBO y usuarios vinculados.

Ú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

Historial KYB de empresas: sesiones e informes

Listar todas las sesiones de Verificación de empresas (KYB) de una empresa

Funciones de KYB

Revisar una sesión de Verificación de empresas (KYB)

Activar una reverificación

Reenvío frente a nueva sesión de Verificación de empresas (KYB)

Exportar un informe de KYB

Compartir una sesión de Verificación de empresas (KYB)

Monitorización continua

Próximos pasos

Visión general de KYB

Respuesta de KYB

Personas clave

​Listar todas las sesiones de Verificación de empresas (KYB) de una empresa

​Funciones de KYB

​Revisar una sesión de Verificación de empresas (KYB)

​Activar una reverificación

​Reenvío frente a nueva sesión de Verificación de empresas (KYB)

​Exportar un informe de KYB

​Compartir una sesión de Verificación de empresas (KYB)

​Monitorización continua

​Próximos pasos

Visión general de KYB

Respuesta de KYB

Personas clave

Listar todas las sesiones de Verificación de empresas (KYB) de una empresa

Funciones de KYB

Revisar una sesión de Verificación de empresas (KYB)

Activar una reverificación

Reenvío frente a nueva sesión de Verificación de empresas (KYB)

Exportar un informe de KYB

Compartir una sesión de Verificación de empresas (KYB)

Monitorización continua

Próximos pasos