> ## 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. # Validazione su database: corrispondenza 1x1 e 2x2 > Didit calcola gli esiti 1x1 e 2x2: soglie fuzzy per nomi, regole partialMatchAction e logica waterfall. Da $0.05/controllo. L'API di [Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md) di Didit verifica i dati di identità confrontandoli con il registro civile ufficiale, l'autorità fiscale o le liste elettorali di ciascun paese: RENAPER (Argentina), Receita Federal (Brasile), Tribunal Electoral (Panama), RENAPO (Messico), Junta Central Electoral (Repubblica Dominicana), Registraduría Nacional (Colombia) e altri. Ogni query viene fatturata per chiamata riuscita, a partire da **\$0.05/check** senza minimi mensili. Gli esiti derivano dai risultati per singolo servizio: **1×1** quando un unico registro restituisce una corrispondenza completa, **2×2** quando due registri indipendenti confermano i dati. Questa pagina documenta come vengono calcolati tali esiti, le soglie di corrispondenza approssimata applicate ai nomi e la logica decisionale che regola `partialMatchAction` e `noMatchAction` nelle regole del tuo workflow. ## Corrispondenza 1×1 Questo metodo prevede il confronto di un dato di input (in genere un documento d'identità nazionale o un identificatore simile) con il nostro database. Se viene trovata una corrispondenza diretta, confermiamo l'identità. Tuttavia, se il tentativo iniziale fallisce, possiamo provare fonti di dati affidabili alternative in una sequenza a cascata. Ciò significa che continuiamo la validazione attraverso provider successivi fino a ottenere una corrispondenza o a esaurire tutte le opzioni. È importante sottolineare che una corrispondenza parziale non interrompe il processo: ci fermiamo solo quando troviamo una corrispondenza completa e conclusiva o stabiliamo che non esiste alcuna corrispondenza. La logica di corrispondenza 1×1 richiede il confronto dei dati personali di un utente con una fonte per ottenere una Corrispondenza completa sulla sua identità.\* | Risultato della verifica | Categoria nome | Categoria identificativo | Categoria data di nascita | | :- | :- | :- | :- | | Corrispondenza completa | Corrispondenza completa | Corrispondenza completa | Qualsiasi valore | | Corrispondenza parziale | Corrispondenza parziale | Corrispondenza completa | Qualsiasi valore | | Nessuna corrispondenza | Tutte le altre combinazioni | | | *\*Le fonti del paese applicabili vengono verificate fino a ottenere una corrispondenza completa sull'identità. Se non viene trovata una corrispondenza completa, il sistema verifica quindi ripetutamente tali fonti alla ricerca di una corrispondenza parziale sull'identità dell'utente.* > [!NOTE] > > La tabella 1×1 qui sopra e la tabella 2×2 qui sotto descrivono il modello generale, non una garanzia valida per ogni servizio. I campi determinanti variano in base al servizio e agli input opzionali inviati: un registro può confrontare solo i campi di cui dispone e i campi forniti, e l'esito di un servizio è determinato dai campi che esso effettivamente confronta. Non tutti i servizi confrontano il numero di identificazione, e alcuni lo confrontano solo quando viene inviato. Ad esempio, la [Spagna - Verifica DNI/NIE](https://docs.didit.me/it/api-reference/database-validation/spain/dni.md) (`esp_dni`) richiede nome, data di nascita e indirizzo, e accetta `national_id` come input opzionale. Confronta sempre nome, data di nascita e indirizzo, e confronta anche il numero di identificazione quando invii `national_id`. > > Un campo obbligatorio non è necessariamente determinante, mentre un campo opzionale può esserlo. Un campo obbligatorio deve essere inviato affinché la richiesta venga accettata, e un campo elencato in `source_data` è un dato restituito dal registro. Nessuno dei due indica quali campi abbiano determinato l'esito. Gli esempi di risposta nella pagina di ciascun servizio illustrano una risposta possibile, pertanto le chiavi del relativo oggetto `validation` non costituiscono un elenco completo dei campi confrontati dal servizio. La pagina di riferimento API di ciascun servizio, elencata in [Paesi e servizi supportati](https://docs.didit.me/it/core-technology/database-validation/database-validation-supported-countries.md), riporta i relativi input obbligatori e opzionali nella sezione **Input**. ## Corrispondenza 2×2 Questo metodo richiede il confronto di due elementi di dati in input (ad es. nome + data di nascita, o documento d'identità nazionale + numero di telefono) con due campi corrispondenti nel nostro database. Proprio come con il metodo 1×1, seguiamo un approccio a cascata, interrogando più fonti dati in sequenza. Proseguiamo attraverso ogni passaggio finché non troviamo una corrispondenza completa su entrambi i campi dati. Le corrispondenze parziali o su un singolo campo non sono sufficienti; il processo di validazione continua finché non viene ottenuta una corrispondenza definitiva su 2 campi o finché tutte le fonti non sono state verificate. La logica di corrispondenza 2×2 richiede il confronto dei dati personali di un utente con due fonti per ottenere una Corrispondenza completa sulla sua identità.\* | Risultato della verifica | 1ª fonte dati | 2ª fonte dati | | :- | :- | :- | | Corrispondenza completa | Nome Corrispondenza completa + Documento d'identità nazionale Corrispondenza completa | Nome Corrispondenza completa + Documento d'identità nazionale Corrispondenza completa | | Corrispondenza completa | Nome Corrispondenza completa + Documento d'identità nazionale Corrispondenza completa | Nome Corrispondenza parziale + Documento d'identità nazionale Corrispondenza completa | | Corrispondenza completa | Nome Corrispondenza completa + Documento d'identità nazionale Corrispondenza completa | Nome Corrispondenza completa + Data di nascita Corrispondenza completa | | Corrispondenza completa | Nome Corrispondenza completa + Documento d'identità nazionale: qualsiasi valore | Nome Corrispondenza completa + Documento d'identità nazionale: qualsiasi valore | | Corrispondenza parziale | Nome Corrispondenza completa + Documento d'identità nazionale Corrispondenza completa | | | Corrispondenza parziale | Nome Corrispondenza parziale + Documento d'identità nazionale Corrispondenza completa | | | Corrispondenza parziale | Nome Corrispondenza esatta + Data di nascita Corrispondenza esatta | | | Corrispondenza parziale | Nome Corrispondenza esatta + ID nazionale con qualsiasi valore | | | Nessuna corrispondenza | Tutte le altre combinazioni | | *\*Le fonti applicabili del paese vengono sottoposte a screening finché non viene ottenuta una Corrispondenza esatta sull'identità. Se non viene trovata una Corrispondenza esatta, il sistema sottopone quindi ripetutamente a screening tali fonti alla ricerca di una Corrispondenza parziale sull'identità dell'utente.* *** ## Corrispondenza delle categorie di dati e degli attributi Di seguito sono riportati gli scenari che determinano una Corrispondenza completa per le categorie di dati Nome, Data di nascita e ID. Una Corrispondenza parziale è possibile solo per la categoria Nome. ### Corrispondenza per la categoria Nome Una **Corrispondenza completa** per la categoria Nome si verifica quando viene soddisfatto uno dei seguenti scenari di corrispondenza degli attributi di dati: * Concatenazione del nome completo Corrispondenza completa (Nome + Cognome combinati con una soglia di somiglianza dell'85%) * Nome Corrispondenza completa + Cognome Corrispondenza completa * Nome Corrispondenza completa + Cognome materno Corrispondenza completa * Nome Corrispondenza completa + Cognome paterno Corrispondenza completa Una **Corrispondenza parziale** per la categoria Nome si verifica quando viene soddisfatto uno dei seguenti scenari di corrispondenza degli attributi di dati: * Nome Corrispondenza completa * Cognome Corrispondenza completa * Cognome paterno Corrispondenza completa * Cognome materno Corrispondenza completa * Cognome materno Corrispondenza completa + Cognome paterno Corrispondenza completa ### Corrispondenza per la categoria Data di nascita Una **Corrispondenza completa** per la categoria Data di nascita si verifica solo quando viene soddisfatto il seguente scenario di corrispondenza degli attributi di dati: * Anno di nascita Corrispondenza completa + Mese di nascita Corrispondenza completa + Giorno di nascita Corrispondenza completa Una Corrispondenza parziale per la categoria Data di nascita non è possibile. ### Corrispondenza per la categoria ID Una **Corrispondenza completa** per la categoria ID si verifica solo quando viene soddisfatto il seguente scenario di corrispondenza degli attributi di dati: * Numero identificativo Corrispondenza completa Una Corrispondenza parziale per la categoria ID non è possibile. La categoria ID viene considerata solo quando il servizio confronta il numero identificativo. Alcuni servizi non lo confrontano mai, mentre altri lo confrontano solo quando lo invii come dato di input. ## Corrispondenza fuzzy per gli attributi dati Questi sono i criteri per la corrispondenza fuzzy sui diversi attributi dati rispetto alle fonti nazionali. * **Attributi dati del nome** Affinché un attributo dati della categoria Nome generi un Full Match, deve presentare una somiglianza tra caratteri secondo la distanza di Levenshtein pari ad almeno il 70% rispetto ai record presenti nelle fonti dati. Per la concatenazione del nome completo (First Name + Last Name combinati), viene utilizzata una soglia più elevata di somiglianza dell'85%. Ad esempio, se l'input dell'attributo Nome è 'Christophel' e il nome effettivo è 'Christopher', viene restituito un Full Match in base alla logica di corrispondenza fuzzy. Questo sistema è applicabile agli attributi dati *First Name*, *Last Name*, *Paternal Name* e *Maternal Name*. * **Attributi dati relativi a data di nascita e ID** Non applichiamo alcun tipo di corrispondenza fuzzy agli attributi dati all'interno delle categorie di dati relative alla data di nascita o all'ID. Per questi campi è richiesta una corrispondenza esatta. ### Esempi Di seguito sono riportati alcuni esempi di input di attributi dati che soddisfano i criteri della logica di corrispondenza fuzzy e generano un Full Match. | Attributo dati | Input | Record della fonte dati | Risultato | | :- | :- | :- | :- | | first\_name | Christopher | Christopher | Full Match | | first\_name | Christophel | Christopher | Full Match | | first\_name | Chris | Christopher | No Match | | last\_name | Smith | Smith | Full Match | | last\_name | Smyth | Smith | Full Match | | last\_name | Smitty | Smith | No Match | ## Vedi anche * [Panoramica sulla validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md) — come funziona l'API end-to-end, registri supportati, prezzi. * [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md) — elenco completo dei codici di risposta dei provider (deceduto, minorenne, documento non trovato, mancata corrispondenza biometrica). * [Avvisi](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) — cosa mostriamo quando un servizio non può essere eseguito a causa di input mancanti. * [Paesi e servizi supportati](https://docs.didit.me/it/core-technology/database-validation/database-validation-supported-countries.md) — tutti i registri attivi, campi obbligatori e prezzo per chiamata. * [Report](https://docs.didit.me/it/core-technology/database-validation/database-validation-report.md) — esportazioni mensili di fatturazione per servizio. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.