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

# Advertencias de verificación KYB y códigos de error

> Advertencias KYB de Didit por función: registro, documentos, personas clave, AML, teléfono, email, cuestionario y análisis de dispositivo e IP.

Verificación de empresas muestra las advertencias en el elemento de función que las generó. Cada advertencia tiene la estructura estándar que se usa en toda la plataforma: `feature`, `risk`, `log_type`, `short_description`, `long_description`, `additional_data` (opcional) y `node_id`. Así puedes dirigir el trabajo de revisión al equipo operativo adecuado.

## Descripción general

Las sesiones de KYB emiten advertencias bajo tres etiquetas de función principales, que corresponden a arrays específicos de cada función en la respuesta de decisión V3:

| Etiqueta de función | Clave en la respuesta de decisión | Qué cubre |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | Consultas a registros oficiales de empresas. Estado activo, restricciones de país, propiedad derivable y registros de directivos o UBO ausentes. |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Documentos de constitución, propiedad, dirección y accionistas que sube el usuario. Coherencia entre documentos, OCR, metadatos, manipulación, antigüedad y reglas de subtipo. |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Señales a nivel de persona sobre directores, directivos, UBO o partes enviadas por el usuario, incluidos los hallazgos de PEP o sanciones que se propagan desde AML y la reutilización de rechazos previos. |

El mismo flujo de trabajo de KYB también puede incluir las funciones compartidas que aparecen a continuación. Cada una emite advertencias en su propio array:

