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.*
*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.
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 (
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, 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.*
*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
- 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
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
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.Ver também
- Visão geral da Validação de base de dados — como funciona a API de ponta a ponta, registos suportados, preços.
- Códigos de resultado — lista completa dos códigos de resposta dos fornecedores (falecido, menor, documento não encontrado, divergência biométrica).
- Avisos — 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 — todos os registos disponíveis em produção, campos obrigatórios e preço por chamada.
- Relatórios — exportações mensais de faturação por serviço.