> ## 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ó de coincidència AML: fórmula de confiança

> La puntuació de coincidència AML de Didit mesura la confiança d'identitat per nom, data de naixement i país, reduint els falsos positius.

La **Puntuació de coincidència** és una mètrica de confiança ponderada que determina **fins a quin punt una possible coincidència d'AML es correspon amb la persona sotmesa a cribratge**. Aquesta puntuació s'utilitza per classificar les coincidències individuals com a **Falsos positius** o **Possibles coincidències** que requereixen una revisió posterior.

![Configuració de la puntuació de coincidència AML de Didit que mostra llindars ponderats de nom, data de naixement i 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)

> ⚠️ **Important:** La Puntuació de coincidència determina la **classificació de les coincidències individuals**, NO l'estat final d'AML. L'estat final d'AML (Aprovada/En revisió/Rebutjada) el determina la [Puntuació de risc](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md) de les coincidències que no tenen l'estat de fals positiu.

## Visió general

En fer el cribratge d'una persona contra llistes de vigilància d'AML, cada possible coincidència rep una **puntuació de coincidència de 0 a 100**. Aquesta puntuació respon a la pregunta: **"És aquesta coincidència realment la mateixa persona que estem sotmetent a cribratge?"**

### Puntuació de coincidència vs. Puntuació de risc

| Aspecte | Puntuació de coincidència | Puntuació de risc |
| - | - | - |
| **Pregunta** | És la mateixa persona? | Quin risc té aquesta entitat? |
| **Finalitat** | Classificar les coincidències com a Fals positiu vs. Possible coincidència | Determinar l'estat final d'AML |
| **Factors** | Nom, data de naixement, país, número de document | País, categoria, antecedents penals |
| **Llindar** | Llindar de la puntuació de coincidència (per defecte: 93) | Llindar d'aprovació / Llindar de revisió |

***

## Com determina la puntuació de coincidència l'estat de revisió

Cada coincidència es classifica en funció de la seva puntuació de coincidència:

| Puntuació de coincidència | Estat de revisió | Significat |
| - | - | - |
| Puntuació per sota del llindar de puntuació de coincidència | **Fals positiu** | És probable que la coincidència NO sigui la mateixa persona |
| Puntuació igual o superior al llindar de puntuació de coincidència | **Sense revisar** | La coincidència requereix una revisió manual |

> **Llindar per defecte:** 93%

**Exemple:** Amb un llindar de 93:

* Coincidència amb puntuació 85 → **Fals positiu** (descartada automàticament)
* Coincidència amb puntuació 95 → **Sense revisar** (necessita revisió, la puntuació de risc determina la urgència)

### Explicació dels estats de revisió

Totes les coincidències d'AML comencen amb un dels dos estats inicials en funció de la seva puntuació de coincidència:

| Estat | Descripció | Quan s'estableix |
| - | - | - |
| **Fals positiu** | És probable que la coincidència NO sigui la mateixa persona sotmesa a cribratge. S'exclou de l'avaluació de risc. | Puntuació de coincidència \< llindar |
| **Sense revisar** | La coincidència és una possible coincidència que requereix revisió manual per confirmar-la o descartar-la. | Puntuació de coincidència ≥ llindar |

Després de la revisió manual, els responsables de compliment poden actualitzar l'estat a:

| Estat | Descripció |
| - | - |
| **Coincidència confirmada** | S'ha verificat que la coincidència és la mateixa persona. |
| **No concloent** | No es pot determinar si la coincidència és la mateixa persona. |

> [!NOTE]
>
> ### **Consell:** Pots canviar l'estat de revisió d'una coincidència a la Console consultant la visió general d'AML o fent clic en una coincidència específica per veure'n els detalls.

***

## Com es calcula la puntuació de coincidència

### Pas 1: Càlcul de la puntuació base

La puntuació base es calcula utilitzant tres components amb ponderacions configurables:

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

