> ## 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 de triagem AML e códigos de alerta > Códigos de aviso AML da Didit: POSSIBLE_MATCH_FOUND e COULD_NOT_PERFORM_AML_SCREENING. Configure limiares e reexecução se faltarem dados KYC. ## Visão geral A triagem AML emite um pequeno conjunto de tags de aviso no array `warnings[]` de cada entrada em `aml_screenings[]`. As duas tags abaixo são os **únicos** avisos AML que a Didit produz. Todo o resto que você vê em uma correspondência é codificado nos próprios campos da correspondência (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …), e não como aviso. Tanto as sessões de workflow quanto a API AML independente emitem `POSSIBLE_MATCH_FOUND` da mesma forma. O status retornado no registro AML (`Approved`, `In Review`, `Declined`) é derivado do `score` agregado e dos seus limiares. Os avisos marcam as mesmas condições para que você possa reagir a elas de forma programática. Consulte [pontuação de risco AML](https://docs.didit.me/pt-br/core-technology/aml-screening/aml-risk-score.md) para ver como os limiares se convertem em status. ## Avisos produzidos | Risco | Causa | `log_type` | Afeta o status | Correção recomendada | | - | - | - | - | - | | `POSSIBLE_MATCH_FOUND` | O `score` agregado é diferente de zero e está acima do `aml_score_approve_threshold` (padrão `80`): pelo menos uma possível correspondência ultrapassa a sua faixa de risco. (A API AML independente também o emite quando a pontuação é exatamente igual ao limiar.) | `warning`; passa para `error` quando a pontuação também excede o `aml_score_review_threshold` (padrão `100`). | `In Review` quando a pontuação está acima do limiar de aprovação; `Declined` quando está acima do limiar de revisão. | Revise cada correspondência em `hits[]`. Use o endpoint de status de correspondências AML para marcar as correspondências como `Confirmed Match`, `False Positive` ou `Inconclusive`. As atualizações de correspondências disparam um webhook `data.updated`, mas não recalculam o status AML. Defina o status final pelo endpoint de status AML ou pela revisão no console. | | `COULD_NOT_PERFORM_AML_SCREENING` | Falta no registro KYC um ou mais destes campos: `full_name`, `date_of_birth` ou `issuing_state`. Nenhuma chamada de análise faturável é feita. | `warning` | Força `In Review`. | Preencha os campos ausentes no registro KYC. A análise AML é executada novamente de forma automática assim que os três campos estiverem presentes: o registro de aviso desatualizado é removido e não é preciso acioná-la novamente de forma manual. | Os avisos são armazenados com `feature: "AML"` e seguem o formato padrão do [objeto de aviso](https://docs.didit.me/pt-br/reference/data-models.md#objeto-de-aviso). ## Configurações ajustáveis Controles AML por nó do fluxo (também aceitos como opções na API AML independente): * **`aml_score_approve_threshold`**: padrão `80`. Uma pontuação diferente de zero acima dele produz `POSSIBLE_MATCH_FOUND` e encaminha a verificação AML para `In Review`. Pontuações iguais ou inferiores a ele **não** produzem o aviso em fluxos de sessão, independentemente do número de correspondências. * **`aml_score_review_threshold`**: padrão `100`. Uma pontuação acima dele recusa automaticamente a verificação AML (com o padrão de `100`, isso nunca acontece até que você o reduza). * **`aml_match_score_threshold`**: padrão `93`. Classificação por correspondência: correspondências com `match_score` abaixo dele começam como `False Positive` e são excluídas da pontuação agregada; iguais ou acima dele, começam como `Unreviewed`. * **Pesos da pontuação de correspondência**: `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, padrões `60` / `25` / `15` (a soma deve ser 100). Consulte [pontuação de correspondência AML](https://docs.didit.me/pt-br/core-technology/aml-screening/aml-match-score.md). * **Monitoramento contínuo**: quando ativado, a análise AML reavalia o titular à medida que as bases de dados mudam e emite novamente o relatório, além de um webhook `status.updated` (status alterado) ou `data.updated` (correspondências alteradas). > [!NOTE] > > Quando `COULD_NOT_PERFORM_AML_SCREENING` é disparado, a verificação AML permanece em `In Review` até que os campos de identidade ausentes sejam fornecidos. Assim que a Didit tiver o nome completo, a data de nascimento e o estado emissor, a análise AML é executada novamente de forma automática e o aviso desaparece. Não há novo acionamento manual. ## 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 KYC ausentes) ```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" } ] } ``` ## Relacionados * [Relatório AML](https://docs.didit.me/pt-br/core-technology/aml-screening/report-aml-screening.md): formato completo da resposta, campos das correspondências, semântica dos status * [Pontuação de risco AML](https://docs.didit.me/pt-br/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-br/core-technology/aml-screening/aml-match-score.md): confiança por correspondência * [Monitoramento AML contínuo](https://docs.didit.me/pt-br/core-technology/aml-screening/continuous-monitoring-aml-screening.md): ciclo de vida do monitoramento * [Modelos de dados: triagem AML](https://docs.didit.me/pt-br/reference/data-models.md#análise-aml): esquema canônico, incluindo o [objeto de aviso](https://docs.didit.me/pt-br/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.