Normalización de Datos Filiatorios
Normalización de Datos Filiatorios
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
| Valor | Descripción |
| OK | Registro Validado |
| DU | Registro que requiere Auditoria |
| NE | Registro no Validado |
| ERR | Error en los datos ingresados |
Motivos para Datos Filiatorios
| Valor | Descripción |
| SM | Sin Motivo |
Valores Posibles para Comparación de Filiatorios
| Valor | Significado | Descripción |
| VA | VALIDADO | El valor de origen y destino son idénticos. |
| CO | CORREGIDO | Se informó un valor en el origen, pero Merlin modifico el valor de la respuesta. |
| NV | INVALIDO | Los valores de origen y destino son diferentes y no se puede corregir. |
| AP | APORTADO | No se informó el valor de origen y Merlin aportó un valor a la respuesta. |
| NI | NO INFORMADO | No se informo valor en el origen y Merlin no dispone de valor para aportar. |
| NA | NO APLICA | El 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
| Valor | Descripción |
| 30 | Certificado Migración |
| 40 | Cédula Identidad Sudamericana |
| 88 | Documento Extranjero |
| 89 | Libreta Cívica |
| 90 | Libreta Enrolamiento |
| 91 | Cédula Id. Extranjera |
| 92 | En Trámite |
| 93 | DNRP |
| 94 | Pasaporte |
| 95 | Extranjero Indocumentado |
| 96 | DNI |
| 98 | DNI (número múltiple) es para casos de asignación de cuit/cdi en que existan |
| 99 | Indeterminado |
| 00 a 24 | Cedula de Identidad excepto 15 |
Atributos de Entrada
| Atributo | Longitud Máxima | Descripción del atributo |
| clientAccessCode | 64 | Identificador ú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. |
| customAdapters | 64 | Adaptadores de respuesta/modificadores de comportamiento. Para más información ver «Adaptadores de respuesta». |
| documentType | 2 | Tipo Documento según codificación AFIP. Nulo para persona jurídica |
| documentNumber | 8 | Número de documento en caso de persona física. Obligatorio salvo que se informe el numero tributario. |
| tributaryType | 2 | 80=CUIT, 86=CUIL,87=CDI. |
| tributaryNumber | 11 | Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber. |
| lastNames | 64 | Apellido/s de la persona física. |
| names | 64 | Nombre/s de la persona física o denominación/razón social de la entidad. |
| gender | 1 | Sexo de la persona física. |
| birthDate | 10 | Fecha de nacimiento de la persona física. |
Atributos de Salida
| Atributo | Longitud Máxima | Observación |
| status | 3 | Indica el estado de normalización y/o validación. Para mas información ver el apartado «Estados y Motivos» al inicio de este documento. |
| statusReason | 2 | Indica 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. |
| transactionId | 10 | Merlin asigna un id de transacción por consulta. |
| documentType | 2 | Tipo de documento en caso de tratarse de una persona física. |
| documentTypeFlg | 2 | Este 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 |
| documentNumber | 8 | Número de documento en caso de persona física. Obligatorio salvo que se informe el numero tributario. |
| documentNumberFlg | 2 | Este 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 |
| tributaryType | 2 | 80=CUIT, 86=CUIL,87=CDI. |
| tributaryTipeFlg | 2 | Este 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 |
| tributaryNumber | 11 | Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber. |
| tributaryNumberFlg | 2 | Este 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 |
| contributorType | 1 | Tipo 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 ). |
| contributorTypeFlg | 2 | Este 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 |
| lastNames | 64 | Apellido/s de la persona física. |
| lastNamesFlg | 2 | Este 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 |
| names | 64 | Nombre/s de la persona física o denominación/razón social de la entidad. |
| namesFlg | 2 | Este 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 |
| gender | 1 | Sexo de la persona física. |
| genderFlg | 2 | Este 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 |
| birthDate | 10 | Fecha de nacimiento de la persona física. Fecha de constitución o alta para personas jurídicas. |
| birthDateFlg | 2 | Este 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. |
| differenceLevelName | 4 | Indica el nivel de diferencia entre el Nombre y Apellido o denominación ingresado contra la base de contraste. Arroja parámetros entre 0 a 1, siendo 0 (Match Exacto) y 1(Mayor Distancia). Ejemplo: 0.60 |
Para ver más detalles de los WebServices: