Normalización de Datos Filiatorios con Distancia y Score

Normalización de Datos Filiatorios con Distancia y Score

Descripción General

Merlin con su módulo de validación de documentos permite contrastar los DNI/CUIT/CUIL contra la base de AFIP para confirmar que el DNI/CUIL/otro coincide con el Nombre/Apellido informado.

De esta manera se constata que los datos del registro informado son válidos y pertenecen a una persona cierta.

Este Normalizador permite las siguientes funcionalidades:

• Validación de tipo de documento.
• Validación de número de documento.
• Validación de Apellido y Nombre asociado.
• Asignación de Tipo de documento a partir del número de documento.
• Asignación de Apellido y Nombre a partir del número de documento.
• Asignación de CUIT a partir del número de documento.
• Asignación de Fecha de Nacimiento a partir del número de documento.
• Asignación de Sexo a partir del número de documento.

Consideraciones generales

El cliente debe enviar una estructura Nombre donde deberá completar al menos los campos:

  • documentNumber: con el DNI completo de la persona.
  • clientAccessCode: ID de acceso de cliente.

Estados para Datos Filiatorios

ValorDescripción
OKRegistro Validado
DURegistro que requiere Auditoria
NERegistro no Validado
ERRError en los datos ingresados

Motivos para Datos Filiatorios

ValorDescripción
SMSin Motivo

Valores Posibles para Comparación de Filiatorios

ValorSignificadoDescripción
VAVALIDADOEl valor de origen y destino son idénticos.
COCORREGIDOSe informó un valor en el origen, pero Merlin modifico el valor de la respuesta.
NVINVALIDOLos valores de origen y destino son diferentes y no se puede corregir.
APAPORTADONo se informó el valor de origen y Merlin aportó un valor a la respuesta.
NINO INFORMADONo se informo valor en el origen y Merlin no dispone de valor para aportar.
NANO APLICAEl flag no aplica por naturaleza del dato verificado, por ejemplo el sexo para una persona jurídica.

*Nota: NO = Este valor se aplica para los casos donde el documento es NO Encontrado.

Codificación Tipo Documento

ValorDescripción
30Certificado Migración
40Cédula Identidad Sudamericana
88Documento Extranjero
89Libreta Cívica
90Libreta Enrolamiento
91Cédula Id. Extranjera
92En Trámite
93DNRP
94Pasaporte
95Extranjero Indocumentado
96DNI
98DNI (número múltiple) es para casos de asignación de cuit/cdi en que existan
99Indeterminado
00 a 24Cedula de Identidad excepto 15

Atributos de Entrada

AtributoLongitud MáximaDescripción del atributo
clientAccessCode64Identificador único de usuarios. Este valor identifica y valida en cada invocación a un usuario determinado. Este valor tiene asociado los roles que le corresponden al usuario.
customAdapters64Adaptadores de respuesta/modificadores de comportamiento. Para más información ver «Adaptadores de respuesta».
documentType2Tipo Documento según codificación AFIP. Nulo para persona jurídica
documentNumber8Número de documento en caso de persona física. Obligatorio salvo que se informe el numero tributario.
tributaryType280=CUIT, 86=CUIL,87=CDI.
tributaryNumber11Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber.
lastNames64Apellido/s de la persona física.
names64Nombre/s de la persona física o denominación/razón social de la entidad.
gender1Sexo de la persona física.
birthDate10Fecha de nacimiento de la persona física.

Atributos de Salida