| Etiqueta de función | Clave en la respuesta de decisión |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses` (las advertencias están en el registro de la sesión) |
| `LOCATION` | `ip_analyses[].warnings[]` |

## Advertencias del registro KYB

Las advertencias del registro usan `feature: "KYB_REGISTRY"` y aparecen en `registry_checks[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | El país de la empresa no está entre los países permitidos configurados para el flujo. |
| `KYB_OFFICERS_DATA_NOT_FOUND` | El registro no tiene datos de los directivos. |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | El registro no tiene datos de propiedad. |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | No se pudo determinar la titularidad real última a partir de los datos del registro. |
| `KYB_COMPANY_NOT_ACTIVE` | Según el registro, la empresa no está activa. |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | La empresa se introdujo manualmente y no se pudo verificar con un registro mercantil. |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | El número de registro de la empresa obtenido del registro no coincide con el `expected_details.registration_number` que enviaste al crear la sesión. |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | El número de registro obtenido del registro coincide solo parcialmente con el esperado, por ejemplo por un sufijo de sucursal o de filial. |
| `KYB_COMPANY_VAT_INVALID` | El registro fiscal oficial no tiene ninguna inscripción activa para el número de IVA o la identificación fiscal de la empresa, o el número de IVA no cumple las reglas de formato y de dígito de control de su país. Se aplica la `kyb_vat_invalid_action` configurada (valor predeterminado: En revisión). |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | No se pudo validar el número de IVA o la identificación fiscal porque el registro oficial no estaba disponible temporalmente. Se aplica la `kyb_vat_unverified_action` configurada (valor predeterminado: sin efecto). |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | El nombre inscrito en el registro oficial para este número es distinto del nombre de empresa enviado. Es informativa: incluye `registry_name`, `registry_source` y `submitted_name` en `additional_data`, además de `vies_name` cuando el registro es VIES. |

Las advertencias de IVA se aplican siempre que se pueda validar el número de IVA o la identificación fiscal de la empresa. Consulta [Validación de IVA e identificación fiscal](https://docs.didit.me/es/business-verification/company-data.md#validación-del-iva-y-de-la-identificación-fiscal) para ver los países y las fuentes.

## Advertencias de documentos KYB

Las advertencias de documentos usan `feature: "KYB_DOCUMENTS"` y aparecen en `document_verifications[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | No se encontró en el documento un campo obligatorio de la empresa, como el nombre de la empresa o el número de registro. |
| `KYB_DOCUMENT_NAME_MISMATCH` | El nombre de la empresa en el documento no coincide con el registro de empresas. |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | El número de registro en el documento no coincide con el registro de empresas. |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | La fecha de constitución en el documento no coincide con el registro de empresas. |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | El domicilio social en el documento no coincide con el registro de empresas. |
| `KYB_CROSS_DOCUMENT_MISMATCH` | Los datos de la empresa difieren entre los documentos corporativos subidos. |
| `KYB_DOCUMENT_METADATA_MISMATCH` | La firma, los metadatos o la estructura del archivo del documento indican un posible problema. |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | Los directores o accionistas del documento no coinciden con el registro de empresas. |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | El documento parece haber sido procesado con software de edición gráfica. |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | El sistema detectó indicios de una posible manipulación del documento corporativo. |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | No se pudo verificar un campo del documento porque los datos correspondientes del registro de empresas no están disponibles. |
| `KYB_DOCUMENT_EXPIRED` | El documento corporativo supera la antigüedad máxima configurada. |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | El subtipo del documento subido está desactivado para el flujo. |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | Se superó el número máximo de intentos de subida de documentos corporativos. |

En caso de manipulación de PDF mediante texto superpuesto, `KYB_DOCUMENT_SUSPECTED_MANIPULATION` puede incluir `additional_data.manipulated_regions`. Son rectángulos en coordenadas de página que identifican las zonas presuntamente editadas y coinciden con los rectángulos devueltos en `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`.

## Advertencias de personas clave de KYB

Las advertencias de personas clave usan `feature: "KYB_KEY_PEOPLE"` y aparecen en `key_people_checks[].warnings[]`. Señalan problemas a nivel de persona en directores, cargos directivos, UBO y partes enviadas por el usuario.

| Etiqueta | Descripción |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Una persona asociada a la empresa fue rechazada anteriormente en otra verificación de empresa de la misma aplicación. |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Los directores o accionistas declarados en la pantalla de personas clave no coinciden con las personas que figuran en los documentos corporativos subidos: una persona que figura en los documentos nunca se declaró, un nombre coincide casi por completo, un accionista que figura en los documentos se declaró sin ningún rol de propiedad o un porcentaje de propiedad declarado contradice los documentos. Se aplica la acción configurada en `kyb_key_people_document_mismatch_action` (valor predeterminado: En revisión). |

> [!NOTE]
>
> **Las coincidencias de PEP o sanciones en personas clave** se notifican como coincidencias AML estándar en el elemento correspondiente de `aml_screenings[]`, no como una advertencia de personas clave de KYB. La comprobación de personas clave propaga el estado `Declined` o `In Review` resultante a cada parte afectada, de modo que el veredicto general de personas clave refleje el resultado del análisis AML.

## Advertencias de funciones compartidas

Las siguientes funciones pueden ejecutarse dentro de un flujo de KYB. Usan el mismo catálogo de advertencias que la Verificación de usuarios. Encontrarás la referencia completa en la página de advertencias de cada función.

### AML

`feature: "AML"` en `aml_screenings[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `POSSIBLE_MATCH_FOUND` | El análisis AML encontró una posible coincidencia que requiere revisión. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Didit no pudo realizar el análisis AML porque faltaban datos necesarios para el análisis o no estaban disponibles. |

### Teléfono

`feature: "PHONE"` en `phone_verifications[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | El número de teléfono es desechable. |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | Se superó el número máximo de intentos del código de verificación. |
| `VOIP_NUMBER_DETECTED` | El número de teléfono es un número VoIP. |
| `DUPLICATED_PHONE_NUMBER` | El número de teléfono se usó en otro proceso de verificación. |
| `HIGH_RISK_PHONE_NUMBER` | El número de teléfono es de alto riesgo. |
| `PHONE_NUMBER_IN_BLOCKLIST` | El número de teléfono coincide con una entrada de tu lista de bloqueo. |

### Correo electrónico

`feature: "EMAIL"` en `email_verifications[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `BREACHED_EMAIL_DETECTED` | La dirección de correo electrónico aparece en filtraciones de datos conocidas. |
| `DISPOSABLE_EMAIL_DETECTED` | La dirección de correo electrónico es desechable. |
| `UNDELIVERABLE_EMAIL_DETECTED` | No se pueden entregar mensajes a la dirección de correo electrónico. |
| `DUPLICATED_EMAIL` | La dirección de correo electrónico se usó en otro proceso de verificación. |
| `EMAIL_IN_BLOCKLIST` | La dirección de correo electrónico coincide con una entrada de tu lista de bloqueo. |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Se superó el número máximo de intentos del código de verificación de correo electrónico. |

### Cuestionario

`feature: "QUESTIONNAIRE"`.

| Etiqueta | Descripción |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | Una regla de estado del flujo evaluó una respuesta del cuestionario y cambió el estado de la función. |

### Análisis de dispositivo e IP

`feature: "LOCATION"` en `ip_analyses[].warnings[]`.

| Etiqueta | Descripción |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | El país del documento no coincide con el país de la IP. |
| `PRIVATE_NETWORK_DETECTED` | Se detectó una señal de red privada, VPN, proxy o Tor. |
| `EXPECTED_IP_ADDRESS_MISMATCH` | La dirección IP no coincide con la dirección IP esperada indicada para la sesión. |
| `IP_ADDRESS_IN_BLOCKLIST` | La dirección IP coincide con una entrada de tu lista de bloqueo. |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | La huella digital del dispositivo coincide con una entrada de tu lista de bloqueo. |
| `DUPLICATED_IP_ADDRESS` | La misma dirección IP se usó en otra verificación con un `vendor_data` distinto. |
| `DUPLICATED_DEVICE_FINGERPRINT` | La misma huella digital del dispositivo se usó en otra verificación con un `vendor_data` distinto. |

## Ejemplos

### Registro: empresa no activa

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### Documentos: sospecha de manipulación por superposición

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### Personas clave: persona rechazada anteriormente

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## Relacionado

> [card] [Esquema de respuesta](https://docs.didit.me/es/business-verification/response-schema.md)
>
> Consulta dónde aparecen las advertencias en el array de cada función de KYB.

> [card] [Estados](https://docs.didit.me/es/business-verification/statuses.md)
>
> Entiende cómo se corresponde la gravedad de las advertencias con el estado de la verificación.

> [card] [Documentos](https://docs.didit.me/es/business-verification/documents.md)
>
> Revisa los grupos de documentos, el OCR y el funcionamiento de las comprobaciones cruzadas.

> [card] [Personas clave](https://docs.didit.me/es/business-verification/key-people.md)
>
> Flujo de verificación de cargos directivos, UBO y partes incluidas en la solicitud.

> [card] [Informe AML](https://docs.didit.me/es/core-technology/aml-screening/report-aml-screening.md)
>
> Estructura de cada coincidencia de los análisis AML de empresas y personas.

> [card] [Modelos de datos de referencia](https://docs.didit.me/es/reference/data-models.md)
>
> Estructuras canónicas de las advertencias y los arrays de funciones.


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