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

# Validació en bases de dades: mètodes 1x1 i 2x2

> Com Didit obté resultats 1x1 i 2x2: llindars de nom difús, regles partialMatchAction i lògica en cascada. Des de $0.05/check.

L'API de [Validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md) de Didit comprova les dades d'identitat amb el registre civil, l'autoritat tributària o el cens electoral oficials de cada país —RENAPER (Argentina), Receita Federal (Brasil), Tribunal Electoral (Panamà), RENAPO (Mèxic), Junta Central Electoral (República Dominicana), Registraduría Nacional (Colòmbia) i més. Cada consulta es factura per crida satisfactòria, a partir de **\$0.05/comprovació** sense mínims mensuals.

Els resultats es deriven dels resultats per servei: **1×1** quan un únic registre retorna una coincidència total, **2×2** quan dos registres independents corroboren les dades. Aquesta pàgina documenta com es calculen aquests resultats, els llindars de coincidència difusa aplicats als noms i la lògica de decisió que regeix `partialMatchAction` i `noMatchAction` a les teves regles del flux de treball.

## Coincidència 1×1

Aquest mètode consisteix a comparar una dada d'entrada (normalment un document d'identitat nacional o un identificador similar) amb la nostra base de dades. Si es troba una coincidència directa, confirmem la identitat. No obstant això, si l'intent inicial falla, podem provar fonts de dades de confiança alternatives en una seqüència en cascada. Això significa que continuem validant a través de proveïdors successius fins que aconseguim una coincidència o bé esgotem totes les opcions. És important destacar que una coincidència parcial no atura el procés: només ens aturem un cop trobem una coincidència total i concloent o determinem que no hi ha cap coincidència.

La lògica de coincidència 1×1 requereix comparar les dades personals d'un usuari amb una font per rebre una Coincidència total en la seva identitat.\*

| Resultat de la verificació | Categoria del nom | Categoria de l'ID | Categoria de la data de naixement |
| :- | :- | :- | :- |
| Coincidència total | Coincidència total | Coincidència total | Qualsevol valor |
| Coincidència parcial | Coincidència parcial | Coincidència total | Qualsevol valor |
| Sense coincidència | Tota la resta de combinacions | | |

*\*S'analitzen les fonts aplicables del país fins que s'obté una coincidència total de la identitat. Si no es troba una coincidència total, el sistema analitza repetidament aquestes fonts per cercar una coincidència parcial de la identitat de l'usuari.*

> [!NOTE]
>
> La taula 1×1 anterior i la taula 2×2 següent descriuen el model general, no pas una garantia vàlida per a cada servei. Els camps decisius varien segons el servei i segons quines entrades opcionals enviïs: un registre només pot comparar els camps dels quals disposa i els camps que li proporciones, i el resultat d'un servei ve determinat pels camps que realment compara. No tots els serveis comparen el número d'identificació, i alguns només el comparen quan l'envies. Per exemple, [Espanya - Verificació de DNI/NIE](https://docs.didit.me/ca/api-reference/database-validation/spain/dni.md) (`esp_dni`) requereix nom, data de naixement i adreça, i accepta `national_id` com a entrada opcional. Sempre compara el nom, la data de naixement i l'adreça, i també compara el número d'identificació quan envies `national_id`.
>
> Un camp obligatori no és necessàriament decisiu, i un camp opcional ho pot ser. S'ha d'enviar un camp obligatori perquè s'accepti la sol·licitud, i les dades d'un camp que apareix a `source_data` són dades que el registre ha retornat. Cap dels dos casos t'indica quins camps han decidit el resultat. Els exemples de resposta a la pàgina de cada servei il·lustren una possible resposta, de manera que les claus del seu objecte `validation` no són una llista completa dels camps que aquest servei compara. La pàgina de referència de l'API de cada servei, llistada sota [Països i serveis admesos](https://docs.didit.me/ca/core-technology/database-validation/database-validation-supported-countries.md), detalla les seves entrades obligatòries i opcionals a **Entrades**.

## Coincidència 2×2

Aquest mètode requereix contrastar dues dades d'entrada (p. ex., nom + data de naixement, o document d'identitat nacional + número de telèfon) amb dos camps corresponents a la nostra base de dades. Igual que amb el mètode 1x1, seguim un enfocament en cascada consultant múltiples fonts de dades de manera seqüencial. Continuem amb cada pas fins a trobar una coincidència completa en tots dos camps de dades. Les coincidències parcials o d'un sol camp no són suficients; el procés de validació continua fins que s'obté una coincidència definitiva de 2 camps o s'han consultat totes les fonts.

La lògica de coincidència 2x2 requereix contrastar les dades personals d'un usuari amb dues fonts per rebre una Coincidència total en la seva identitat.\*