AtributoLongitud MáximaObservación
status3Indica el estado de normalización y/o validación. Para mas información ver el apartado «Estados y Motivos» al inicio de este documento.
statusReason2Indica la razón con referencia al estado de normalización y/o validación. Para mas información ver el apartado «Estados y Motivos» al inicio de este documento.
transactionId10Merlin asigna un id de transacción por consulta.
documentType2Tipo de documento en caso de tratarse de una persona física.
documentTypeFlg2Este valor expresa el resultado de la comparación entre el tipo de documento informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
documentNumber8Número de documento en caso de persona física. Obligatorio salvo que se informe el numero tributario.
documentNumberFlg2Este valor expresa el resultado de la comparación entre el número de documento y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
tributaryType280=CUIT, 86=CUIL,87=CDI.
tributaryTipeFlg2Este valor expresa el resultado de la comparación de tipo de id tributario informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
tributaryNumber11Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber.
tributaryNumberFlg2Este valor expresa el resultado de la comparación de número de id tributario informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
contributorType1Tipo de ID de contribuyente. Posibles valores: ‘ A ‘ aportante. No contribuyente ( no autónomo, no empleador, no monotributista ) ‘ C ‘ contribuyentes. Contribuyente ( autónomo y/o empleador y/o monotributista y sociedades ).
contributorTypeFlg2Este valor expresa el resultado de la comparación de número de id de contribuyente informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
lastNames64Apellido/s de la persona física.
lastNamesFlg2Este valor expresa el resultado de la comparación de apellido informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
names64Nombre/s de la persona física o denominación/razón social de la entidad.
namesFlg2Este valor expresa el resultado de la comparación de nombre/razón social informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
gender1Sexo de la persona física.
genderFlg2Este valor expresa el resultado de la comparación de sexo informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
birthDate10Fecha de nacimiento de la persona física. Fecha de constitución o alta para personas jurídicas.
birthDateFlg2Este valor expresa el resultado de la comparación de fecha de nacimiento informado y el existente en la base de contraste (Afip). Los valores posibles son: VA / CO / NV / AP / NI / NA
merlinCustomValues–Valores desarrollados por demanda del cliente o que se provee opcionalmente como el directory.
literalDistance6Indica el nivel de diferencia entre el Nombre y Apellido o denominación ingresado contra la base de contraste. Arroja parámetros entre 0 a 100, siendo 0 (Match Exacto) y 100(Mayor Distancia). Para esta validación es necesario tener informado el nombre y apellido, de informar todo en un solo campo el orden debe ser Apellido Nombre.
Sugerimos considerar la siguiente escala:
Datos Diferentes: Mayor a 35
Datos Para Auditar: Entre 20 a 35
Datos Similares o Iguales: Menor a 20
score9Indica el nivel de Relevancia entre el Nombre apellido o denominación, sexo y fecha de nacimiento ingresado contra la base de contraste. Arroja valor numérico decimal, teniendo en consideración que a mayor número, es mayor su relevancia en la base de datos personales. Para esta validación es necesario tener informado el nombre, apellido, sexo y fecha de nacimiento, de informar todo el nombre y apellido en un solo campo el orden debe ser Apellido Nombre.
Sugerimos considerar la siguiente escala:
Datos Poco Relevantes o Diferentes: Menor a 25
Datos Para Auditar: Entre 25 a 35
Datos Muy Relevantes, Similares o Iguales: Mayor a 35

Ejemplos de Distancia y Score

Ejemplo de caso con Distancia:
NombreApellidoliteralDistance
ManuelOrtiz de Rozas0
MamuelHortis de Rosas19.00
MaOrtis de Rosas29.00
MamuelRozas48.00
Para este caso se puede observar que mientras el nombre contiene mas errores o falta de palabras, mayor es la distancia.
Ejemplo de caso con Score:
NombreApellidoSexoFecha de Nacimientoscore
ManuelOrtiz de RozasMasculino01/09/197644.04058
ManuelOrtiz de RozasMasculino01/09/198643.048676
MamuelRozasMasculino01/09/197634.896515
JuanPerezMasculino01/09/198625.504192
Se puede observar que la variación o error en cualquier campo genera una alteración en el score y la relevancia que obtienen los datos de entrada, permitiendo verificar que los datos ingresados son altamente relevantes o similares (Caso 1 y 2), son datos para auditar (Caso 3) o son poco relevantes/diferentes (Caso 4).

Consideraciones Adicionales

Se pueden utilizar las variables de literalDistance y Score en conjunto para una mayor aceptación de diferencias, en donde toda distancia que se encuentre en los rangos para Auditar (entre 20 y 35) pero el score este en el rango de Altamente relevante o similar (Superior a 35) se puede considerar que el error obtenido en el nombre y apellido es menor y es la misma persona que se obtiene en la base de personas, De lo contrario se deberán auditar los datos de entrada.

Para ver más detalles de los WebServices:

Formato de mensajería JSON

Formato de mensajería SOAP