Informe de cribratge AML: coincidències i puntuacions

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

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

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.

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

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 llista cada execució individualment — incloses aquelles que no han canviat res. Consulta Monitoratge AML continu per veure el cicle de vida complet.

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

{
  "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.

{
  "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 — cada codi d’advertència que pot emetre l’AML
Puntuació de risc d’AML i Puntuació de coincidència d’AML — com es calculen les dues puntuacions
Monitoratge AML continu — habilitar i consumir esdeveniments de monitoratge
Base de dades de llistes de vigilància — conjunts de dades coberts
Models de dades — Cribratge AML — esquema canònic
Webhooks — 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

Autenticació

Verificació

Monitoratge

Plataforma

Informe de cribratge AML: coincidències i puntuacions

Visió general

On apareix a les respostes de l’API

Tres puntuacions, no pas un sol veredicte

Esquema

Camps per hit

Monitoratge continu

Valors d’estat

Exemples

Approved — sense coincidències

In Review — coincidència de PEP + mitjans adversos

Relacionat

​Visió general

​On apareix a les respostes de l’API

​Tres puntuacions, no pas un sol veredicte

​Esquema

​Camps per hit

​Monitoratge continu

​Valors d’estat

​Exemples

​Approved — sense coincidències

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

​Relacionat

Visió general

On apareix a les respostes de l’API

Tres puntuacions, no pas un sol veredicte

Esquema

Camps per hit

Monitoratge continu

Valors d’estat

Exemples

Approved — sense coincidències

In Review — coincidència de PEP + mitjans adversos

Relacionat