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

# Estados de KYB: referencia de sesión, funciones y AML

> Cadenas de estado exactas de Didit para sesiones KYB, funciones, consultas al registro y AML. Desde $2.00 por verificación, según país y nivel.

La Verificación de empresas (KYB) registra el estado en varios niveles: la **sesión**, cada una de las **funciones**, la **consulta al registro** y el **resultado AML**. Esta página es la referencia de todos los estados.

La API devuelve los valores de estado como etiquetas exactas que distinguen mayúsculas y minúsculas, como `"In Progress"` y `"Not Finished"`, las mismas cadenas que incluyen los webhooks.
Haz coincidir esas cadenas, no con nombres en mayúsculas.

## Estado de la sesión

El estado general de una sesión de Verificación de empresas (KYB). Es el campo que más a menudo usarás para decidir qué hacer.

| Estado | Significado |
| - | - |
| `"Not Started"` | La sesión se ha creado, pero la empresa no ha abierto el enlace alojado. |
| `"In Progress"` | El flujo alojado está activo: hay consultas al registro, cargas de documentos o análisis AML en curso. |
| `"Awaiting User"` | Se espera a que el usuario final realice una acción (normalmente, enviar las personas clave o responder a una solicitud para volver a enviar la sesión). Cambia automáticamente en cuanto el usuario completa la acción pendiente. |
| `"Approved"` | Todas las funciones obligatorias han sido aprobadas. La empresa está verificada. |
| `"Declined"` | Falló una comprobación crítica (empresa disuelta, entidad sancionada, incluida en la lista de bloqueo) o una regla del flujo de verificación (workflow) la rechazó. |
| `"In Review"` | Una o más funciones requieren la revisión manual de un analista. |
| `"Resubmitted"` | Una sesión rechazada o para la que se solicitó un nuevo envío se ha vuelto a enviar con datos actualizados. |
| `"Abandoned"` | La empresa nunca completó el flujo (tiempo de espera agotado). |
| `"Expired"` | La sesión expiró antes de que la empresa la completara. |

> [!NOTE]
>
> `"Awaiting User"` es un estado transitorio: no necesitas sacar las sesiones de él manualmente. En cuanto el usuario final completa la acción pendiente (por ejemplo, envía la lista de personas clave o vuelve a cargar un documento solicitado), Didit vuelve a evaluar la sesión y la pasa automáticamente a `"In Review"`, `"Approved"` o `"Declined"` según el resultado.

## Estado de las funciones

Cada función de KYB tiene su propio estado, que se agrega al estado de la sesión.

| Estado | Significado |
| - | - |
| `"Not Finished"` | La función aún no ha comenzado o está en curso. |
| `"Approved"` | La función ha sido aprobada. |
| `"Declined"` | La función ha fallado (crítico). |
| `"In Review"` | La función requiere la atención de un analista. |
| `"Resub Requested"` | La empresa debe volver a enviar información para esta función (por ejemplo, volver a cargar un documento). |
| `"Awaiting User"` | La función espera una acción del usuario final. Se aplica a la función de personas clave mientras el usuario debe enviar la información de las partes. Cambia automáticamente cuando se envía esta información. |

### Nombres de las funciones de KYB

Estos son los valores de `features` en una sesión de KYB y en los webhooks:

* `KYB_REGISTRY`: consulta al registro de empresas.
* `AML`: análisis AML a nivel de empresa.
* `KYB_DOCUMENTS`: recopilación de documentos y OCR.
* `KYB_KEY_PEOPLE`: personas clave: beneficiarios finales, accionistas, directores, representantes y otros cargos.

## Estado del registro (según el proveedor)

El estado oficial de la empresa tal como se obtiene de las fuentes de registro oficiales. Refleja la situación legal o regulatoria de la entidad según informa el registro de cada jurisdicción, por lo que los valores exactos varían según la fuente. Aparece en la decisión de KYB en `company.registry_status`.

| Estado | Significado |
| - | - |
| `ACTIVE` | La empresa está activa y en regla. |
| `DISSOLVED` | La empresa ha sido disuelta. |
| `DEREGISTERED` | La empresa ha sido dada de baja del registro. |
| `STRUCK_OFF` | La empresa ha sido eliminada del registro. |
| `CLOSED` | La empresa ha sido cerrada. |
| `INACTIVE` | La empresa está inactiva (sin actividad comercial). |
| `AUTHORISED` | Autorizada (normalmente, para entidades reguladas). |
| `APPOINTED_REPRESENTATIVE` | Representante designado de otra firma autorizada. |
| `UNAUTHORISED` | Antes autorizada, ahora no autorizada. |
| `NO_LONGER_AUTHORISED` | Autorización revocada. |
| `SEE_FULL_DETAILS` | El estado requiere una revisión manual. |

> [!NOTE]
>
> Como `registry_status` refleja los valores sin procesar del registro, usa `verification_status` (ver más abajo) cuando necesites un indicador coherente entre jurisdicciones para guiar la lógica de tu producto.

## Estado de verificación de la empresa

Un estado estandarizado, orientado a empresas, para cada resultado de empresa. Normaliza los distintos estados de los registros y de las empresas de diferentes países y fuentes en un único indicador coherente que puedes interpretar directamente en tu producto. Aparece en la decisión de KYB en `company.verification_status`.

| Estado | Significado |
| - | - |
| `verified` | La empresa parece activa y válida. |
| `failed` | La empresa parece inactiva o disuelta, o se han identificado problemas. |
| `unknown` | No hay información suficiente o el estado es ambiguo. |

## Estado de obtención de datos de la empresa

Indica el progreso de la obtención de datos de un registro de empresa concreto desde registros externos u oficiales. Úsalo para saber qué tan completa es la información obtenida de una empresa. Aparece en la decisión de KYB en `company.fetch_status`.

| Estado | Significado |
| - | - |
| `pending` | En esta fase solo se ha obtenido información parcial o básica de la empresa. |
| `resolved` | Se han obtenido correctamente los datos completos de la empresa desde fuentes oficiales. |

## Estado de la verificación AML

Se devuelve por cada screening (de empresa o de persona).

| Estado | Significado |
| - | - |
| `"Approved"` | No hay resultados por encima del umbral. |
| `"Declined"` | Resultado de alta gravedad (sanción confirmada o coincidencia con PEP). |
| `"In Review"` | Se encontró un resultado que requiere la revisión de un analista. |
| `"Not Finished"` | El screening no ha finalizado. |

## Cómo se explica una decisión

La decisión KYB no incluye una única cadena de código de motivo.
Cada array de funciones (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) incluye `warnings[]` con etiquetas `KYB_*` y AML, y `decision_trace` registra cómo se llegó a la decisión.
Consulta las etiquetas en [Advertencias KYB](https://docs.didit.me/es/business-verification/warnings.md) y regístralas junto al estado de la sesión.

Cuando un revisor establece manualmente el estado, anulando la agregación de la plataforma, la decisión incluye `status_override` con la hora `overridden_at` y el `automatic_status` que la plataforma habría establecido.
Consulta el [esquema de respuesta](https://docs.didit.me/es/business-verification/response-schema.md).

## Próximos pasos

> [card] [Esquema de respuesta](https://docs.didit.me/es/business-verification/response-schema.md)
>
> Dónde aparece cada estado en el payload.

> [card] [Evaluación de riesgo](https://docs.didit.me/es/business-verification/risk-assessment.md)
>
> Qué determina el resultado de un KYB.

> [card] [Webhooks](https://docs.didit.me/es/business-verification/webhooks.md)
>
> Eventos que se disparan con los cambios de estado.


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