| Component | Ponderació per defecte | Descripció |
| - | - | - |
| **Nom** | 60% | Similitud difusa de cadenes entre el nom sotmès a cribratge i el nom de la coincidència |
| **Data de Naixement** | 25% | Puntuació exacta, parcial (només l'any) o de discrepància |
| **País/Nacionalitat** | 15% | Comparació entre la nacionalitat sotmesa a cribratge i els països de la coincidència |

> **Nota:** La suma de les ponderacions sempre ha de ser del 100%.

### Pas 2: Lògica de "clau d'or" del número de document

Després de calcular la puntuació base, el número de document s'avalua per separat utilitzant una lògica especial de substitució:

| Escenari | Efecte | Exemple |
| - | - | - |
| **Coincidència** | Estableix la puntuació en **100** | Els números de passaport coincideixen exactament |
| **Neutre** | Manté la puntuació base sense canvis | Tipus de document diferents, o falta en un dels dos costats |
| **Discrepància greu** | Aplica una penalització (-50 punts) | Mateix tipus de document però valors diferents |

Aquest enfocament reconeix que un número de document coincident és una prova definitiva d'identitat (la "clau d'or"), mentre que els tipus de document no coincidents no haurien de penalitzar la puntuació.

***

## Detalls de la puntuació dels components

### Similitud del nom (0-100)

La coincidència de noms utilitza l'**algorisme WRatio** de RapidFuzz, que és robust davant de:

* Faltes d'ortografia i errors tipogràfics
* Diferències en l'ordre de les paraules ("John Smith" vs. "Smith, John")
* Variacions en el segon nom ("Robert J. Smith" vs. "Robert James Smith")
* Diferències de longitud

### Puntuació de la data de naixement

| Escenari | Puntuació | Exemple |
| - | - | - |
| **Coincidència exacta** | 100% | "1985-03-15" coincideix amb "1985-03-15" |
| **Coincidència d'any (la coincidència només té l'any)** | 100% | "1985-03-15" coincideix amb "1985": coincidència total perquè la coincidència només ofereix precisió a nivell d'any |
| **Coincidència d'any (dia/mes diferents)** | 50% | "1985-03-15" coincideix amb "1985-06-20": mateix any però dates diferents |
| **Any diferent** | -100% (penalització) | "1985-03-15" no coincideix amb "1990-03-15" |
| **Sense dades** | 0% (neutral) | Falta la data de naixement en qualsevol dels dos costats |

> **Important:** Quan la coincidència només proporciona un any (p. ex., "1974"), coincidir en aquest any compta com una **coincidència total** perquè és tota la informació disponible per verificar.

### Puntuació de país/nacionalitat

| Escenari | Puntuació | Exemple |
| - | - | - |
| **Coincidència exacta** | 100% | "ES" coincideix amb "Spain" o "ESP" |
| **La coincidència no té dades** | 0% (neutral) | La coincidència no té informació de país |
| **No coincideix** | -50% (penalització) | "ES" no coincideix amb "France" |

El sistema converteix automàticament entre:

* Codis ISO alfa-2 (ES)
* Codis ISO alfa-3 (ESP)
* Noms complets de països (Spain)

També comprova el camp `citizenship` a més de `countries`.

***

## Normalització de la puntuació (reponderació)

Quan falten dades de la persona analitzada o de la coincidència, el sistema utilitza la **normalització de la puntuació** per evitar penalitzar per informació no disponible.

### Exemple: cribratge només per nom

Si fas el cribratge només amb un nom (sense data de naixement ni país):

| Pesos originals | Pesos normalitzats |
| - | - |
| Nom: 60% | Nom: **100%** |
| Data de naixement: 25% | Data de naixement: 0% (no comparable) |
| País: 15% | País: 0% (no comparable) |

**Resultat:** La puntuació del nom es converteix en la puntuació de coincidència sencera.

### Exemple: falta el país a la coincidència

Si la coincidència no té dades de país però té data de naixement:

| Pesos originals | Pesos normalitzats |
| - | - |
| Nom: 60% | Nom: **70.6%** |
| Data de naixement: 25% | Data de naixement: **29.4%** |
| País: 15% | País: 0% (no comparable) |

Això garanteix una puntuació justa independentment de la disponibilitat de les dades.

***

## Opcions de configuració

Pots personalitzar el càlcul de la puntuació de coincidència mitjançant l'API o la configuració del flux de treball:

### Llindar de la puntuació de coincidència

| Configuració | Per defecte | Descripció |
| - | - | - |
| Llindar de la puntuació de coincidència | 93 | Les coincidències per sota d'aquest valor es classifiquen com a **Fals positiu**. Les coincidències amb una puntuació igual o superior es classifiquen com a **Sense revisar** (possibles coincidències) i requereixen revisió. |

