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

# Validação de base de dados: correspondência 1x1 e 2x2

> A Didit obtém resultados 1x1 e 2x2 através de limiares de nomes, regras partialMatchAction e lógica em cascata. Desde $0.05/check.

A API de [Validação de base de dados](https://docs.didit.me/pt/core-technology/database-validation/overview.md) da Didit compara dados de identidade com o registo civil oficial, a autoridade tributária oficial ou o caderno eleitoral oficial de cada país — RENAPER (Argentina), Receita Federal (Brasil), Tribunal Electoral (Panamá), RENAPO (México), Junta Central Electoral (República Dominicana), Registraduría Nacional (Colômbia) e outros. Cada consulta é faturada por chamada bem-sucedida, a partir de **\$0.05/verificação** sem consumos mínimos mensais.

Os resultados derivam de apuramentos por serviço: **1×1** quando um único registo devolve uma correspondência total, **2×2** quando dois registos independentes corroboram os dados. Esta página documenta a forma como esses resultados são calculados, os limiares de correspondência difusa aplicados a nomes e a lógica de decisão que rege `partialMatchAction` e `noMatchAction` nas regras do seu fluxo.

## Correspondência 1×1

Este método envolve a correspondência de um dado de entrada (normalmente um identificador nacional ou semelhante) com a nossa base de dados. Se for encontrada uma correspondência direta, confirmamos a identidade. No entanto, se a tentativa inicial falhar, podemos recorrer a fontes de dados fidedignas alternativas numa sequência em cascata. Isto significa que continuamos a validação através de fornecedores sucessivos até obtermos uma correspondência ou esgotarmos todas as opções. Importa salientar que uma correspondência parcial não interrompe o processo — apenas paramos quando encontramos uma correspondência total e conclusiva ou quando determinamos que não existe qualquer correspondência.

A lógica de Correspondência 1x1 exige a correspondência dos dados pessoais de um utilizador com uma fonte para obter uma Correspondência total na sua identidade.\*

| Resultado da verificação | Categoria do nome | Categoria do ID | Categoria da data de nascimento |
| :- | :- | :- | :- |
| Correspondência total | Correspondência total | Correspondência total | Qualquer valor |
| Correspondência parcial | Correspondência parcial | Correspondência total | Qualquer valor |
| Sem correspondência | Todas as outras combinações | | |

*\*As fontes aplicáveis do país são consultadas até se obter uma correspondência total na identidade. Se não for encontrada uma correspondência total, o sistema consulta repetidamente essas fontes em busca de uma correspondência parcial na identidade do utilizador.*

> [!NOTE]
>
> A tabela 1×1 acima e a tabela 2×2 abaixo descrevem o modelo geral, não constituindo uma garantia válida para todos os serviços. Os campos decisivos variam consoante o serviço e os dados de entrada opcionais enviados: um registo só pode comparar os campos de que dispõe e os campos fornecidos, e o resultado de um serviço é determinado pelos campos que este efetivamente compara. Nem todos os serviços comparam o número de identificação, e alguns só o comparam quando este é enviado. Por exemplo, [Espanha - Verificação de DNI/NIE](https://docs.didit.me/pt/api-reference/database-validation/spain/dni.md) (`esp_dni`) exige nome, data de nascimento e morada, aceitando `national_id` como dado de entrada opcional. Este compara sempre o nome, a data de nascimento e a morada, comparando também o número de identificação quando `national_id` é enviado.
>
> Um campo obrigatório não é necessariamente um campo decisivo, enquanto um campo opcional pode sê-lo. Um campo obrigatório tem de ser enviado para que o pedido seja aceite, e um campo listado em `source_data` é um dado devolvido pelo registo. Nenhum deles indica quais os campos que determinaram o resultado. Os exemplos de resposta na página de cada serviço ilustram uma resposta possível, pelo que as chaves do respetivo objeto `validation` não representam uma lista exaustiva dos campos comparados por esse serviço. A página de referência da API de cada serviço, listada em [Países e serviços suportados](https://docs.didit.me/pt/core-technology/database-validation/database-validation-supported-countries.md), detalha os dados de entrada obrigatórios e opcionais na secção **Entradas**.

## Correspondência 2×2

Este método requer a correspondência de dois pontos de dados de entrada (por exemplo, nome + data de nascimento, ou documento de identificação nacional + número de telefone) com dois campos correspondentes na nossa base de dados. Tal como no 1x1, seguimos uma abordagem em cascata, consultando múltiplas fontes de dados sequencialmente. Persistimos em cada passo até encontrarmos uma correspondência completa em ambos os campos de dados. As correspondências parciais ou de campo único não são suficientes; o processo de validação continua até que seja alcançada uma correspondência definitiva de 2 campos ou que todas as fontes tenham sido verificadas.

A lógica de correspondência 2x2 requer a correspondência dos dados pessoais de um utilizador com duas fontes para receber uma Correspondência total na sua identidade.\*

| Resultado da verificação | 1.ª fonte de dados | 2.ª fonte de dados |
| :- | :- | :- |
| Correspondência total | Nome Correspondência total + Documento de identificação nacional Correspondência total | Nome Correspondência total + Documento de identificação nacional Correspondência total |
| Correspondência total | Nome Correspondência total + Documento de identificação nacional Correspondência total | Nome Correspondência parcial + Documento de identificação nacional Correspondência total |
| Correspondência total | Nome Correspondência total + Documento de identificação nacional Correspondência total | Nome Correspondência total + Data de nascimento Correspondência total |
| Correspondência total | Nome Correspondência total + Documento de identificação nacional Qualquer valor | Nome Correspondência total + Documento de identificação nacional Qualquer valor |
| Correspondência parcial | Nome Correspondência total + Documento de identificação nacional Correspondência total | |
| Correspondência parcial | Nome Correspondência parcial + Documento de identificação nacional Correspondência total | |
| Correspondência parcial | Nome Correspondência total + Data de nascimento Correspondência total | |
| Correspondência parcial | Nome Correspondência total + Identificação nacional (qualquer valor) | |
| Sem correspondência | Todas as outras combinações | |

*\*As fontes aplicáveis do país são consultadas até que seja obtida uma Correspondência total da identidade. Se não for encontrada uma Correspondência total, o sistema consulta repetidamente essas fontes em busca de uma Correspondência parcial da identidade do utilizador.*

***

## Correspondência de categorias de dados e atributos

Apresentam-se a seguir os cenários que resultam numa Correspondência total para as categorias de dados Nome, Data de nascimento e ID. Uma Correspondência parcial apenas é possível para a categoria Nome.

### Correspondência da categoria Nome

Considera-se uma **Correspondência total** na categoria Nome quando qualquer um dos seguintes cenários de correspondência de atributos de dados é cumprido:

* Concatenação de nome completo Correspondência total (Primeiro nome + Último nome combinados com um limiar de semelhança de 85%)
* Primeiro nome Correspondência total + Último nome Correspondência total
* Primeiro nome Correspondência total + Nome materno Correspondência total
* Primeiro nome Correspondência total + Nome paterno Correspondência total

Considera-se uma **Correspondência parcial** na categoria Nome quando qualquer um dos seguintes cenários de correspondência de atributos de dados é cumprido:

* Primeiro nome Correspondência total
* Último nome Correspondência total
* Nome paterno Correspondência total
* Nome materno Correspondência total
* Nome materno Correspondência total + Nome paterno Correspondência total

### Correspondência da categoria Data de nascimento

Considera-se uma **Correspondência total** na categoria Data de nascimento apenas quando o seguinte cenário de correspondência de atributos de dados é cumprido:

* Ano de nascimento Correspondência total + Mês de nascimento Correspondência total + Dia de nascimento Correspondência total

Não é possível obter uma Correspondência parcial na categoria Data de nascimento.

### Correspondência da categoria ID

Considera-se uma **Correspondência total** na categoria ID apenas quando o seguinte cenário de correspondência de atributos de dados é cumprido:

* Número de identificação Correspondência total

Não é possível obter uma Correspondência parcial na categoria ID.

A categoria ID apenas conta quando o serviço compara o número de identificação. Alguns serviços nunca o comparam e outros apenas o comparam quando o envia como entrada.

***

## Correspondência aproximada para atributos de dados

Estes são os critérios para a correspondência aproximada em diferentes atributos de dados em comparação com as fontes por país.

* **Atributos de dados de nome**
  Para que um atributo de dados da categoria Nome gere uma Correspondência total, deve apresentar pelo menos 70% de semelhança de caracteres de Levenshtein em comparação com os registos nas fontes de dados. Para a concatenação do nome completo (Primeiro nome + Apelido combinados), é utilizado um limiar de semelhança mais elevado de 85%. Por exemplo, se a entrada do atributo de Nome for 'Christophel' e o nome real for 'Christopher', é devolvida uma Correspondência total com base na lógica de correspondência aproximada. Este sistema aplica-se aos atributos de dados *Primeiro nome*, *Apelido*, *Nome paterno* e *Nome materno*.

* **Atributos de dados de data de nascimento e ID**
  Não aplicamos qualquer tipo de correspondência aproximada a atributos de dados das categorias de Data de nascimento ou ID. É necessária uma correspondência exata para estes campos.

### Exemplos

Abaixo encontram-se exemplos de entradas de atributos de dados que cumpririam os critérios da lógica de correspondência aproximada e gerariam uma Correspondência total.

| Atributo de dados | Entrada | Registo da fonte de dados | Resultado |
| :- | :- | :- | :- |
| first\_name | Christopher | Christopher | Correspondência total |
| first\_name | Christophel | Christopher | Correspondência total |
| first\_name | Chris | Christopher | Sem correspondência |
| last\_name | Smith | Smith | Correspondência total |
| last\_name | Smyth | Smith | Correspondência total |
| last\_name | Smitty | Smith | Sem correspondência |

## Ver também

* [Visão geral da Validação de base de dados](https://docs.didit.me/pt/core-technology/database-validation/overview.md) — como funciona a API de ponta a ponta, registos suportados, preços.
* [Códigos de resultado](https://docs.didit.me/pt/core-technology/database-validation/database-validation-outcome-codes.md) — lista completa dos códigos de resposta dos fornecedores (falecido, menor, documento não encontrado, divergência biométrica).
* [Avisos](https://docs.didit.me/pt/core-technology/database-validation/database-validation-warnings.md) — o que apresentamos quando um serviço não pode ser executado devido a dados de entrada em falta.
* [Países e serviços suportados](https://docs.didit.me/pt/core-technology/database-validation/database-validation-supported-countries.md) — todos os registos disponíveis em produção, campos obrigatórios e preço por chamada.
* [Relatórios](https://docs.didit.me/pt/core-technology/database-validation/database-validation-report.md) — exportações mensais de faturação por serviço.


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