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

# Puntuación de coincidencia AML: fórmula de confianza

> Didit mide la confianza de identidad en AML comparando nombre, fecha de nacimiento y país. Ajusta pesos y umbrales para reducir falsos positivos.

La **Puntuación de coincidencia** es una métrica de confianza ponderada que determina **en qué medida una posible coincidencia AML corresponde a la persona analizada**. Esta puntuación se usa para clasificar cada coincidencia como **Falso positivo** o como **Posible coincidencia** que requiere una revisión adicional.

![Configuración de la puntuación de coincidencia AML de Didit con umbrales ponderados de nombre, fecha de nacimiento y país](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-match-score-config.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=76d3124f99349a81e16e711f3d2816e6)

> ⚠️ **Importante:** La Puntuación de coincidencia determina la **clasificación de cada coincidencia**, NO el estado AML final. El estado AML final (Aprobado/En revisión/Rechazado) lo determina la [puntuación de riesgo](https://docs.didit.me/es/core-technology/aml-screening/aml-risk-score.md) de las coincidencias que no son falsos positivos.

## Descripción general

Al evaluar a una persona frente a listas de vigilancia AML, cada posible coincidencia recibe una **puntuación de coincidencia de 0 a 100**. Esta puntuación responde a la pregunta: **"¿Esta coincidencia es realmente la misma persona que estamos analizando?"**

### Puntuación de coincidencia frente a puntuación de riesgo

| Aspecto | Puntuación de coincidencia | Puntuación de riesgo |
| - | - | - |
| **Pregunta** | ¿Es la misma persona? | ¿Qué nivel de riesgo tiene esta entidad? |
| **Finalidad** | Clasificar las coincidencias como Falso positivo o Posible coincidencia | Determinar el estado AML final |
| **Factores** | Nombre, fecha de nacimiento, país, número de documento | País, categoría, antecedentes penales |
| **Umbral** | Umbral de puntuación de coincidencia (predeterminado: 93) | Umbral de aprobación / Umbral de revisión |

***

## Cómo la puntuación de coincidencia determina el estado de revisión

Cada coincidencia se clasifica según su puntuación de coincidencia:

| Puntuación de coincidencia | Estado de revisión | Significado |
| - | - | - |
| Puntuación inferior al umbral de puntuación de coincidencia | **Falso positivo** | Probablemente la coincidencia NO es la misma persona |
| Puntuación igual o superior al umbral de puntuación de coincidencia | **Sin revisar** | La coincidencia requiere revisión manual |

> **Umbral predeterminado:** 93%

**Ejemplo:** Con un umbral de 93:

* Coincidencia con puntuación 85 → **Falso positivo** (descartada automáticamente)
* Coincidencia con puntuación 95 → **Sin revisar** (requiere revisión; la puntuación de riesgo determina la urgencia)

### Explicación de los estados de revisión

Todas las coincidencias AML comienzan con uno de dos estados iniciales según su puntuación de coincidencia:

| Estado | Descripción | Cuándo se asigna |
| - | - | - |
| **Falso positivo** | Probablemente la coincidencia NO es la misma persona que la persona analizada. Se excluye de la evaluación de riesgo. | Puntuación de coincidencia \< umbral |
| **Sin revisar** | La coincidencia es una posible coincidencia que requiere revisión manual para confirmarla o descartarla. | Puntuación de coincidencia ≥ umbral |

Tras la revisión manual, los responsables de cumplimiento pueden cambiar el estado a:

| Estado | Descripción |
| - | - |
| **Coincidencia confirmada** | Se ha verificado que la coincidencia es la misma persona. |
| **No concluyente** | No es posible determinar si la coincidencia es la misma persona. |

> [!NOTE]
>
> ### **Consejo:** Puedes cambiar el estado de revisión de una coincidencia en la Console desde la vista general de AML o haciendo clic en una coincidencia concreta para ver sus detalles.

***

## Cómo se calcula la puntuación de coincidencia

### Paso 1: Cálculo de la puntuación base

La puntuación base se calcula con tres componentes de pesos configurables:

```
Base Score = (Name Score × Name Weight) + (DOB Score × DOB Weight) + (Country Score × Country Weight)
```

| Componente | Peso predeterminado | Descripción |
| - | - | - |
| **Nombre** | 60% | Similitud aproximada de cadenas entre el nombre analizado y el nombre de la coincidencia |
| **Fecha de Nacimiento** | 25% | Puntuación por coincidencia exacta, parcial (solo el año) o discrepancia |
| **País/Nacionalidad** | 15% | Comparación entre la nacionalidad analizada y los países de la coincidencia |

> **Nota:** Los pesos deben sumar siempre 100%.

### Paso 2: Lógica de "llave maestra" (Golden Key) del número de documento

Después de calcular la puntuación base, el número de documento se evalúa por separado con una lógica especial de reemplazo:

| Escenario | Efecto | Ejemplo |
| - | - | - |
| **Coincidencia** | Reemplaza la puntuación por **100** | Los números de pasaporte coinciden exactamente |
| **Neutra** | Mantiene la puntuación base sin cambios | Tipos de documento distintos o falta el dato en una de las partes |
| **Discrepancia grave** | Aplica una penalización (-50 puntos) | Mismo tipo de documento pero valores distintos |

Este enfoque reconoce que un número de documento coincidente es una prueba definitiva de identidad (la "llave maestra"), mientras que los tipos de documento distintos no deben penalizar la puntuación.

***

## Detalles de la puntuación por componente

### Similitud del nombre (0-100)

La comparación de nombres usa el **algoritmo WRatio** de RapidFuzz, que tolera:

* Erratas y errores ortográficos
* Diferencias en el orden de las palabras ("John Smith" frente a "Smith, John")
* Variaciones del segundo nombre ("Robert J. Smith" frente a "Robert James Smith")
* Diferencias de longitud

### Puntuación de la fecha de nacimiento

| Escenario | Puntuación | Ejemplo |
| - | - | - |
| **Coincidencia exacta** | 100% | "1985-03-15" coincide con "1985-03-15" |
| **Coincidencia de año (la coincidencia solo tiene el año)** | 100% | "1985-03-15" coincide con "1985": coincidencia completa, porque la coincidencia solo ofrece precisión a nivel de año |
| **Coincidencia de año (día/mes distintos)** | 50% | "1985-03-15" coincide con "1985-06-20": mismo año, pero las fechas difieren |
| **Discrepancia de año** | -100% (penalización) | "1985-03-15" no coincide con "1990-03-15" |
| **Sin datos** | 0% (neutral) | Una de las dos partes no tiene fecha de nacimiento |

> **Importante:** cuando la coincidencia solo ofrece un año (p. ej., "1974"), que ese año coincida cuenta como una **coincidencia completa**, porque es toda la información disponible para verificar.

### Puntuación de país/nacionalidad

| Escenario | Puntuación | Ejemplo |
| - | - | - |
| **Coincidencia exacta** | 100% | "ES" coincide con "Spain" o "ESP" |
| **Sin datos en la coincidencia** | 0% (neutral) | La coincidencia no tiene información de país |
| **Discrepancia** | -50% (penalización) | "ES" no coincide con "France" |

El sistema convierte automáticamente entre:

* Códigos ISO alfa-2 (ES)
* Códigos ISO alfa-3 (ESP)
* Nombres completos de país (Spain)

Además de `countries`, también comprueba el campo `citizenship`.

***

## Normalización de la puntuación (reponderación)

Cuando faltan datos de la persona analizada o de la coincidencia, el sistema aplica la **normalización de la puntuación** para no penalizar por información que no está disponible.

### Ejemplo: análisis solo con el nombre

Si haces el análisis solo con un nombre (sin fecha de nacimiento ni país):

| Pesos originales | Pesos normalizados |
| - | - |
| Nombre: 60% | Nombre: **100%** |
| Fecha de nacimiento: 25% | Fecha de nacimiento: 0% (no comparable) |
| País: 15% | País: 0% (no comparable) |

**Resultado:** la puntuación del nombre constituye la totalidad de la puntuación de coincidencia.

### Ejemplo: falta el país en la coincidencia

Si la coincidencia no tiene datos de país, pero sí fecha de nacimiento:

| Pesos originales | Pesos normalizados |
| - | - |
| Nombre: 60% | Nombre: **70.6%** |
| Fecha de nacimiento: 25% | Fecha de nacimiento: **29.4%** |
| País: 15% | País: 0% (no comparable) |

Esto garantiza una puntuación justa independientemente de los datos disponibles.

***

## Opciones de configuración

Puedes personalizar el cálculo de la puntuación de coincidencia mediante la API o la configuración del flujo de verificación (workflow):

### Umbral de puntuación de coincidencia

| Configuración | Valor predeterminado | Descripción |
| - | - | - |
| Umbral de puntuación de coincidencia | 93 | Las coincidencias por debajo de este valor se clasifican como **Falso positivo**. Las que lo igualan o superan se clasifican como **Sin revisar** (posibles coincidencias) y necesitan revisión. |

### Pesos (deben sumar 100)

| Configuración | Valor predeterminado | Descripción |
| - | - | - |
| Peso del nombre | 60 | Peso de la similitud del nombre (0-100) |
| Peso de la fecha de nacimiento | 25 | Peso de la fecha de nacimiento (0-100) |
| Peso del país | 15 | Peso del país/nacionalidad (0-100) |

***

## Ejemplo de solicitud a la API

```json theme={null}
{
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "nationality": "USA",
  "document_number": "SAMPLE-DOC-12345",
  "aml_name_weight": 60,
  "aml_dob_weight": 25,
  "aml_country_weight": 15,
  "aml_match_score_threshold": 93
}
```

***

## Respuesta: desglose de la puntuación

Cada coincidencia de la respuesta incluye:

* `match_score`: la puntuación de coincidencia calculada (0-100)
* `risk_score`: la puntuación de riesgo calculada (0-100); consulta [Puntuación de riesgo](https://docs.didit.me/es/core-technology/aml-screening/aml-risk-score.md)
* `review_status`: "False Positive" o "Unreviewed", según el umbral de puntuación de coincidencia
* `score_breakdown`: desglose detallado del cálculo de la puntuación de coincidencia

```json theme={null}
{
  "caption": "David Sanchez",
  "match_score": 95,
  "risk_score": 65.5,
  "review_status": "Unreviewed",
  "score_breakdown": {
    "name_score": 95,
    "name_weight": 60,
    "name_weight_normalized": 70.59,
    "name_contribution": 67.06,
    "dob_score": 100,
    "dob_weight": 25,
    "dob_weight_normalized": 29.41,
    "dob_contribution": 29.41,
    "country_score": 0,
    "country_weight": 15,
    "country_weight_normalized": 0,
    "country_contribution": 0,
    "document_number_match_type": "NEUTRAL",
    "document_number_effect": "No document number provided for screening",
    "total_score": 95
  }
}
```

***

## Flujo completo: de la puntuación de coincidencia al estado AML final

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           AML SCREENING FLOW                                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. RETRIEVE MATCHES FROM WATCHLISTS                                        │
│     └── All matches with score ≥ 75% are included                           │
│                                                                             │
│  2. CALCULATE MATCH SCORE FOR EACH MATCH                                    │
│     Match Score = (Name × W1) + (DOB × W2) + (Country × W3)                │
│     + Golden Key document number logic                                      │
│                                                                             │
│  3. CLASSIFY MATCHES BY MATCH SCORE (Match Score Threshold = 93)           │
│     ├── Match Score < 93 → FALSE POSITIVE (excluded from risk assessment)  │
│     └── Match Score ≥ 93 → UNREVIEWED (included in risk assessment)        │
│                                                                             │
│  4. CALCULATE RISK SCORE FOR NON-FALSE-POSITIVE MATCHES                     │
│     Risk Score = (Country × 30%) + (Category × 50%) + (Criminal × 20%)     │
│                                                                             │
│  5. DETERMINE FINAL AML STATUS (based on highest risk score)               │
│     ├── Highest Risk Score < approve_threshold → APPROVED                   │
│     ├── Highest Risk Score ≤ review_threshold → IN REVIEW                   │
│     └── Highest Risk Score > review_threshold → DECLINED                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

***

## Ejemplos de cálculo

### Ejemplo 1: Coincidencia fuerte → Sin revisar

**Datos analizados:**

* Nombre: "Robert J. Smith"
* Fecha de nacimiento: "1985-03-15"
* País: "US"

**Datos de la coincidencia:**

* Nombre: "Robert James Smith"
* Fecha de nacimiento: "1985"
* País: "United States"

**Cálculo:**

1. Puntuación de nombre: 90% (coincidencia aproximada)
2. Puntuación de fecha de nacimiento: 100% (la coincidencia solo tiene el año, y el año coincide)
3. Puntuación de país: 100% (coincidencia exacta)

```
Match Score = (90 × 0.60) + (100 × 0.25) + (100 × 0.15)
            = 54 + 25 + 15
            = 94
```

**Resultado:** puntuación de coincidencia (94) ≥ umbral (93) → **Sin revisar**
→ Se calculará la puntuación de riesgo y se usará para el estado AML final

### Ejemplo 2: Coincidencia débil → Falso positivo

**Datos analizados:**

* Nombre: "John Smith"
* Fecha de nacimiento: "1990-05-20"
* País: "US"

**Datos de la coincidencia:**

* Nombre: "Johnny Smithson"
* Fecha de nacimiento: "1975"
* País: "Canada"

**Cálculo:**

1. Puntuación de nombre: 72% (coincidencia aproximada débil)
2. Puntuación de fecha de nacimiento: -100% (penalización por discrepancia de año)
3. Puntuación de país: -50% (penalización por discrepancia de país)

```
Match Score = (72 × 0.60) + (-100 × 0.25) + (-50 × 0.15)
            = 43.2 - 25 - 7.5
            = 10.7 → 11
```

**Resultado:** puntuación de coincidencia (11) \< umbral (93) → **Falso positivo**
→ Esta coincidencia se excluye de la evaluación de riesgo

### Ejemplo 3: Anulación por Golden Key

**Datos analizados:**

* Nombre: "John D. Smith"
* Número de documento: "A12345678"

**Datos de la coincidencia:**

* Nombre: "Jonathan David Smith"
* Número de documento: "A12345678"

**Cálculo:**

1. Puntuación base: \~70 (coincidencia aproximada del nombre)
2. Número de documento: **COINCIDE** (coincidencia exacta)

**Resultado:** la puntuación se reemplaza por **100** (coincidencia Golden Key) → **Sin revisar**

***

## Gestionar el estado de revisión

Tras la clasificación inicial, puedes actualizar manualmente el estado de revisión de cada coincidencia:

### En la consola

1. Ve al resumen AML de la sesión
2. Haz clic en una coincidencia concreta para ver los detalles
3. Usa el desplegable de estado para cambiar el estado de revisión:
   * **Coincidencia confirmada**: verifica que se trata de la misma persona
   * **Falso positivo**: marca que la coincidencia no corresponde
   * **No concluyente**: no es posible determinarlo

***

## Buenas prácticas

1. **Empieza con el umbral predeterminado (93)**: ofrece un buen equilibrio entre detectar coincidencias reales y filtrar falsos positivos.

2. **Baja el umbral en escenarios de alto riesgo**: si necesitas ser más cauteloso, baja el umbral de puntuación de coincidencia para detectar más coincidencias potenciales.

3. **Usa números de documento cuando estén disponibles**: ofrecen la confirmación de identidad más sólida y pueden anular puntuaciones de coincidencia bajas.

4. **Revisa los pesos normalizados**: consulta los campos de peso normalizado en el desglose de la puntuación para entender cómo afectaron los datos faltantes a la puntuación.

5. **Supervisa las tasas de falsos positivos**: si se están marcando demasiadas coincidencias legítimas como falsos positivos, baja el umbral.


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