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

# Advertencias de screening AML y códigos de alerta

> Códigos de advertencia AML en Didit: POSSIBLE_MATCH_FOUND y COULD_NOT_PERFORM_AML_SCREENING. Umbrales y reejecución sin datos KYC.

## Descripción general

El análisis AML emite un pequeño conjunto de etiquetas de advertencia en el array `warnings[]` de cada entrada de `aml_screenings[]`. Las dos etiquetas siguientes son las **únicas** advertencias AML que genera Didit. Todo lo demás que ves en una coincidencia está codificado en los propios campos de la coincidencia (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) y no como advertencia. Tanto las sesiones de un flujo de verificación (workflow) como la API de AML independiente emiten `POSSIBLE_MATCH_FOUND` de la misma forma.

El estado que se devuelve en el registro AML (`Approved`, `In Review`, `Declined`) se deriva del `score` agregado y de tus umbrales. Las etiquetas de advertencia señalan esas mismas condiciones para que puedas reaccionar a ellas de forma programática. Consulta [Puntuación de riesgo AML](https://docs.didit.me/es/core-technology/aml-screening/aml-risk-score.md) para ver cómo se corresponden los umbrales con el estado.

## Advertencias generadas

| Riesgo | Causa | `log_type` | Afecta al estado | Corrección recomendada |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | El `score` agregado es distinto de cero y supera el `aml_score_approve_threshold` (por defecto `80`): al menos una posible coincidencia entra en tu banda de riesgo. (La API de AML independiente también la emite cuando la puntuación es exactamente igual al umbral). | `warning`; pasa a `error` cuando la puntuación también supera el `aml_score_review_threshold` (por defecto `100`). | `In Review` cuando la puntuación supera el umbral de aprobación; `Declined` cuando supera el umbral de revisión. | Revisa cada coincidencia de `hits[]`. Usa el endpoint de estado de coincidencias AML para marcarlas como `Confirmed Match`, `False Positive` o `Inconclusive`. Las actualizaciones de coincidencias disparan un webhook `data.updated`, pero no recalculan el estado AML: define el estado final mediante el endpoint de estado AML o la revisión en la consola. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Al registro KYC le falta uno o más de estos campos: `full_name`, `date_of_birth` o `issuing_state`. No se realiza ninguna llamada de evaluación facturable. | `warning` | Fuerza `In Review`. | Completa los campos que faltan en el registro KYC. El análisis AML se vuelve a ejecutar automáticamente cuando los tres están presentes: el registro de advertencia obsoleto se elimina y no es necesario volver a ejecutarlo manualmente. |

Las advertencias se almacenan con `feature: "AML"` y siguen la estructura estándar del [objeto de advertencia](https://docs.didit.me/es/reference/data-models.md#objeto-de-advertencia).

## Configuración ajustable

Controles AML por nodo del flujo (también se aceptan como opciones en la API de AML independiente):

* **`aml_score_approve_threshold`**: por defecto `80`. Una puntuación distinta de cero que lo supere genera `POSSIBLE_MATCH_FOUND` y envía la comprobación AML a `In Review`. Las puntuaciones iguales o inferiores **no** generan la advertencia en los flujos de sesión, independientemente del número de coincidencias.
* **`aml_score_review_threshold`**: por defecto `100`. Una puntuación que lo supere rechaza automáticamente la comprobación AML (con el valor por defecto de `100` nunca se activa hasta que lo reduzcas).
* **`aml_match_score_threshold`**: por defecto `93`. Clasificación por coincidencia: las coincidencias con un `match_score` inferior empiezan como `False Positive` y se excluyen de la puntuación agregada; las iguales o superiores empiezan como `Unreviewed`.
* **Pesos de la puntuación de coincidencia**: `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, por defecto `60` / `25` / `15` (deben sumar 100). Consulta [Puntuación de coincidencia AML](https://docs.didit.me/es/core-technology/aml-screening/aml-match-score.md).
* **Monitorización continua**: cuando está activada, el análisis AML vuelve a analizar al sujeto a medida que cambian los conjuntos de datos y vuelve a emitir el informe junto con un webhook `status.updated` (cambio de estado) o `data.updated` (cambio en las coincidencias).

> [!NOTE]
>
> Cuando se dispara `COULD_NOT_PERFORM_AML_SCREENING`, la comprobación AML permanece en `In Review` hasta que se aporten los campos de identidad que faltan. En cuanto Didit tiene el nombre completo, la fecha de nacimiento y el estado emisor, el análisis AML se vuelve a ejecutar automáticamente y la advertencia desaparece: no se puede volver a activar manualmente.

## Ejemplos

### `POSSIBLE_MATCH_FOUND` (puntuación por encima del umbral de aprobación)

```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` (faltan campos KYC)

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

## Contenido relacionado

* [Informe AML](https://docs.didit.me/es/core-technology/aml-screening/report-aml-screening.md): estructura completa de la respuesta, campos de las coincidencias y semántica de los estados
* [Puntuación de riesgo AML](https://docs.didit.me/es/core-technology/aml-screening/aml-risk-score.md): cómo se calcula la puntuación agregada
* [Puntuación de coincidencia AML](https://docs.didit.me/es/core-technology/aml-screening/aml-match-score.md): confianza por coincidencia
* [Monitorización AML continua](https://docs.didit.me/es/core-technology/aml-screening/continuous-monitoring-aml-screening.md): ciclo de vida de la monitorización
* [Modelos de datos: análisis AML](https://docs.didit.me/es/reference/data-models.md#análisis-aml): esquema canónico, incluido el [objeto de advertencia](https://docs.didit.me/es/reference/data-models.md#objeto-de-advertencia)

### Tipos de advertencia


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