| Resultat de la verificació | 1a font de dades | 2a font de dades |
| :- | :- | :- |
| Coincidència total | Nom Coincidència total + Document d'identitat nacional Coincidència total | Nom Coincidència total + Document d'identitat nacional Coincidència total |
| Coincidència total | Nom Coincidència total + Document d'identitat nacional Coincidència total | Nom Coincidència parcial + Document d'identitat nacional Coincidència total |
| Coincidència total | Nom Coincidència total + Document d'identitat nacional Coincidència total | Nom Coincidència total + Data de naixement Coincidència total |
| Coincidència total | Nom Coincidència total + Document d'identitat nacional: qualsevol valor | Nom Coincidència total + Document d'identitat nacional: qualsevol valor |
| Coincidència parcial | Nom Coincidència total + Document d'identitat nacional Coincidència total | |
| Coincidència parcial | Nom Coincidència parcial + Document d'identitat nacional Coincidència total | |
| Coincidència parcial | Nom Coincidència total + Data de naixement Coincidència total | |
| Coincidència parcial | Nom Coincidència total + Document d'identitat nacional amb qualsevol valor | |
| Sense coincidència | Totes les altres combinacions | |

*\*Es consulten les fonts del país aplicables fins que s'obté una Coincidència total de la identitat. Si no es troba cap Coincidència total, el sistema torna a consultar repetidament aquestes fonts buscant una Coincidència parcial de la identitat de l'usuari.*

***

## Coincidència de categories de dades i atributs

A continuació es mostren els escenaris que donen lloc a una Coincidència total per a les categories de dades Nom, Data de naixement i ID. Una Coincidència parcial només és possible per a la categoria Nom.

### Coincidència de la categoria de nom

Es considera una **Coincidència total** en la categoria Nom quan es compleix qualsevol dels escenaris següents de coincidència d'atributs de dades:

* Concatenació de nom complet Coincidència total (Nom + Cognom combinats amb un llindar de similitud del 85%)
* Nom Coincidència total + Cognom Coincidència total
* Nom Coincidència total + Cognom matern Coincidència total
* Nom Coincidència total + Cognom patern Coincidència total

Es considera una **Coincidència parcial** en la categoria Nom quan es compleix qualsevol dels escenaris següents de coincidència d'atributs de dades:

* Nom Coincidència total
* Cognom Coincidència total
* Cognom patern Coincidència total
* Cognom matern Coincidència total
* Cognom matern Coincidència total + Cognom patern Coincidència total

### Coincidència de la categoria de data de naixement

Es considera una **Coincidència total** en la categoria Data de naixement només quan es compleix l'escenari següent de coincidència d'atributs de dades:

* Any de naixement Coincidència total + Mes de naixement Coincidència total + Dia de naixement Coincidència total

Una Coincidència parcial en la categoria Data de naixement no és possible.

### Coincidència de la categoria d'ID

Es considera una **Coincidència total** en la categoria ID només quan es compleix l'escenari següent de coincidència d'atributs de dades:

* Número d'identificació Coincidència total

Una Coincidència parcial en la categoria ID no és possible.

La categoria ID només compta quan el servei compara el número d'identificació. Alguns serveis no el comparen mai, i d'altres només el comparen quan l'envies com a dada d'entrada.

***

## Coincidència difusa per a atributs de dades

Aquests són els criteris de coincidència difusa per a diferents atributs de dades respecte a les fonts del país.

* **Atributs de dades de nom**
  Perquè un atribut de dades de la categoria Nom generi una Coincidència total, ha d'assolir almenys un 70% de similitud de caràcters segons Levenshtein en comparació amb els registres de les fonts de dades. Per a la concatenació del nom complet (nom de pila + cognom combinats), s'utilitza un llindar més alt del 85% de similitud. Per exemple, si l'entrada de l'atribut Nom és 'Christophel' i el nom real és 'Christopher', es retorna una Coincidència total segons la lògica de coincidència difusa. Aquest sistema s'aplica als atributs de dades *First Name*, *Last Name*, *Paternal Name* i *Maternal Name*.

* **Atributs de dades de data de naixement i document d'identitat**
  No apliquem cap mena de coincidència difusa als atributs de dades de les categories de data de naixement o document d'identitat. Es requereix una coincidència exacta per a aquests camps.

### Exemples

A continuació es mostren exemples d'entrades d'atributs de dades que complirien els criteris de la lògica de coincidència difusa i generarien una Coincidència total.

| Atribut de dades | Entrada | Registre de la font de dades | Resultat |
| :- | :- | :- | :- |
| first\_name | Christopher | Christopher | Coincidència total |
| first\_name | Christophel | Christopher | Coincidència total |
| first\_name | Chris | Christopher | Sense coincidència |
| last\_name | Smith | Smith | Coincidència total |
| last\_name | Smyth | Smith | Coincidència total |
| last\_name | Smitty | Smith | Sense coincidència |

## Vegeu també

* [Visió general de la Validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md) — com funciona l'API de principi a fi, registres admesos, preus.
* [Codis de resultat](https://docs.didit.me/ca/core-technology/database-validation/database-validation-outcome-codes.md) — llista completa de codis de resposta dels proveïdors (difunt, menor, document no trobat, discrepància biomètrica).
* [Advertències](https://docs.didit.me/ca/core-technology/database-validation/database-validation-warnings.md) — el que mostrem quan un servei no es pot executar a causa d'entrades que falten.
* [Països i serveis admesos](https://docs.didit.me/ca/core-technology/database-validation/database-validation-supported-countries.md) — tots els registres en producció, camps obligatoris i preu per crida.
* [Informes](https://docs.didit.me/ca/core-technology/database-validation/database-validation-report.md) — exportacions mensuals de facturació per servei.


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