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

# Punteggio di corrispondenza AML: formula di affidabilità

> Didit calcola il punteggio di corrispondenza AML con nome, data di nascita e paese. Ottimizza pesi e soglie per ridurre i falsi positivi.

Il **Punteggio di corrispondenza** è una metrica di affidabilità ponderata che determina **quanto una potenziale corrispondenza AML coincida con l'individuo sottoposto a screening**. Questo punteggio viene utilizzato per classificare le singole corrispondenze come **Falso positivo** o come possibili corrispondenze che richiedono un'ulteriore revisione.

![Configurazione del punteggio di corrispondenza AML di Didit che mostra le soglie ponderate per nome, data di nascita e paese](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:** il Punteggio di corrispondenza determina la **classificazione della singola corrispondenza**, NON lo stato AML finale. Lo stato AML finale (Approvata/In revisione/Rifiutata) è determinato dal [Punteggio di rischio](https://docs.didit.me/it/core-technology/aml-screening/aml-risk-score.md) delle corrispondenze che non sono falsi positivi.

## Panoramica

Quando si esegue lo screening di una persona rispetto alle watchlist AML, ogni potenziale corrispondenza riceve un **punteggio di corrispondenza da 0 a 100**. Questo punteggio risponde alla domanda: **«Questa corrispondenza è effettivamente la stessa persona sottoposta a screening?»**

### Punteggio di corrispondenza e Punteggio di rischio

| Aspetto | Punteggio di corrispondenza | Punteggio di rischio |
| - | - | - |
| **Domanda** | Si tratta della stessa persona? | Quanto è rischiosa questa entità? |
| **Finalità** | Classificare le corrispondenze come Falso positivo o possibile corrispondenza | Determinare lo stato AML finale |
| **Fattori** | Nome, data di nascita, paese, numero del documento | Paese, categoria, precedenti penali |
| **Soglia** | Soglia del punteggio di corrispondenza (predefinita: 93) | Soglia di approvazione / Soglia di revisione |

***

## In che modo il punteggio di corrispondenza determina lo stato di revisione

Ogni corrispondenza viene classificata in base al relativo punteggio di corrispondenza:

| Punteggio di corrispondenza | Stato di revisione | Significato |
| - | - | - |
| Punteggio inferiore alla soglia del punteggio di corrispondenza | **Falso positivo** | La corrispondenza con ogni probabilità NON è la stessa persona |
| Punteggio pari o superiore alla soglia del punteggio di corrispondenza | **Non esaminata** | La corrispondenza richiede una revisione manuale |

> **Soglia predefinita:** 93%

**Esempio:** con una soglia pari a 93:

* Corrispondenza con punteggio 85 → **Falso positivo** (scartata automaticamente)
* Corrispondenza con punteggio 95 → **Non esaminata** (richiede revisione, il punteggio di rischio ne determina l'urgenza)

### Descrizione degli stati di revisione

Tutte le corrispondenze AML iniziano con uno dei due stati iniziali in base al loro punteggio di corrispondenza:

| Stato | Descrizione | Quando viene impostato |
| - | - | - |
| **Falso positivo** | Con ogni probabilità la corrispondenza NON è la stessa persona sottoposta a screening. Viene esclusa dalla valutazione del rischio. | Punteggio di corrispondenza \< soglia |
| **Non esaminata** | La corrispondenza è una possibile corrispondenza che richiede una revisione manuale per essere confermata o scartata. | Punteggio di corrispondenza ≥ soglia |

Dopo la revisione manuale, i responsabili della compliance possono aggiornare lo stato in:

| Stato | Descrizione |
| - | - |
| **Corrispondenza confermata** | È stato verificato che la corrispondenza è la stessa persona. |
| **Non conclusivo** | Impossibile determinare se la corrispondenza sia la stessa persona. |

> [!NOTE]
>
> ### **Suggerimento:** puoi modificare lo stato di revisione di una corrispondenza nella Console visualizzando la panoramica AML o facendo clic su una corrispondenza specifica per visualizzarne i dettagli.

***

## Come viene calcolato il punteggio di corrispondenza

### Passaggio 1: calcolo del punteggio di base

Il punteggio di base viene calcolato utilizzando tre componenti con pesi configurabili:

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

| Componente | Peso predefinito | Descrizione |
| - | - | - |
| **Nome** | 60% | Similarità fuzzy delle stringhe tra il nome sottoposto a screening e il nome della corrispondenza |
| **Data di nascita** | 25% | Punteggio esatto, parziale (solo anno) o mancata corrispondenza |
| **Paese/Nazionalità** | 15% | Confronto tra la nazionalità sottoposta a screening e i paesi della corrispondenza |

> **Nota:** la somma dei pesi deve essere sempre pari al 100%.

### Passaggio 2: logica "Golden Key" del numero del documento

Dopo aver calcolato il punteggio di base, il numero del documento viene valutato separatamente utilizzando una speciale logica di sovrascrittura:

| Scenario | Effetto | Esempio |
| - | - | - |
| **Corrispondenza** | Sovrascrive il punteggio impostandolo a **100** | I numeri di passaporto corrispondono esattamente |
| **Neutro** | Mantiene invariato il punteggio di base | Tipi di documento diversi o uno dei due dati mancante |
| **Mancata corrispondenza forte** | Applica una penalità (-50 punti) | Stesso tipo di documento ma valori differenti |

Questo approccio riconosce che la corrispondenza del numero del documento costituisce una prova definitiva dell'identità (la "Golden Key"), mentre tipi di documento non coincidenti non dovrebbero penalizzare il punteggio.

***

## Dettagli sul punteggio dei componenti

### Similarità del nome (0-100)

Il confronto dei nomi utilizza l'**algoritmo WRatio** di RapidFuzz, che è resistente a:

* Errori di battitura e di ortografia
* Differenze nell'ordine delle parole ("John Smith" vs "Smith, John")
* Variazioni del secondo nome ("Robert J. Smith" vs "Robert James Smith")
* Differenze di lunghezza

### Punteggio della data di nascita

| Scenario | Punteggio | Esempio |
| - | - | - |
| **Corrispondenza esatta** | 100% | "1985-03-15" corrisponde a "1985-03-15" |
| **Corrispondenza dell'anno (la corrispondenza fornisce solo l'anno)** | 100% | "1985-03-15" corrisponde a "1985" — corrispondenza completa poiché la corrispondenza fornisce una precisione limitata all'anno |
| **Corrispondenza dell'anno (giorno/mese diversi)** | 50% | "1985-03-15" corrisponde a "1985-06-20" — stesso anno ma le date differiscono |
| **Anno non corrispondente** | -100% (penalità) | "1985-03-15" non corrisponde a "1990-03-15" |
| **Nessun dato** | 0% (neutro) | Data di nascita mancante da una delle due parti |

> **Importante:** quando la corrispondenza fornisce solo un anno (ad es. "1974"), la corrispondenza con quell'anno conta come **corrispondenza completa** perché è l'unica informazione disponibile da verificare.

### Punteggio di paese/nazionalità

| Scenario | Punteggio | Esempio |
| - | - | - |
| **Corrispondenza esatta** | 100% | "ES" corrisponde a "Spain" o "ESP" |
| **Nessun dato nella corrispondenza** | 0% (neutro) | La corrispondenza non contiene informazioni sul paese |
| **Non corrispondente** | -50% (penalità) | "ES" non corrisponde a "France" |

Il sistema converte automaticamente tra:

* Codici ISO alpha-2 (ES)
* Codici ISO alpha-3 (ESP)
* Nomi completi dei paesi (Spain)

Controlla inoltre il campo `citizenship` oltre a `countries`.

***

## Normalizzazione del punteggio (ripesatura)

Quando mancano dati della persona sottoposta a screening o della corrispondenza, il sistema utilizza la **normalizzazione del punteggio** per evitare penalizzazioni dovute a informazioni non disponibili.

### Esempio: screening solo con nome

Se esegui lo screening solo con un nome (senza data di nascita o paese):

| Pesi originali | Pesi normalizzati |
| - | - |
| Nome: 60% | Nome: **100%** |
| DOB: 25% | DOB: 0% (non confrontabile) |
| Paese: 15% | Paese: 0% (non confrontabile) |

**Risultato:** il punteggio del nome diventa l'intero punteggio di corrispondenza.

### Esempio: paese mancante nella corrispondenza

Se la corrispondenza non dispone dei dati sul paese ma ha la data di nascita:

| Pesi originali | Pesi normalizzati |
| - | - |
| Nome: 60% | Nome: **70.6%** |
| DOB: 25% | DOB: **29.4%** |
| Paese: 15% | Paese: 0% (non confrontabile) |

Ciò garantisce un calcolo equo del punteggio indipendentemente dalla disponibilità dei dati.

***

## Opzioni di configurazione

Puoi personalizzare il calcolo del punteggio di corrispondenza tramite l'API o le impostazioni del workflow:

### Soglia del punteggio di corrispondenza

| Impostazione | Predefinito | Descrizione |
| - | - | - |
| Soglia del punteggio di corrispondenza | 93 | Le corrispondenze al di sotto di questa soglia sono classificate come **Falso positivo**. Le corrispondenze pari o superiori sono **Non esaminate** (Possibili corrispondenze) e richiedono una revisione. |

### Pesi (la somma deve essere 100)

| Impostazione | Predefinito | Descrizione |
| - | - | - |
| Peso del nome | 60 | Peso per la similarità del nome (0-100) |
| Peso della data di nascita | 25 | Peso per la data di nascita (0-100) |
| Peso del paese | 15 | Peso per paese/nazionalità (0-100) |

***

## Esempio di richiesta 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
}
```

***

## Risposta: dettaglio del punteggio

Ciascuna corrispondenza nella risposta include:

* `match_score` — Il punteggio di corrispondenza calcolato (0-100)
* `risk_score` — Il punteggio di rischio calcolato (0-100) - vedi [Punteggio di rischio](https://docs.didit.me/it/core-technology/aml-screening/aml-risk-score.md)
* `review_status` — "Falso positivo" o "Non esaminato" in base alla soglia del punteggio di corrispondenza
* `score_breakdown` — Dettaglio completo del calcolo del punteggio di corrispondenza

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

***

## Flusso completo: dal punteggio di corrispondenza allo stato AML finale

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           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                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

***

## Esempi di calcolo

### Esempio 1: Corrispondenza forte → Non revisionato

**Dati sottoposti a screening:**

* Nome: "Robert J. Smith"
* Data di nascita: "1985-03-15"
* Paese: "US"

**Dati della corrispondenza:**

* Nome: "Robert James Smith"
* Data di nascita: "1985"
* Paese: "United States"

**Calcolo:**

1. Punteggio nome: 90% (corrispondenza approssimata)
2. Punteggio data di nascita: 100% (la corrispondenza contiene solo l'anno, l'anno coincide)
3. Punteggio paese: 100% (corrispondenza esatta)

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

**Risultato:** Punteggio di corrispondenza (94) ≥ soglia (93) → **Non revisionato**
→ Il punteggio di rischio verrà calcolato e utilizzato per lo stato AML finale

### Esempio 2: Corrispondenza debole → Falso positivo

**Dati sottoposti a screening:**

* Nome: "John Smith"
* Data di nascita: "1990-05-20"
* Paese: "US"

**Dati della corrispondenza:**

* Nome: "Johnny Smithson"
* Data di nascita: "1975"
* Paese: "Canada"

**Calcolo:**

1. Punteggio nome: 72% (corrispondenza approssimata debole)
2. Punteggio data di nascita: -100% (penalità per mancata corrispondenza dell'anno)
3. Punteggio paese: -50% (penalità per mancata corrispondenza del paese)

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

**Risultato:** Punteggio di corrispondenza (11) \< soglia (93) → **Falso positivo**
→ Questa corrispondenza viene esclusa dalla valutazione del rischio

### Esempio 3: Sovrascrittura tramite Golden Key

**Dati sottoposti a screening:**

* Nome: "John D. Smith"
* Numero di documento: "A12345678"

**Dati della corrispondenza:**

* Nome: "Jonathan David Smith"
* Numero di documento: "A12345678"

**Calcolo:**

1. Punteggio base: \~70 (corrispondenza approssimata del nome)
2. Numero di documento: **CORRISPONDENZA** (corrispondenza esatta)

**Risultato:** Punteggio sovrascritto a **100** (corrispondenza Golden Key) → **Non revisionato**

***

## Gestione dello stato di revisione

Dopo la classificazione iniziale, puoi aggiornare manualmente lo stato di revisione di ciascuna corrispondenza:

### Nella Console

1. Vai alla panoramica AML della sessione
2. Fai clic su una corrispondenza specifica per visualizzarne i dettagli
3. Usa il menu a discesa dello stato per modificare lo stato di revisione:
   * **Corrispondenza confermata** — Verifica che si tratti della stessa persona
   * **Falso positivo** — Contrassegna la corrispondenza come non corrispondente
   * **Non conclusivo** — Impossibile stabilirlo

***

## Buone pratiche

1. **Inizia con la soglia predefinita (93)** — Offre un buon equilibrio tra l'individuazione di corrispondenze reali e l'esclusione dei falsi positivi.

2. **Abbassa la soglia per scenari ad alto rischio** — Se devi adottare maggiore cautela, abbassa la soglia del punteggio di corrispondenza per intercettare più potenziali corrispondenze.

3. **Usa i numeri di documento quando disponibili** — Forniscono la conferma d'identità più solida e possono sovrascrivere punteggi di corrispondenza bassi.

4. **Esamina i pesi normalizzati** — Verifica i campi dei pesi normalizzati nel dettaglio del punteggio per comprendere come i dati mancanti abbiano influito sul punteggio.

5. **Monitora i tassi di falsi positivi** — Se troppe corrispondenze legittime vengono contrassegnate come falsi positivi, abbassa la soglia.


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