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

# Advertències de cribratge AML i codis d'alerta

> Interpreta els codis d'advertència de cribratge AML a Didit, configura llindars i gestiona reintents si falten dades de KYC.

## Visió general

El cribratge AML emet un conjunt reduït d'etiquetes d'advertència a la matriu `warnings[]` de cada entrada d'`aml_screenings[]`. Les dues etiquetes següents són les **úniques** advertències d'AML que Didit genera; tota la resta del que veus en una coincidència està codificat en els camps de la mateixa coincidència (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) en lloc de com a advertència. Tant les sessions de flux de treball com l'API d'AML independent emeten `POSSIBLE_MATCH_FOUND` de la mateixa manera.

L'estat que es retorna al registre d'AML (`Approved`, `In Review`, `Declined`) es deriva de la `score` agregada i dels teus llindars; les advertències etiqueten les mateixes condicions perquè puguis reaccionar-hi programàticament. Consulta [Puntuació de risc AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md) per veure com es mapegen els llindars als estats.

## Advertències generades

| Risc | Causa | `log_type` | Afecta l'estat | Acció correctora recomanada |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | La `score` agregada és diferent de zero i supera `aml_score_approve_threshold` (per defecte `80`): almenys una possible coincidència creua la teva franja de risc. (L'API d'AML independent també l'emet quan la puntuació és exactament igual al llindar). | `warning`; escala a `error` quan la puntuació també supera `aml_score_review_threshold` (per defecte `100`). | `In Review` quan la puntuació supera el llindar d'aprovació; `Declined` quan supera el llindar de revisió. | Revisa cada coincidència a `hits[]`. Utilitza l'endpoint d'estat de coincidències d'AML per marcar les coincidències com a `Confirmed Match`, `False Positive` o `Inconclusive`. Les actualitzacions de coincidències disparen un webhook `data.updated` però no recalculen l'estat d'AML: estableix l'estat final mitjançant l'endpoint d'estat d'AML o mitjançant la revisió a la consola. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Al registre de KYC li falta un o més dels camps `full_name`, `date_of_birth` o `issuing_state`. No es fa cap crida de cribratge facturable. | `warning` | Força `In Review`. | Emplena els camps que falten al registre de KYC. L'AML es torna a executar automàticament un cop hi són tots tres: el registre d'advertència obsolet s'elimina i no cal cap reactivació manual. |

Les advertències s'emmagatzemen amb `feature: "AML"` i segueixen l'estructura estàndard de l'[objecte d'advertència](https://docs.didit.me/ca/reference/data-models.md#objecte-d’advertència).

## Paràmetres configurables

Controls d'AML per node del flux de treball (també acceptats com a opcions a l'API d'AML independent):

* **`aml_score_approve_threshold`** — per defecte `80`. Una puntuació diferent de zero per sobre d'aquest valor produeix `POSSIBLE_MATCH_FOUND` i desvia la comprovació d'AML a `In Review`. Les puntuacions iguals o inferiors **no** produeixen l'advertència en fluxos de treball de sessió, independentment del nombre de coincidències.
* **`aml_score_review_threshold`** — per defecte `100`. Una puntuació per sobre d'aquest valor rebutja automàticament la comprovació d'AML (amb el valor per defecte de `100`, això no s'activa mai tret que el redueixis).
* **`aml_match_score_threshold`** — per defecte `93`. Classificació per coincidència: les coincidències amb un `match_score` inferior comencen com a `False Positive` i s'exclouen de la puntuació agregada; si és igual o superior, comencen com a `Unreviewed`.
* **Ponderacions de la puntuació de coincidència** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, valors per defecte `60` / `25` / `15` (han de sumar 100). Consulta [Puntuació de coincidència AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-match-score.md).
* **Monitoratge continu** — quan està habilitat, l'AML torna a fer el cribratge del subjecte a mesura que canvien els conjunts de dades i torna a emetre l'informe juntament amb un webhook `status.updated` (canvi d'estat) o `data.updated` (canvi en les coincidències).

> [!NOTE]
>
> Quan s'activa `COULD_NOT_PERFORM_AML_SCREENING`, la comprovació d'AML es manté a `In Review` fins que es proporcionin els camps d'identitat que falten. Un cop Didit té el nom complet, la data de naixement i l'estat emissor, l'AML es torna a executar automàticament i l'advertència s'elimina; no cal cap reactivació manual.

## Exemples

### `POSSIBLE_MATCH_FOUND` (puntuació per sobre del llindar d'aprovació)

```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` (camps de KYC absents)

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

## Relacionats

* [Informe d'AML](https://docs.didit.me/ca/core-technology/aml-screening/report-aml-screening.md) — estructura completa de la resposta, camps de les coincidències, semàntica dels estats
* [Puntuació de risc AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md) — com es calcula la puntuació agregada
* [Puntuació de coincidència AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-match-score.md) — confiança per coincidència
* [Monitoratge AML continu](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — cicle de vida del monitoratge
* [Models de dades: cribratge AML](https://docs.didit.me/ca/reference/data-models.md#cribratge-aml) — esquema canònic, inclòs l'[objecte d'advertència](https://docs.didit.me/ca/reference/data-models.md#objecte-d’advertència)

### Tipus d'advertències


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