Merlín 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.

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.
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
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.
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.
remainingCredits 16 Créditos restantes del usuario.
transactionId 10 Merlín 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:

Formato de mensajería JSON

Formato de mensajería SOAP