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

# Pontuação de correspondência AML: fórmula de confiança

> A Didit mede a confiança de identidade por nome, data de nascimento e país na triagem AML, ajustando limiares para reduzir falsos positivos.

A **Pontuação de correspondência** é uma métrica de confiança ponderada que determina **o grau de correspondência entre uma potencial correspondência AML e o indivíduo analisado**. Esta pontuação é utilizada para classificar correspondências individuais como **Falsos positivos** ou **Possíveis correspondências** que requerem uma análise posterior.

![Configuração da pontuação de correspondência AML da Didit mostrando limiares ponderados de nome, data de nascimento e país](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-match-score-config.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=76d3124f99349a81e16e711f3d2816e6)

> ⚠️ **Importante:** A pontuação de correspondência determina a **classificação das correspondências individuais**, e NÃO o estado final de AML. O estado final de AML (Aprovada/Em análise/Recusada) é determinado pela [Pontuação de risco](https://docs.didit.me/pt/core-technology/aml-screening/aml-risk-score.md) das correspondências que não sejam falsos positivos.

## Visão geral

Ao analisar uma pessoa em listas de vigilância AML, cada potencial correspondência recebe uma **pontuação de correspondência de 0 a 100**. Esta pontuação responde à pergunta: **"Esta correspondência é efetivamente a mesma pessoa que estamos a analisar?"**

### Pontuação de correspondência vs Pontuação de risco

| Aspeto | Pontuação de correspondência | Pontuação de risco |
| - | - | - |
| **Pergunta** | É a mesma pessoa? | Quão arriscada é esta entidade? |
| **Finalidade** | Classificar correspondências como Falso positivo vs Possível correspondência | Determinar o estado final de AML |
| **Fatores** | Nome, Data de nascimento, País, Número de documento | País, Categoria, Registos criminais |
| **Limiar** | Limiar de pontuação de correspondência (padrão: 93) | Limiar de aprovação / Limiar de revisão |

***

## Como a pontuação de correspondência determina o estado de revisão

Cada correspondência é classificada com base na sua pontuação de correspondência:

| Pontuação de correspondência | Estado de revisão | Significado |
| - | - | - |
| Pontuação abaixo do Limiar de pontuação de correspondência | **Falso positivo** | É provável que a correspondência NÃO seja a mesma pessoa |
| Pontuação igual ou superior ao Limiar de pontuação de correspondência | **Não revisto** | A correspondência requer revisão manual |

> **Limiar padrão:** 93%

**Exemplo:** Com um limiar de 93:

* Correspondência com pontuação 85 → **Falso positivo** (descartada automaticamente)
* Correspondência com pontuação 95 → **Não revisto** (necessita de revisão, a pontuação de risco determina a urgência)

### Estados de revisão explicados

Todas as correspondências AML começam com um de dois estados iniciais com base na sua pontuação de correspondência:

| Estado | Descrição | Quando é definido |
| - | - | - |
| **Falso positivo** | É provável que a correspondência NÃO seja a mesma pessoa analisada. Excluída da avaliação de risco. | Pontuação de correspondência \< limiar |
| **Não revisto** | A correspondência é uma correspondência potencial que requer revisão manual para confirmar ou descartar. | Pontuação de correspondência ≥ limiar |

Após a revisão manual, os responsáveis pela conformidade podem atualizar o estado para:

| Estado | Descrição |
| - | - |
| **Correspondência confirmada** | A correspondência foi verificada como sendo a mesma pessoa. |
| **Inconclusivo** | Não foi possível determinar se a correspondência é a mesma pessoa. |

> [!NOTE]
>
> ### **Dica:** Pode alterar o estado de revisão de uma correspondência na Consola ao consultar a visão geral de AML ou ao clicar numa correspondência específica para ver os seus detalhes.

***

## Como a pontuação de correspondência é calculada

### Passo 1: Cálculo da pontuação base

A pontuação base é calculada através de três componentes com pesos configuráveis:

```
Base Score = (Name Score × Name Weight) + (DOB Score × DOB Weight) + (Country Score × Country Weight)
```

| Componente | Peso padrão | Descrição |
| - | - | - |
| **Nome** | 60% | Semelhança textual aproximada entre o nome analisado e o nome da correspondência |
| **Data de Nascimento** | 25% | Pontuação exata, parcial (apenas ano) ou de não correspondência |
| **País/Nacionalidade** | 15% | Comparação entre a nacionalidade analisada e os países da correspondência |

> **Nota:** A soma dos pesos deve ser sempre 100%.

### Passo 2: Lógica "Golden Key" do número de documento

Após o cálculo da pontuação base, o número de documento é avaliado separadamente através de uma lógica especial de substituição:

| Cenário | Efeito | Exemplo |
| - | - | - |
| **Correspondência** | Substitui a pontuação por **100** | Os números de passaporte coincidem exatamente |
| **Neutro** | Mantém a pontuação base inalterada | Tipos de documento diferentes, ou um dos documentos em falta |
| **Divergência grave** | Aplica penalização (-50 pontos) | O mesmo tipo de documento mas valores diferentes |

Esta abordagem reconhece que um número de documento coincidente é uma prova definitiva de identidade (a "Golden Key"), enquanto tipos de documentos diferentes não devem penalizar a pontuação.

***

## Detalhes da pontuação dos componentes

### Semelhança de nome (0-100)

A correspondência de nomes utiliza o **algoritmo WRatio** da RapidFuzz, que é robusto contra:

* Erros tipográficos e de ortografia
* Diferenças na ordem das palavras ("John Smith" vs "Smith, John")
* Variações no segundo nome ("Robert J. Smith" vs "Robert James Smith")
* Diferenças de comprimento

### Pontuação da data de nascimento

| Cenário | Pontuação | Exemplo |
| - | - | - |
| **Correspondência exata** | 100% | "1985-03-15" corresponde a "1985-03-15" |
| **Correspondência de ano (a correspondência tem apenas o ano)** | 100% | "1985-03-15" corresponde a "1985" — correspondência total porque a correspondência apenas fornece precisão ao nível do ano |
| **Correspondência de ano (dia/mês diferente)** | 50% | "1985-03-15" corresponde a "1985-06-20" — mesmo ano, mas datas diferentes |
| **Divergência de ano** | -100% (penalização) | "1985-03-15" não corresponde a "1990-03-15" |
| **Sem dados** | 0% (neutro) | Ausência de data de nascimento em qualquer um dos lados |

> **Importante:** Quando a correspondência apenas fornece um ano (por exemplo, "1974"), a correspondência desse ano conta como uma **correspondência total**, pois essa é toda a informação disponível para verificar.

### Pontuação de país/nacionalidade

| Cenário | Pontuação | Exemplo |
| - | - | - |
| **Correspondência exata** | 100% | "ES" corresponde a "Spain" ou "ESP" |
| **Sem dados na correspondência** | 0% (neutro) | A correspondência não tem informação de país |
| **Divergência** | -50% (penalização) | "ES" não corresponde a "France" |

O sistema converte automaticamente entre:

* Códigos ISO alfa-2 (ES)
* Códigos ISO alfa-3 (ESP)
* Nomes completos de países (Spain)

Também verifica o campo `citizenship` além de `countries`.

***

## Normalização de pontuação (reponderação)

Quando faltam dados da pessoa avaliada ou da correspondência, o sistema utiliza a **normalização de pontuação** para evitar penalizações por informações indisponíveis.

### Exemplo: triagem apenas por nome

Se realizar uma triagem apenas com um nome (sem data de nascimento ou país):

| Pesos originais | Pesos normalizados |
| - | - |
| Nome: 60% | Nome: **100%** |
| Data de nascimento: 25% | Data de nascimento: 0% (não comparável) |
| País: 15% | País: 0% (não comparável) |

**Resultado:** A pontuação do nome passa a ser a totalidade da pontuação de correspondência.

### Exemplo: país em falta na correspondência

Se a correspondência não tiver dados de país, mas tiver data de nascimento:

| Pesos originais | Pesos normalizados |
| - | - |
| Nome: 60% | Nome: **70.6%** |
| Data de nascimento: 25% | Data de nascimento: **29.4%** |
| País: 15% | País: 0% (não comparável) |

Isto garante uma pontuação justa, independentemente da disponibilidade de dados.

***

## Opções de configuração

Pode personalizar o cálculo da pontuação de correspondência através da API ou das definições do fluxo:

### Limiar da pontuação de correspondência

| Definição | Predefinição | Descrição |
| - | - | - |
| Limiar da pontuação de correspondência | 93 | As correspondências abaixo deste valor são classificadas como **Falso positivo**. As correspondências com esse valor ou acima dele são classificadas como **Não revistas** (Possíveis correspondências) que necessitam de revisão. |

### Pesos (a soma deve ser 100)

| Definição | Predefinição | Descrição |
| - | - | - |
| Peso do nome | 60 | Peso para a semelhança de nome (0-100) |
| Peso da data de nascimento | 25 | Peso para a data de nascimento (0-100) |
| Peso do país | 15 | Peso para o país/nacionalidade (0-100) |

***

## Exemplo de pedido de API

```json theme={null}
{
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "nationality": "USA",
  "document_number": "SAMPLE-DOC-12345",
  "aml_name_weight": 60,
  "aml_dob_weight": 25,
  "aml_country_weight": 15,
  "aml_match_score_threshold": 93
}
```

***

## Resposta: detalhe da pontuação

Cada correspondência na resposta inclui:

* `match_score` — A pontuação de correspondência calculada (0-100)
* `risk_score` — A pontuação de risco calculada (0-100) - ver [Pontuação de risco](https://docs.didit.me/pt/core-technology/aml-screening/aml-risk-score.md)
* `review_status` — "Falso positivo" ou "Não revisto" com base no limiar da pontuação de correspondência
* `score_breakdown` — Detalhe minucioso do cálculo da pontuação de correspondência

```json theme={null}
{
  "caption": "David Sanchez",
  "match_score": 95,
  "risk_score": 65.5,
  "review_status": "Unreviewed",
  "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": 95
  }
}
```

***

## Fluxo completo: da pontuação de correspondência ao estado final de AML

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           AML SCREENING FLOW                                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. RETRIEVE MATCHES FROM WATCHLISTS                                        │
│     └── All matches with score ≥ 75% are included                           │
│                                                                             │
│  2. CALCULATE MATCH SCORE FOR EACH MATCH                                    │
│     Match Score = (Name × W1) + (DOB × W2) + (Country × W3)                │
│     + Golden Key document number logic                                      │
│                                                                             │
│  3. CLASSIFY MATCHES BY MATCH SCORE (Match Score Threshold = 93)           │
│     ├── Match Score < 93 → FALSE POSITIVE (excluded from risk assessment)  │
│     └── Match Score ≥ 93 → UNREVIEWED (included in risk assessment)        │
│                                                                             │
│  4. CALCULATE RISK SCORE FOR NON-FALSE-POSITIVE MATCHES                     │
│     Risk Score = (Country × 30%) + (Category × 50%) + (Criminal × 20%)     │
│                                                                             │
│  5. DETERMINE FINAL AML STATUS (based on highest risk score)               │
│     ├── Highest Risk Score < approve_threshold → APPROVED                   │
│     ├── Highest Risk Score ≤ review_threshold → IN REVIEW                   │
│     └── Highest Risk Score > review_threshold → DECLINED                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

***

## Exemplos de cálculo

### Exemplo 1: Correspondência forte → Não revista

**Dados analisados:**

* Nome: "Robert J. Smith"
* Data de nascimento: "1985-03-15"
* País: "US"

**Dados da correspondência:**

* Nome: "Robert James Smith"
* Data de nascimento: "1985"
* País: "United States"

**Cálculo:**

1. Pontuação do nome: 90% (correspondência aproximada)
2. Pontuação da data de nascimento: 100% (a correspondência tem apenas o ano, o ano coincide)
3. Pontuação do país: 100% (correspondência exata)

```
Match Score = (90 × 0.60) + (100 × 0.25) + (100 × 0.15)
            = 54 + 25 + 15
            = 94
```

**Resultado:** Pontuação de correspondência (94) ≥ limiar (93) → **Não revista**
→ A pontuação de risco será calculada e utilizada para o estado AML final

### Exemplo 2: Correspondência fraca → Falso positivo

**Dados analisados:**

* Nome: "John Smith"
* Data de nascimento: "1990-05-20"
* País: "US"

**Dados da correspondência:**

* Nome: "Johnny Smithson"
* Data de nascimento: "1975"
* País: "Canada"

**Cálculo:**

1. Pontuação do nome: 72% (correspondência aproximada fraca)
2. Pontuação da data de nascimento: -100% (penalização por ano não coincidente)
3. Pontuação do país: -50% (penalização por país não coincidente)

```
Match Score = (72 × 0.60) + (-100 × 0.25) + (-50 × 0.15)
            = 43.2 - 25 - 7.5
            = 10.7 → 11
```

**Resultado:** Pontuação de correspondência (11) \< limiar (93) → **Falso positivo**
→ Esta correspondência é excluída da avaliação de risco

### Exemplo 3: Substituição pela Golden Key

**Dados analisados:**

* Nome: "John D. Smith"
* Número do documento: "A12345678"

**Dados da correspondência:**

* Nome: "Jonathan David Smith"
* Número do documento: "A12345678"

**Cálculo:**

1. Pontuação base: \~70 (correspondência aproximada do nome)
2. Número do documento: **CORRESPONDÊNCIA** (correspondência exata)

**Resultado:** Pontuação substituída por **100** (correspondência Golden Key) → **Não revista**

***

## Gerir o estado de revisão

Após a classificação inicial, pode atualizar manualmente o estado de revisão de cada correspondência:

### Na consola

1. Aceda à visão geral de AML da sessão
2. Clique numa correspondência específica para ver os detalhes
3. Utilize o menu pendente de estado para alterar o estado de revisão:
   * **Correspondência confirmada** — Verificar se a correspondência corresponde à mesma pessoa
   * **Falso positivo** — Marcar a correspondência como não coincidente
   * **Inconclusivo** — Impossível determinar

***

## Boas práticas

1. **Comece com o limiar predefinido (93)** — Proporciona um bom equilíbrio entre identificar correspondências reais e filtrar falsos positivos.

2. **Reduza o limiar para cenários de alto risco** — Se necessitar de maior cautela, reduza o limiar da pontuação de correspondência para capturar mais potenciais correspondências.

3. **Utilize números de documento sempre que disponíveis** — Fornecem a confirmação de identidade mais sólida e podem sobrepor-se a pontuações de correspondência baixas.

4. **Reveja os pesos normalizados** — Verifique os campos de peso normalizado no detalhe da pontuação para compreender como os dados em falta afetaram a pontuação.

5. **Monitorize as taxas de falsos positivos** — Se demasiadas correspondências legítimas estiverem a ser marcadas como falsos positivos, reduza o limiar.


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