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

# Informe de cribratge AML: coincidències i puntuacions

> Analitza respostes de cribratge AML a Didit: coincidències, sancions, PEP, mitjans adversos, puntuacions de risc i monitoratge continu.

## Visió general

El cribratge AML creua la identitat del subjecte verificat amb conjunts de dades globals de sancions, PEP, llistes de vigilància i mitjans adversos. Cada coincidència retorna l'entitat coincident, el conjunt o conjunts de dades que han generat la coincidència, dues puntuacions — `match_score` (confiança de la identitat) i `risk_score` (risc de l'entitat) — i un desglossament estructurat per font (`pep_matches[]`, `sanction_matches[]`, `warning_matches[]`, `adverse_media_matches[]`). La puntuació agregada `score` és el `risk_score` més alt d'entre les coincidències que no estan marcades com a `False Positive`.

El cribratge AML retorna la mateixa estructura en sessions d'usuaris (KYC), sessions d'empreses (KYB) i a l'API d'AML independent.

![Captura de pantalla de l'informe de cribratge AML de Didit amb coincidències de sancions, PEP i mitjans adversos](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-screening-report.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=5b74561abdd242f108fee1b429ff5020)

## On apareix a les respostes de l'API

A l'endpoint de decisió de la sessió, el cribratge AML es retorna com l'array plural **`aml_screenings[]`**. Cada entrada correspon a una execució d'AML al flux de treball (una comprovació d'AML que s'executa dues vegades genera dues entrades amb valors de `node_id` diferents).

```text theme={null}
GET /v3/session/{sessionId}/decision/
  ──▶ { "aml_screenings": [ { node_id, status, total_hits, hits, … }, … ] }
```

L'AML independent i les sessions d'empreses retornen la mateixa estructura per registre. Els camps següents reflecteixen l'esquema canònic de la pàgina [Models de dades](https://docs.didit.me/ca/reference/data-models.md#cribratge-aml).

## Tres puntuacions, no pas un sol veredicte

L'estat `status` és un veredicte; els números a partir dels quals s'ha obtingut es troben al mateix payload. Consulta'ls quan creïs la teva pròpia classificació per nivells de risc (per exemple, combinant el risc d'AML amb respostes de qüestionaris com l'origen del patrimoni o l'autodeclaració de PEP) en lloc de bifurcar només segons `Approved` / `In Review` / `Declined`:

| Puntuació | On | Escala | Respon a |
| - | - | - | - |
| `hits[].match_score` | per coincidència | 0-100 | És aquesta coincidència la mateixa persona que la sotmesa a cribratge? Decideix el `review_status` inicial de la coincidència. |
| `hits[].risk_score` | per coincidència | 0-100 | Quin és el nivell de risc de l'entitat coincident? Ve determinat per les categories de la coincidència (sanció, PEP, delictes...). |
| `score` | per cribratge | 0-100 | El `risk_score` més alt d'entre les coincidències no marcades com a `False Positive`. És el valor amb el qual es comparen els llindars d'aprovació / revisió per generar l'estat `status`. |

