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

# Screening AML: avvisi e codici di alert

> Scopri i codici di avviso dello Screening AML di Didit, come POSSIBLE_MATCH_FOUND, e come configurare soglie e nuovi tentativi.

## Panoramica

Lo Screening AML genera un set ridotto di tag di avviso nell'array `warnings[]` di ciascuna voce in `aml_screenings[]`. I due tag seguenti sono gli **unici** avvisi AML generati da Didit — tutto il resto visibile su un riscontro è codificato nei campi specifici del riscontro stesso (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) anziché come avviso. Sia le sessioni di workflow sia l'API AML autonoma emettono `POSSIBLE_MATCH_FOUND` nello stesso modo.

Lo stato restituito sul record AML (`Approved`, `In Review`, `Declined`) è ricavato dallo `score` aggregato e dalle tue soglie — gli avvisi contrassegnano le stesse condizioni consentendoti di gestirle a livello programmatico. Consulta [Punteggio di rischio AML](https://docs.didit.me/it/core-technology/aml-screening/aml-risk-score.md) per scoprire come le soglie mappano gli stati.

## Avvisi generati

| Rischio | Causa | `log_type` | Influisce sullo stato | Risoluzione consigliata |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | Lo `score` aggregato è diverso da zero e superiore a `aml_score_approve_threshold` (predefinito `80`) — almeno un riscontro di possibile corrispondenza supera la tua fascia di rischio. (L'API AML autonoma lo emette anche quando il punteggio è esattamente uguale alla soglia.) | `warning`; passa a `error` quando il punteggio supera anche `aml_score_review_threshold` (predefinito `100`). | `In Review` quando il punteggio è superiore alla soglia di approvazione; `Declined` quando supera la soglia di revisione. | Esamina ogni riscontro in `hits[]`. Usa l'endpoint per lo stato dei riscontri AML per contrassegnare i riscontri come `Confirmed Match`, `False Positive` o `Inconclusive`. Gli aggiornamenti dei riscontri attivano un webhook `data.updated`, ma non ricalcolano lo stato AML — imposta lo stato finale tramite l'endpoint per lo stato AML o mediante revisione nella console. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Nel record KYC mancano uno o più campi tra `full_name`, `date_of_birth` o `issuing_state`. Non viene effettuata alcuna chiamata di screening fatturabile. | `warning` | Forza `In Review`. | Compila i campi mancanti nel record KYC. Lo Screening AML viene eseguito nuovamente in automatico non appena tutti e tre sono presenti — il log di avviso obsoleto viene rimosso e non è necessario alcun nuovo trigger manuale. |

Gli avvisi vengono salvati con `feature: "AML"` e seguono la struttura standard dell'[oggetto avviso](https://docs.didit.me/it/reference/data-models.md#oggetto-avviso).

## Impostazioni configurabili

Controlli AML per nodo del workflow (accettati anche come opzioni nell'API AML autonoma):

* **`aml_score_approve_threshold`** — predefinito `80`. Un punteggio diverso da zero superiore a questo valore genera `POSSIBLE_MATCH_FOUND` e instrada il controllo AML a `In Review`. I punteggi pari o inferiori a tale soglia **non** generano l'avviso nei workflow di sessione, indipendentemente dal numero di riscontri.
* **`aml_score_review_threshold`** — predefinito `100`. Un punteggio superiore a questo valore rifiuta automaticamente il controllo AML (con il valore predefinito pari a `100` non si attiva mai finché non lo abbassi).
* **`aml_match_score_threshold`** — predefinito `93`. Classificazione per singolo riscontro: i riscontri con `match_score` inferiore a questo valore iniziano come `False Positive` e sono esclusi dal punteggio aggregato; pari o superiori a tale valore iniziano come `Unreviewed`.
* **Pesi del punteggio di corrispondenza** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, predefiniti `60` / `25` / `15` (la somma deve essere pari a 100). Consulta [Punteggio di corrispondenza AML](https://docs.didit.me/it/core-technology/aml-screening/aml-match-score.md).
* **Monitoraggio continuo** — quando abilitato, lo Screening AML esegue nuovamente l'analisi del soggetto al variare dei dataset e riemette il report insieme a un webhook `status.updated` (stato modificato) o `data.updated` (riscontri modificati).

> [!NOTE]
>
> Quando si attiva `COULD_NOT_PERFORM_AML_SCREENING`, il controllo AML rimane in stato `In Review` finché non vengono forniti i campi di identità mancanti. Una volta che Didit dispone di nome completo, data di nascita e stato di emissione, lo Screening AML viene eseguito di nuovo automaticamente e l'avviso viene cancellato — non è necessario alcun nuovo trigger manuale.

## Esempi

### `POSSIBLE_MATCH_FOUND` (punteggio superiore alla soglia di approvazione)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}
```

### `COULD_NOT_PERFORM_AML_SCREENING` (campi KYC mancanti)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}
```

## Risorse correlate

* [Report AML](https://docs.didit.me/it/core-technology/aml-screening/report-aml-screening.md) — struttura completa della risposta, campi dei riscontri, semantica dello stato
* [Punteggio di rischio AML](https://docs.didit.me/it/core-technology/aml-screening/aml-risk-score.md) — come viene calcolato il punteggio aggregato
* [Punteggio di corrispondenza AML](https://docs.didit.me/it/core-technology/aml-screening/aml-match-score.md) — affidabilità per singolo riscontro
* [Monitoraggio AML continuo](https://docs.didit.me/it/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — ciclo di vita del monitoraggio
* [Modelli di dati — Screening AML](https://docs.didit.me/it/reference/data-models.md#screening-aml) — schema canonico, incluso l'[oggetto avviso](https://docs.didit.me/it/reference/data-models.md#oggetto-avviso)

### Tipi di avviso


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