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

# Avisos e códigos de alerta de Triagem AML

> Entenda os avisos de Triagem AML da Didit como POSSIBLE_MATCH_FOUND. Configure limiares e reexecuções quando faltam dados KYC.

## Visão geral

A triagem AML emite um conjunto reduzido de etiquetas de aviso no array `warnings[]` de cada entrada em `aml_screenings[]`. As duas etiquetas abaixo são os **únicos** avisos de AML que a Didit produz — tudo o resto apresentado numa correspondência está codificado nos próprios campos da correspondência (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) em vez de como aviso. Tanto as sessões de fluxo como a API autónoma de AML emitem `POSSIBLE_MATCH_FOUND` da mesma forma.

O estado devolvido no registo de AML (`Approved`, `In Review`, `Declined`) deriva do `score` agregado e dos seus limiares — os avisos sinalizam essas mesmas condições para que possa reagir a elas programaticamente. Consulte [Pontuação de risco AML](https://docs.didit.me/pt/core-technology/aml-screening/aml-risk-score.md) para saber como os limiares são mapeados para o estado.

## Avisos gerados

| Risco | Causa | `log_type` | Afeta o estado | Mitigação recomendada |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | O `score` agregado é diferente de zero e superior a `aml_score_approve_threshold` (predefinição `80`) — pelo menos uma correspondência potencial ultrapassa a sua faixa de risco. (A API autónoma de AML também o emite quando a pontuação é exatamente igual ao limiar.) | `warning`; escala para `error` quando a pontuação também excede o `aml_score_review_threshold` (predefinição `100`). | `In Review` quando a pontuação está acima do limiar de aprovação; `Declined` quando está acima do limiar de revisão. | Reveja cada correspondência em `hits[]`. Utilize o endpoint de estado de correspondência de AML para marcar correspondências como `Confirmed Match`, `False Positive` ou `Inconclusive`. As atualizações de correspondências acionam um webhook `data.updated`, mas não voltam a calcular o estado de AML — defina o estado final através do endpoint de estado de AML ou da revisão na consola. |
| `COULD_NOT_PERFORM_AML_SCREENING` | O registo de KYC não tem um ou mais dos seguintes campos: `full_name`, `date_of_birth` ou `issuing_state`. Não é efetuada nenhuma chamada faturável de triagem. | `warning` | Força `In Review`. | Preencha os campos em falta no registo de KYC. A AML é executada novamente de forma automática assim que os três estiverem presentes — o registo de aviso obsoleto é removido e não é necessário nenhum novo acionamento manual. |

Os avisos são armazenados com `feature: "AML"` e seguem a estrutura padrão do [objeto de aviso](https://docs.didit.me/pt/reference/data-models.md#objeto-de-aviso).

## Definições configuráveis

Controlos de AML por nó de fluxo (também aceites como opções na API autónoma de AML):

* **`aml_score_approve_threshold`** — predefinição `80`. Uma pontuação diferente de zero superior a este valor produz `POSSIBLE_MATCH_FOUND` e encaminha a verificação de AML para `In Review`. Pontuações iguais ou inferiores a este valor **não** produzem o aviso em fluxos de sessão, independentemente do número de correspondências.
* **`aml_score_review_threshold`** — predefinição `100`. Uma pontuação superior a este valor recusa automaticamente a verificação de AML (com a predefinição de `100`, nunca é acionada até que a reduza).
* **`aml_match_score_threshold`** — predefinição `93`. Classificação por correspondência: correspondências com `match_score` abaixo deste valor começam como `False Positive` e são excluídas da pontuação agregada; iguais ou superiores começam como `Unreviewed`.
* **Pesos da pontuação de correspondência** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, predefinições `60` / `25` / `15` (devem somar 100). Consulte [Pontuação de correspondência AML](https://docs.didit.me/pt/core-technology/aml-screening/aml-match-score.md).
* **Monitorização contínua** — quando ativada, a AML realiza uma nova triagem do sujeito à medida que os conjuntos de dados mudam e volta a emitir o relatório juntamente com um webhook `status.updated` (estado alterado) ou `data.updated` (correspondências alteradas).

> [!NOTE]
>
> Quando `COULD_NOT_PERFORM_AML_SCREENING` é acionado, a verificação de AML permanece em `In Review` até que os campos de identidade em falta sejam fornecidos. Assim que a Didit tiver o nome completo, a data de nascimento e o estado emissor, a AML é executada novamente de forma automática e o aviso é removido — não é necessário voltar a acioná-lo manualmente.

## Exemplos

### `POSSIBLE_MATCH_FOUND` (pontuação acima do limiar de aprovação)

```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` (campos de KYC em falta)

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

## Relacionado

* [Relatório de AML](https://docs.didit.me/pt/core-technology/aml-screening/report-aml-screening.md) — formato completo da resposta, campos de correspondências, semântica do estado
* [Pontuação de risco AML](https://docs.didit.me/pt/core-technology/aml-screening/aml-risk-score.md) — como a pontuação agregada é calculada
* [Pontuação de correspondência AML](https://docs.didit.me/pt/core-technology/aml-screening/aml-match-score.md) — confiança por correspondência
* [Monitorização AML contínua](https://docs.didit.me/pt/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — ciclo de vida da monitorização
* [Modelos de dados — Triagem AML](https://docs.didit.me/pt/reference/data-models.md#triagem-aml) — esquema canónico, incluindo o [Objeto de aviso](https://docs.didit.me/pt/reference/data-models.md#objeto-de-aviso)

### Tipos de aviso


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