Totes tres són presents a cada lloc on es lliura l'informe d'AML: `GET /v3/session/{sessionId}/decision/`, l'objecte `decision` dels webhooks `status.updated` i `data.updated` a **totes** les versions de webhook (la versió V3 `aml_screenings[]`, i la versió heretada V2 / V1 singular `aml`), i a l'API d'AML independent. Un consumidor que només veu una etiqueta d'alerta / sense alertes està llegint `status` (o el `review_status` d'una coincidència) i ignorant les puntuacions que l'acompanyen. La consola mostra els mateixos números: la capçalera de la secció d'AML inclou la **Puntuació de risc** agregada, i cada fila de la taula de coincidències inclou la **Puntuació de coincidència** i la **Puntuació de risc** amb un desglossament en passar-hi el cursor per sobre.

## Esquema

Consulta [Cribratge AML a la referència de models de dades](https://docs.didit.me/ca/reference/data-models.md#cribratge-aml) per veure l'esquema canònic. Camps de primer nivell:

| Camp | Tipus | Notes |
| - | - | - |
| `status` | `Not Finished` \| `Approved` \| `Declined` \| `In Review` | Estat a nivell de funcionalitat (`FeatureStatusChoices`). Determina les regles del flux de treball i la pantalla de revisió manual. |
| `total_hits` | integer | Recompte d'entrades a `hits[]`. `0` quan no hi ha coincidències. |
| `entity_type` | `person` \| `company` | El tipus de subjecte analitzat. Les empreses i les persones físiques utilitzen una lògica de coincidència diferent. |
| `score` | float (0-100) \| null | Puntuació de risc AML agregada: el `risk_score` més alt entre els hits no marcats com a `False Positive`. `0` quan no hi ha cap coincidència possible; `null` fins que s'ha executat el cribratge. |
| `hits` | `Hit[]` | Una entrada per registre coincident, **inclosos** els hits autoclassificats com a `False Positive` (es mantenen a la llista però s'exclouen del `score` agregat). Consulta els camps per hit a continuació. |
| `screened_data` | object | Els valors exactes que Didit ha enviat al cribratge: `full_name`, `date_of_birth`, `nationality` (ISO 3166-1 alpha-2), `document_number`. Útil per explicar un hit a un revisor o per auditar què s'ha cercat. |
| `is_ongoing_monitoring_enabled` | boolean | `true` un cop habilitis el monitoratge continu per a la sessió. |
| `next_ongoing_monitoring_bill_date` | string \| null | `YYYY-MM-DD` de la propera renovació anual de **facturació** (`last_aml_bill_date` + 365 dies). `null` fins que s'habilita el monitoratge. Aquesta no és una data de cribratge; consulta `last_ongoing_screening_at` a continuació. |
| `last_ongoing_screening_at` | string (ISO 8601) \| null | Data i hora en què el monitoratge continu va **completar** per darrera vegada un nou cribratge d'aquest registre, hagi canviat o no el resultat. `null` quan el registre no s'ha tornat a sotmetre a un cribratge des que es va introduir aquest camp; mai s'omple retroactivament a partir de la data d'habilitació o de facturació. |
| `last_ongoing_screening_datasets_updated_at` | string (ISO 8601) \| null | La data d'actualització del conjunt de dades AML més recent que el proveïdor va comunicar en el moment d'aquell cribratge. `null` quan el proveïdor no ha comunicat cap data del conjunt de dades; mai s'estima. |
| `warnings` | `Warning[]` | Etiquetes d'advertència específiques d'AML. Consulta [Advertències d'AML](https://docs.didit.me/ca/core-technology/aml-screening/warnings-aml-screening.md). |
| `node_id` | string \| null | Identifica el node del graf del flux de treball que ha generat aquesta execució d'AML a les respostes de sessió de `/v3/`. La resposta de l'API d'AML independent l'omet. |

### Camps per hit

Cada entrada a `hits[]` té els camps següents (es mostra un subconjunt). Les matrius d'origen de coincidència — `pep_matches[]`, `sanction_matches[]`, `warning_matches[]`, `adverse_media_matches[]` — només s'omplen per als conjunts de dades als quals pertany el hit.

| Camp | Tipus | Notes |
| - | - | - |
| `id` | string | Identificador estable del hit: `hit_` seguit de 24 caràcters hexadecimals. La mateixa entitat coincident manté el mateix `id` quan es torna a fer el cribratge del subjecte. Fes-lo servir com a `hit_id` en actualitzar `review_status` mitjançant l'endpoint d'estat de hits d'AML. |
| `caption` | string | El nom principal de l'entitat tal com està emmagatzemat al conjunt de dades. |
| `datasets` | string\[] | Categories de risc sota les quals figura l'entitat: `PEP` (amb el seu nivell, de `PEP Level 1` a `PEP Level 4`), `Sanctions`, `Adverse Media`, `Warnings and Regulatory Enforcement`, `Fitness and Probity`, `SIP`, `SIE` o `Insolvency`, i `Other Lists` quan la font de l'entitat no indica cap d'aquestes. |
| `match_score` | number (0-100) | Confiança d'identitat: quina probabilitat hi ha que el hit sigui la mateixa persona. Els hits per sota de `aml_match_score_threshold` (per defecte `93`) comencen com a `False Positive`; si assoleixen o superen aquest llindar, comencen com a `Unreviewed`. Consulta [Puntuació de coincidència d'AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-match-score.md). |
| `risk_score` | number (0-100) | Risc de l'entitat: quin nivell de risc presenta l'entitat coincident. El `risk_score` més alt entre els hits que no siguin `False Positive` es converteix en el `score` de primer nivell. Consulta [Puntuació de risc AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md). |
| `score` | number (0-1) | Puntuació de coincidència ponderada **obsoleta**. Fes servir `match_score` en el seu lloc. |
| `match` | boolean \| null | Indicador heretat de coincidència exacta. És preferible utilitzar `match_score` + `review_status`. |
| `target` | boolean \| null | Si l'entitat és l'objectiu directe de la llista. |
| `review_status` | `Unreviewed` \| `Confirmed Match` \| `False Positive` \| `Inconclusive` | El valor inicial es deriva de comparar `match_score` amb `aml_match_score_threshold`. Es pot modificar mitjançant l'endpoint d'estat de hits d'AML; actualitzar-lo activa un webhook de tipus `data.updated`, però **no** torna a calcular automàticament l'estat (`status`) de la funcionalitat: fes servir l'endpoint d'estat d'AML o la revisió des de la consola per a això. |
| `score_breakdown` | object | Com s'ha calculat `match_score`: puntuacions de nom, data de naixement i país, ponderacions, contribucions i l'efecte de "clau d'or" del número de document (`MATCH` el fixa a 100, `NEUTRAL` manté la puntuació base, `HARD_MISMATCH` penalitza). |
| `properties` | object | Atributs en brut del conjunt de dades (noms, àlies, dates de naixement, ciutadania...). Útils per a la presa de decisions. |
| `url` | string \| null | URL d'origen de l'entitat coincident, quan estigui disponible. |
| `rca_name` | string \| null | Quan el hit és d'un familiar o persona propera (RCA), el nom de la persona relacionada a través de la qual s'ha produït la coincidència. |
| `pep_matches[]` | object\[] | Càrrecs PEP, publicadors, dates de naixement i formació del hit. |
| `sanction_matches[]` | object\[] | Nom de la llista de sancions, programa, autoritat sancionadora, data d'inclusió a la llista i URL d'origen. |
| `warning_matches[]` | object\[] | Registres genèrics de llistes de vigilància o d'accions d'aplicació de la normativa. |
| `adverse_media_matches[]` | object\[] | Mitjans adversos a nivell d'article: titular, resum, sentiment, URL d'origen, data de publicació i paraules clau. |
| `adverse_media_details` | object \| null | Sentiment agregat de mitjans adversos i recompte de paraules clau a tot el hit. |
| `risk_view` | object | Desglossament del risc ponderat per categoria, país i delicte per al hit (`risk_level`, `risk_scores`, `weightage`). |
| `linked_entities[]` | object\[] | Entitats relacionades que el conjunt de dades connecta amb el hit (per exemple, familiars o socis comercials). |
| `first_seen` / `last_seen` | string \| null | Quan el conjunt de dades va observar aquesta entrada per primera o última vegada. |
| `additional_information` | object | Dades addicionals en format lliure del proveïdor del conjunt de dades. |

> [!NOTE]
>
> Els hits classificats com a `False Positive` (perquè `match_score` ha quedat per sota del llindar de puntuació de coincidència o perquè un revisor els ha marcat així) romanen a `hits[]` per motius d'auditoria. Només s'exclouen del càlcul del `score` agregat.

### Monitoratge continu

Quan `is_ongoing_monitoring_enabled` és `true`, Didit torna a fer el cribratge del subjecte contínuament i torna a emetre l'informe AML cada vegada que s'afegeix, s'elimina o canvia una coincidència. Els nous cribratges que canvien l'estat d'AML activen un webhook `status.updated`; els nous cribratges que només canvien dades de coincidències activen `data.updated`. La finestra de monitoratge s'estén des de `last_aml_bill_date` durant 365 dies; `next_ongoing_monitoring_bill_date` exposa quan tindrà lloc la següent renovació anual.

Aquests senyals es basen tots en canvis, de manera que un subjecte a qui es torna a fer el cribratge durant mesos sense noves coincidències no en produeix cap. `last_ongoing_screening_at` és l'únic camp que s'actualitza a **cada** execució completada, i l'[endpoint screening-history](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md#demostrar-que-el-monitoratge-s’ha-executat) llista cada execució individualment — incloses aquelles que no han canviat res. Consulta [Monitoratge AML continu](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md) per veure el cicle de vida complet.

> [!WARNING]
>
> Tres dates d'aquest informe signifiquen tres coses diferents. `next_ongoing_monitoring_bill_date` és quan se't facturarà la propera vegada. `last_ongoing_screening_at` és quan es va fer realment l'últim cribratge del subjecte. `last_ongoing_screening_datasets_updated_at` és quan el proveïdor va actualitzar per última vegada les llistes en què es basa aquest cribratge. Només la segona demostra que el control es va executar.

## Valors d'estat

| Valor | Significat |
| - | - |
| `Not Finished` | L'AML encara no s'ha executat per a aquesta sessió/node. |
| `Approved` | La puntuació agregada està al llindar d'aprovació o per sota (per defecte `80`) — fins i tot quan no hi ha coincidències o cada coincidència és un `False Positive` (puntuació `0`). |
| `In Review` | La puntuació agregada està per sobre del llindar d'aprovació (i al llindar de revisió o per sota), o s'ha activat `COULD_NOT_PERFORM_AML_SCREENING`. |
| `Declined` | La puntuació agregada està per sobre del llindar de revisió (per defecte `100`, de manera que la denegació automàtica només té lloc un cop el rebaixes), o l'estat s'ha establert manualment. |

Els llindars es poden configurar per a cada node del flux de treball — consulta [Puntuació de risc d'AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md). Les regles d'estat personalitzades es combinen amb l'estat derivat utilitzant la precedència `Declined` > `In Review` > `Approved`; els revisors també poden anul·lar l'estat d'AML des de la consola o des de l'endpoint d'estat d'AML.

## Exemples

### Approved — sense coincidències

```json theme={null}
{
  "aml_screenings": [
    {
      "node_id": "aml-1",
      "status": "Approved",
      "total_hits": 0,
      "entity_type": "person",
      "score": 0,
      "hits": [],
      "screened_data": {
        "full_name": "Jane Doe",
        "nationality": "US",
        "date_of_birth": "1990-06-12",
        "document_number": "P9876543"
      },
      "is_ongoing_monitoring_enabled": false,
      "last_ongoing_screening_at": null,
      "last_ongoing_screening_datasets_updated_at": null,
      "next_ongoing_monitoring_bill_date": null,
      "warnings": []
    }
  ]
}
```

### In Review — coincidència de PEP + mitjans adversos

Tots els noms, URLs i articles següents són ficticis.

```json theme={null}
{
  "aml_screenings": [
    {
      "node_id": "aml-1",
      "status": "In Review",
      "total_hits": 1,
      "entity_type": "person",
      "score": 85,
      "hits": [
        {
          "id": "hit_7c1e9a40b2d35f86e0a4c912",
          "caption": "John Q. Exampleton",
          "datasets": ["PEP"],
          "match_score": 96,
          "risk_score": 85,
          "score": 0.97,
          "match": false,
          "target": null,
          "review_status": "Unreviewed",
          "properties": {
            "name": ["John Q. Exampleton"],
            "alias": ["Johnny Example"],
            "birthDate": ["1974"],
            "birthPlace": ["Springfield"]
          },
          "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": 96
          },
          "pep_matches": [
            {
              "list_name": "Example PEP Registry",
              "publisher": "Example Registry",
              "matched_name": "John Q. Exampleton",
              "pep_position": "Regional council member",
              "date_of_birth": "1974-01-01",
              "place_of_birth": "Springfield",
              "source_url": "https://example.org/registry/entities/Q0000001"
            }
          ],
          "sanction_matches": [],
          "warning_matches": [],
          "adverse_media_matches": [
            {
              "country": "freedonia",
              "headline": "Court opens inquiry into council hiring irregularities",
              "summary": "John Q. Exampleton is named in a legal investigation regarding irregularities in public hiring.",
              "sentiment": "moderately negative",
              "sentiment_score": -2,
              "source_url": "https://example-news.org/articles/12345",
              "publication_date": "2025-06-09T10:19:10",
              "adverse_keywords": ["fraud", "irregularities"]
            }
          ],
          "adverse_media_details": {
            "sentiment": "Moderately Negative",
            "sentiment_score": -2,
            "entity_type": "person",
            "adverse_keywords": { "fraud": 3, "corruption": 2 }
          },
          "risk_view": {
            "categories": { "score": 100.0, "weightage": 50, "risk_level": "High", "risk_scores": { "PEP": 100.0 } },
            "countries":  { "score": 0.0,   "weightage": 30, "risk_level": "Low",  "risk_scores": {} },
            "crimes":     { "score": 0.0,   "weightage": 20, "risk_level": "Low",  "risk_scores": {} },
            "custom_list": {}
          },
          "linked_entities": [
            { "name": ["Mary Exampleton"], "relation": [], "details": [], "active": [], "status": [] }
          ],
          "first_seen": "2025-01-18T00:00:00",
          "last_seen": "2025-06-13T00:00:00"
        }
      ],
      "screened_data": {
        "full_name": "John Q. Exampleton",
        "nationality": "US",
        "date_of_birth": "1974-01-01",
        "document_number": null
      },
      "is_ongoing_monitoring_enabled": true,
      "next_ongoing_monitoring_bill_date": "2027-05-17",
      "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"
        }
      ]
    }
  ]
}
```

## Relacionat

* [Advertències d'AML](https://docs.didit.me/ca/core-technology/aml-screening/warnings-aml-screening.md) — cada codi d'advertència que pot emetre l'AML
* [Puntuació de risc d'AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-risk-score.md) i [Puntuació de coincidència d'AML](https://docs.didit.me/ca/core-technology/aml-screening/aml-match-score.md) — com es calculen les dues puntuacions
* [Monitoratge AML continu](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — habilitar i consumir esdeveniments de monitoratge
* [Base de dades de llistes de vigilància](https://docs.didit.me/ca/core-technology/aml-screening/watchlist-database-aml-screening.md) — conjunts de dades coberts
* [Models de dades — Cribratge AML](https://docs.didit.me/ca/reference/data-models.md#cribratge-aml) — esquema canònic
* [Webhooks](https://docs.didit.me/ca/integration/webhooks.md) — `status.updated` s'activa quan l'AML canvia l'estat de la sessió; els canvis d'estat de revisió de coincidències i les actualitzacions de dades de monitoratge activen `data.updated`


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