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

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

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

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

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

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

Esquema de respuesta

Consulta dónde aparecen las advertencias en el array de cada función de KYB.

Estados

Entiende cómo se corresponde la gravedad de las advertencias con el estado de la verificación.

Documentos

Revisa los grupos de documentos, el OCR y el funcionamiento de las comprobaciones cruzadas.

Personas clave

Flujo de verificación de cargos directivos, UBO y partes incluidas en la solicitud.

Informe AML

Estructura de cada coincidencia de los análisis AML de empresas y personas.

Modelos de datos de referencia

Estructuras canónicas de las advertencias y los arrays de funciones.

Primeros pasos

Funciones

Perfiles de empresa

Referencia

Consola

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

Descripción general

Advertencias del registro KYB

Advertencias de documentos KYB

Advertencias de personas clave de KYB

Advertencias de funciones compartidas

AML

Teléfono

Correo electrónico

Cuestionario

Análisis de dispositivo e IP

Ejemplos

Registro: empresa no activa

Documentos: sospecha de manipulación por superposición

Personas clave: persona rechazada anteriormente

Relacionado

Esquema de respuesta

Estados

Documentos

Personas clave

Informe AML

Modelos de datos de referencia

​Descripción general

​Advertencias del registro KYB

​Advertencias de documentos KYB

​Advertencias de personas clave de KYB

​Advertencias de funciones compartidas

​AML

​Teléfono

​Correo electrónico

​Cuestionario

​Análisis de dispositivo e IP

​Ejemplos

​Registro: empresa no activa

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

​Personas clave: persona rechazada anteriormente

​Relacionado

Esquema de respuesta

Estados

Documentos

Personas clave

Informe AML

Modelos de datos de referencia

Descripción general

Advertencias del registro KYB

Advertencias de documentos KYB

Advertencias de personas clave de KYB

Advertencias de funciones compartidas

AML

Teléfono

Correo electrónico

Cuestionario

Análisis de dispositivo e IP

Ejemplos

Registro: empresa no activa

Documentos: sospecha de manipulación por superposición

Personas clave: persona rechazada anteriormente

Relacionado