### Pesos (han de sumar 100)

| Configuració | Per defecte | Descripció |
| - | - | - |
| Pes del nom | 60 | Pes per a la similitud del nom (0-100) |
| Pes de la data de naixement | 25 | Pes per a la data de naixement (0-100) |
| Pes del país | 15 | Pes per al país/nacionalitat (0-100) |

***

## Exemple de sol·licitud a l'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
}
```

***

## Resposta: desglossament de la puntuació

Cada coincidència a la resposta inclou:

* `match_score` — La puntuació de coincidència calculada (0-100)
* `risk_score` — La puntuació de risc calculada (0-100); consulta [Puntuació de risc](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md)
* `review_status` — «Fals positiu» o «Sense revisar» segons el llindar de la puntuació de coincidència
* `score_breakdown` — Desglossament detallat del càlcul de la puntuació de coincidència

```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
  }
}
```

***

## Flux complet: de la puntuació de coincidència a l'estat 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                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

***

## Exemples de càlcul

### Exemple 1: Coincidència forta → Sense revisar

**Dades cribrades:**

* Nom: "Robert J. Smith"
* Data de naixement: "1985-03-15"
* País: "US"

**Dades de la coincidència:**

* Nom: "Robert James Smith"
* Data de naixement: "1985"
* País: "United States"

**Càlcul:**

1. Puntuació del nom: 90% (coincidència aproximada)
2. Puntuació de la data de naixement: 100% (la coincidència només té l'any, l'any coincideix)
3. Puntuació del país: 100% (coincidència exacta)

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

**Resultat:** Puntuació de coincidència (94) ≥ llindar (93) → **Sense revisar**
→ La puntuació de risc es calcularà i s'utilitzarà per a l'estat AML final

### Exemple 2: Coincidència feble → Fals positiu

**Dades cribrades:**

* Nom: "John Smith"
* Data de naixement: "1990-05-20"
* País: "US"

**Dades de la coincidència:**

* Nom: "Johnny Smithson"
* Data de naixement: "1975"
* País: "Canada"

**Càlcul:**

1. Puntuació del nom: 72% (coincidència aproximada feble)
2. Puntuació de la data de naixement: -100% (penalització per discordança d'any)
3. Puntuació del país: -50% (penalització per discordança de país)

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

**Resultat:** Puntuació de coincidència (11) \< llindar (93) → **Fals positiu**
→ Aquesta coincidència s'exclou de l'avaluació de risc

### Exemple 3: Anul·lació per clau d'or (Golden Key)

**Dades cribrades:**

* Nom: "John D. Smith"
* Número de document: "A12345678"

**Dades de la coincidència:**

* Nom: "Jonathan David Smith"
* Número de document: "A12345678"

**Càlcul:**

1. Puntuació base: \~70 (coincidència aproximada del nom)
2. Número de document: **MATCH** (coincidència exacta)

**Resultat:** Puntuació substituïda per **100** (coincidència per clau d'or) → **Sense revisar**

***

## Gestió de l'estat de revisió

Després de la classificació inicial, pots actualitzar manualment l'estat de revisió de cada coincidència:

### A la consola

1. Navega al resum d'AML de la sessió
2. Fes clic en una coincidència concreta per veure'n els detalls
3. Utilitza el desplegable d'estat per canviar l'estat de revisió:
   * **Coincidència confirmada** — Verifica que es tracta de la mateixa persona
   * **Fals positiu** — Indica que la coincidència no és correcta
   * **No concloent** — No s'ha pogut determinar

***

## Bones pràctiques

1. **Comença amb el llindar per defecte (93)** — Ofereix un bon equilibri entre detectar coincidències reals i filtrar falsos positius.

2. **Abaixa el llindar per a escenaris d'alt risc** — Si has de ser més prudent, abaixa el llindar de la puntuació de coincidència per detectar més coincidències potencials.

3. **Utilitza els números de document quan estiguin disponibles** — Proporcionen la confirmació d'identitat més sòlida i poden anul·lar puntuacions de coincidència baixes.

4. **Revisa els pesos normalitzats** — Consulta els camps de pes normalitzat al desglossament de la puntuació per entendre com han afectat la puntuació les dades que falten.

5. **Monitora les taxes de falsos positius** — Si s'estan marcant massa coincidències legítimes com a falsos positius, abaixa el llindar.


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