Saltar al contenido principal

World-Check

1. Introducción y Propósito del Proceso​

World-Check es una base de datos global que contiene información estructurada sobre personas y organizaciones de alto riesgo, perfiles políticos (PEPs) y listas de sanciones internacionales. Se utiliza para ayudar a las empresas a cumplir con sus obligaciones internacionales de debida diligencia (Due Diligence), mitigando riesgos financieros, legales y reputacionales. Este servicio es obligatorio para entidades bajo regulaciones de prevención de lavado de dinero (AML) y cumplimiento normativo.

2. Comportamiento del Parámetro Detail (Summary vs Extended)​

Explica detalladamente cómo responde este endpoint según los flags de consulta para evitar payloads masivos innecesarios:

  • Vista Summary (Por defecto): Entrega el estado general del análisis (result) y los datos demográficos básicos verificados del candidato. El nodo completo worldCheckData se omite.
  • Vista Extended (?detail=true): Inyecta el objeto estructurado worldCheckData, el cual contiene el desglose crudo del proveedor, incluyendo el historial de auditoría, las fuentes normativas y el arreglo de coincidencias evaluadas (consideredResults).

3. Nota Técnica de Arquitectura: Interpretación de Coincidencias​

Lógica de Dictamen y Falsos Positivos

Nota de Integración: Un candidato puede arrojar coincidencias fonéticas o de nombre muy altas dentro del arreglo consideredResults (ej. matchScore: 94.66). Sin embargo, el campo global result puede finalizar como Aprobado. Esto ocurre cuando el motor de reglas automáticas o el equipo analítico validan que los campos secundarios (como fecha de nacimiento, género o país de origen) no corresponden al candidato evaluado, marcando el registro con una resolución de falso positivo (resolutionStatusType: FALSE). El integrador debe guiarse siempre por el campo raíz result.

4. Estructura de Respuesta Comentada​

{
  "isSuccess": true,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "processId": "f4syIeLawYNNWc2b1ecP",
    "processName": "World Check",
    "detail": {
      "result": "No aprobado", 
      "name": "JUAN PEREZ LOPEZ",
      "creationDate": "2026-07-01T18:50:22.023Z",
      
      // [Habilitado únicamente si se consulta con el parámetro ?detail=true]
      "worldCheckData": {
        "entityType": "INDIVIDUAL", // Tipo de entidad consultada (INDIVIDUAL o ORGANIZATION)
        "caseScreeningState": {
          "WATCHLIST": "INITIAL"
        },
        "creator": {
          "fullName": "Analista Blacktrust",
          "email": "analista@blacktrust.net"
        },
        "consideredResults": [ // Lista de posibles coincidencias encontradas en listas internacionales
          {
            "resultId": "5jb68p7y2dhq1ktcxspbcp450",
            "matchStrength": "STRONG", // Fuerza de la coincidencia (STRONG, MEDIUM, WEAK)
            "matchScore": 94.66, // Porcentaje de coincidencia exacta del nombre
            "matchedTerms": [
              {
                "term": "JUAN PEREZ",
                "submittedTerm": "JUAN PEREZ LOPEZ",
                "matchScore": 94.66
              }
            ],
            "secondaryFieldResults": [ // Comparativa de campos secundarios para descarte de homónimos
              {
                "typeId": "SFCT_1", // Género
                "fieldResult": "MATCHED"
              },
              {
                "typeId": "SFCT_2", // Fecha de Nacimiento
                "fieldResult": "NOT_MATCHED" // Campo clave para el descarte de la alerta
              }
            ],
            "sourceCategories": ["Special Interest Categories", "Other Bodies"], // Categorías de la lista de riesgo
            "resolution": {
              "reasonId": "DEFAULT_REASON_AUTO_RESOLVED",
              "resolutionRemark": "Date of Birth mismatch", // Justificación del cierre de la alerta
              "resolutionStatusType": "FALSE" // FALSE indica que se determinó como un falso positivo
            }
          }
        ]
      }
    },
    "status": "Finalizado",
    "result": "Aprobado" // Resultado definitivo tras evaluar y descartar homónimos
  }
}