Archivo de Autor

Direcciones

En el método POST, los campos que no se completan deben ser etiquetados de todas formas. Por ejemplo, si no se informa el campo floor, la etiqueta floor:» «, debe existir dentro del mensaje. (Próximamente)

Para ver más detalles de los atributos: Descripción Direcciones

http://api.merlindataquality.com/2.0/addressnormalizer.json?level1=AR&street=Av Libertador 7270 2 A Frente al CENARD&level4=CABA&clientAccessCode=ACCESSCODE
https://sws.merlindataquality.com/2.0/addressnormalizer.json?level1=AR&street=Av Libertador 7270 2 A Frente al CENARD&level4=CABA&clientAccessCode=ACCESSCODE
{
   "status":"CO",
   "statusReason":"SM",
   "remainingCredits":"100",
   "transactionId":"123456",
   "nAddress":{
      "geoType":"1",
      "level1":"AR",
      "level2":"CAPITAL FEDERAL",
      "level3":"CAPITAL FEDERAL",
      "level4":"CIUDAD AUTONOMA BUENOS AIRES",
      "level5":"NUÑEZ",
      "streetType":"",
      "street":"AVDA DEL LIBERTADOR",
      "houseNumber":"7270",
      "floor":"2",
      "unit":"A",
      "latitude":"-58.457995",
      "longitude":"-34.546420",
      "postalCode":"1429",
      "additionalPostalCode":"C1429BMS",
      "fromStreetNumber":"1",
      "toStreetNumber":"8400",
      "addtionalData":"FRENTE AL CENARD",
      "betweenStreet1":"JUANA AZURDUY DE PADILLA",
      "betweenStreet2":"MANUELA PEDRAZA",
      "corner":"",
      "placeType":"",
      "place":"",
      "placeReference":"",
      "numberAlternativeAddresses":"",
      "alternativeAddresses":[

      ],
      "merlinCustomValues":[
         {
            "name":"addressLabel",
            "value":"Av. Libertador 7270 2 A, (1429), Ciudad Autonoma de Buenos Aires, Argentina"
         },
         {
            "name":"nise",
            "value":"9"
         },
         {
            "name":"maqStatus",
            "value":"NO"
         },
         {
            "name":"maqConcept",
            "value":""
         },
         {
            "name":"maqValue",
            "value":""
         },
         {
            "name":"level4Longitude",
            "value":"-58.445288"
         },
         {
            "name":"level4Latitude",
            "value":"-34.607161"
         },
         {
            "name":"postalCertifiedAddress",
            "value":"SI"
         },
         {
            "name":"merlinRiskArea",
            "value":"N"
         },
         {
            "name":"buildingType",
            "value":""
         }
      ],
      "clientCustomValues":[

      ]
   }
}

 

 

Estos campos estarán disponibles para próximas implementaciones

Nombres

En el método POST, los campos que no se completan deben ser etiquetados de todas formas. Por ejemplo, si no se informa el campo gender, la etiqueta gender:» «, debe existir dentro del mensaje.(Próximamente)

Para ver más detalles de los atributos: Descripción Nombres

https://sws.merlindataquality.com/2.0/namenormalizer.json?name=Juan Infusta&clientAccessCode=${ACCESSCODE}
{
    "status": "CO",
    "statusReason": "",
    "remainingCredits": "100",
    "transactionId": "123456",
    "nName": {
        "name": "Juan",
        "lastName": "Infusta",
        "personType": "PF",
        "gender": "M",
        "merlinCustomValues": [
            {
                "name": "",
                "value": ""
            }
        ]
    }
}

 

 

Estos campos estarán disponibles para próximas implementaciones

Normalización de Datos Filiatorios

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

Teléfonos

En el método POST, los campos que no se completan deben ser etiquetados de todas formas. Por ejemplo, si no se informa el campo postalCode, la etiqueta postalCode:» «, debe existir dentro del mensaje. (Próximamente)

Para ver más detalles de los atributos: Descripción Teléfonos

http://api.merlindataquality.com/2.0/phonenormalizer.json?phoneNumber=48965200&level2=Buenos Aires&level4=caba&clientAccessCode=ACCESSCODE
https://sws.merlindataquality.com/2.0/phonenormalizer.json?phoneNumber=48965200&level2=Buenos Aires&level4=caba&clientAccessCode=ACCESSCODE
{
    "status": "CO",
    "statusReason": "SM",
    "remainingCredits": "86423507",
    "transactionId": "1511549691",
    "nPhone": {
        "level1": "AR",
        "level2": "",
        "level3": "",
        "level4": "CIUDAD AUTONOMA BUENOS AIRES",
        "level5": "",
        "postalCode": "0",
        "ddi": "",
        "ddn": "011",
        "characteristic": "4896",
        "phoneNumber": "5200",
        "validated": "NO",
        "additionalData": "",
        "merlinCustomValues": [
            {
                "name": "PORTAL",
                "value": "PORTAL"
            },
            {
                "name": "directory",
                "value": "NO"
            },
            {
                "name": "telefonoCompleto",
                "value": "01148965200"
            },
            {
                "name": "fullPhone",
                "value": "01148965200"
            },
            {
                "name": "fullCellphoneNumber",
                "value": "01148965200"
            },
            {
                "name": "doNotCallRegistry",
                "value": "NO"
            }
        ]
    }
}


Estos campos estarán disponibles para próximas implementaciones

Domicilios

El cliente debe enviar una estructura de Archivo donde deberá completar al menos los campos:
  • calle: este campo puede contener tanto el nombre de la calle como la dirección completa (calle, número, piso, depto).
  • Estos campo NO deben ser completados si se ingreso la calle completa en el campo “calle”.
  • numero
  • piso
  • depto
  • localidad: la localidad puede no completarse si se informa el CP.
  • cp: el CP puede no completarse si se informa la localidad/provincia
En domicilios se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

 

 <nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt
<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio>
el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es addressfilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId>
retornará un valor numérico que identifica al lote.
<clienteSFTP>
nombre del usuario que ingreso el lote en el sftp
 
  • Archivo: Interfaz envío de domicilios a Merlín
  • Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
  • Formato: Con separador de datos “|” (Pipe)
Posición Nombre Tipo Comentario
1 ID Cliente Numérico Identificación del cliente
2 Calle Caracter Descripción Calle
3 Numero Numérico Altura de la Calle
4 Piso Caracter Piso de la dirección
5 Departamento Caracter Departamento
6 Barrio Caracter Descripción Barrio
7 Localidad Caracter Descripción Localidad
8 Partido Caracter Descripción Partido
9 Provincia Caracter Descripción Provincia
10 Código Postal Numérico Código Postal

Comentario: El diseño de archivo para envíos de domicilios a Merlín debe ser completo, no se permite tener campos de más, ni de menos.

Motivos aplicados a Corregidos (CO)

Motivos de no resolución aplicados a No encontrados (NE)

Aplicados a Dudosos (DU)

  • Archivo: Interfaz de domicilios recibidos de Merlín
  • Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
  • Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación es el que utiliza Merlin para los archivos de domicilios normalizados.

Posición Nombre Tipo Comentario
1 idCliente Numerico Identificación del cliente
2 estado Caracter Resultado de normalización
3 motivo Caracter Motivo del estado
4 calle_out Caracter Descripción de la Calle
5 numero_out Numerico Número del domicilio
6 piso_out Caracter Piso del domicilio
7 depto_out Caracter Departamento del domicilio
8 barrio_out Caracter Descripción del Barrio
9 localidad_out Caracter Descripción de la Localidad
10 partido_out Caracter Descripción del Partido
11 provincia_out Caracter Descripción de la Provincia
12 cp_out Numerico Código postal
13 observaciones Caracter Información Adicional
14 x Caracter Coordenada X de geocodificación. Retornará en blanco cuando no exista valor.
15 y Caracter Coordenada Y de geocodificación. Retornará en blanco cuando no exista valor.
16 entreCalle1 Caracter Primera entre calle.
17 entreCalle2 Caracter Segunda entre calle.
18 tipoGeo Numerico Tipo de georeferenciación. Ver documento TipoGeo
19 cpa Alfanumerico Se retorna Código Postal Argentino para los casos donde se dispone
20 REFERENCIA Referencia Referencia en barrios cerrados para los casos donde se dispone
21 NISE Numerico Nivel Socio Economico
22 zonaRiesgo Caracter Zona peligrosa, valores posibles; S o N
23 puerta Caracter Indica si se valida existencia de puerta
El campo 1 será retornado tal cual en la entrada sin ningún procesamiento o manipulación.

Teléfonos

El cliente debe enviar una estructura Teléfono donde deberá completar al menos los campos:
  •  número (con el número completo -prefijo, característica, número-)
  •  localidad (la localidad puede no completarse si se informa el CP)
  •  cp (el CP puede no completarse si se informa la localidad)
En teléfonos se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

<nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt

<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio> el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es phonefilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId> retornará un valor numérico que identifica al lote.
<clienteSFTP> nombre del usuario que ingreso el lote en el sftp

Archivo : Interfaz envío de teléfonos a Merlín
Código : ISO-8859-1 o UTF8(Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para enviar a Merlin los registros de teléfonos para su normalización.

Posición Nombre Tipo Comentario
1 ID Cliente Numérico Identificación del cliente
2 DDN Caracter DDN del número telefónico, Pj. 011 o 0381
3 Numero Caracter Número Teléfono, incluyendo su característica. Pj 1551794121 o 47859685
4 Provincia Caracter Descripción Provincia
5 Localidad Caracter Descripción Localidad
6 Codigo_Postal Numérico Código Postal
Comentario: El diseño de archivo para envíos de teléfonos a Merlin debe ser completo, no se permite tener campos de más, ni de menos. Los campos 4 y 5 son opcionales pero deben completarse con los correspondientes delimitadores, estos campos tienen como objetivo asociar el teléfono a un domicilio.
Archivo : Interfaz de teléfonos recibidos de Merlín
Código: ISO-8859-1 o UTF8(Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizará para recibir de Merlín los registros de teléfonos normalizados.

Posición Nombre Tipo Comentario
1 IdCliente Integrer Identificación del cliente
2 estado Caracter Código de estado que retorna Merlin: “CO” corregido “NE” no encontrado “SD” sin datos
3 prefijo Caracter DDN retornado por Merlín
4 areaCode Numerico Característica o código de área, del teléfono en cuestión.
5 numero Numerico Número de teléfono, sin la característica. Pj. 7154
6 telCompleto Caracter Número de telefono retornado por Merlin / Debe incluir en caso que corresponda, El prefijo celular (15) concatenado sin espacios con el resto del teléfono Ej. “1551794121”
7 observaciones Caracter Observación retornada por Merlín
8 figuraEnGuia Caracter Indica si el teléfono informado figura en la guía telefónica. Valores posibles SI (teléfono en guía), NO (no aparece en la guía) y CE (para celulares).
9 registroNoLlame Caracter Este valor indica si el teléfono ingresado es un numero activo en el registro No Llame. Valores posibles SI, NO.

Nombres

El cliente debe enviar una estructura de nombres donde deberá completar al menos los campos:
− nombre(opcional, si se indica todo en apellido)
− apellido (puede incluirse el nombre y apellido completo)

En nombres se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

 <nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt

<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio> el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es namefilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId> retornará un valor numérico que identifica al lote.
<clienteSFTP> nombre del usuario que ingreso el lote en el sftp

Archivo : Interfaz envío de nombres a Merlín
Código : ISO-8859-1 o UTF8(Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para enviar a Merlin los registros de nombres para su normalización.

Posición Nombre Tipo Comentario
1 IdCliente Integer Identificación del cliente
2 nombre varchar Nombre
3 apellido varchar Apellido o razón social, puede ser indicado todo el nombre y apellido.
4 genero varchar Se informa el sexo de la persona informada.
Comentario: El diseño de archivo para envíos de nombres a Merlín debe ser completo, no se permite tener campos de más, ni de menos.
Archivo : Interfaz de nombres recibidos de Merlín
Código: ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para recibir de Merlín los registros de nombres a normalizados.

Posición Nombre Tipo Comentario
1 IdCliente Numérico Identificación del cliente
2 estado Caracter Código de estado que retorna Merlin “CO” corregido “NP” no parseado
3 nombre Caracter Nombre identificado por el proceso
4 apellido Caracter Apellido o razón social identificado pro el proceso
5 genero Caracter Si es persona física, se informa el sexo inferido del nombre
6 tipoPersona Caracter Indica si es persona física o jurídica
Los campos 3 a 6 únicamente serán completados si el estado del registro es CO (corregido), caso contrario serán devueltos en vacío.

</ br>

Datos Filiatorios

Este módulo es opcional para aquellos clientes que hayan contratado el mismo y no forma parte del producto de normalización estándar.
En datos filiatorios se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.
<nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt

<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio> el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es filfilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId> retornará un valor numérico que identifica al lote.
<clienteSFTP> nombre del usuario que ingreso el lote en el sftp

Archivo : Interfaz envío de Datos Filiatorios a Merlín
Código: ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)
El diseño que se detalla a continuación se utilizará para enviar a Merlín los registros de datos filiatorios para su normalización.
Posición Nombre Tipo Comentario
1 IDCliente Numerico Identificación del cliente
2 Tipo de Documento Caracter Tipo Documento según codificación AFIP. Nulo para persona jurídica (Respetar cero a la izquierda).
Valores Posibles (sujetos a los cambios que pueda haber en los datos de la base AFIP en futuras actualizaciones):
30 certificado migración
40 cédula identidad sudamericana
88 documento extranjero
89 libreta Cívica
90 libreta Enrolamiento
91 Cédula identidad. 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 más de dos personas no extranjeras con el mismo sexo y nro de documento
99 indeterminado
00 a 24 (C.I. ) excepto 15
3 Numero Documento Numerico Nulo para persona jurídica
4 Tipo ID Tributaria Caracter Tipo Tributario según codificación AFIP.
Valores Posibles (sujetos a los cambios que pueda haber en los datos de la base AFIP en futuras actualizaciones):
80 = CUIT
86 = CUIL
87 = CDI
5 Numero ID Tributaria Numerico Numero Tributario
6 Apellido Caracter Apellido. Nulo para persona jurídica
7 Nombre Caracter Nombre / Razón Social
8 Sexo Caracter Sexo. Nulo para persona jurídica
9 Fecha Nacimiento Caracter Fecha Nacimiento. Nulo para persona jurídica
Comentario: El diseño de archivo para envíos de datos filiatorios a Merlín debe ser correcto, no se permite tener campos de más, ni de menos.
Archivo : Interfaz recibida desde Ases
Código: ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizará para recibir de Merlín los registros de datos filiatorios normalizados.

Posición Nombre Tipo Comentario
1 IDCliente Numerico Identificación del cliente
2 Estado Caracter Código de estado reportado por Merlin
3 Tipo_documento_normalizado Caracter Tipo de documento en caso de tratarse de una persona física. Nulo para persona jurídica.
Valores Posibles (sujetos a los cambios que pueda haber en los datos de la base AFIP en futuras actualizaciones):
30 certificado migración
40 cédula identidad sudamericana
88 documento extranjero
89 libreta Cívica
90 libreta Enrolamiento
91 Cédula identidad. 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 más de dos personas no extranjeras con el mismo sexo y nro de documento
99 indeterminado
00 a 24 (C.I. ) excepto 15
4 Flg_tipo_documento Caracter Flag por Tipo de Documento
5 Documento_normalizado Numerico Tipo de documento en caso de tratarse de una persona física. Nulo para persona jurídica.
6 Flg_nro_documento Caracter Flag por Nro. de Documento
7 Tipo_id_tributaria_normalizado Caracter Valores Posibles (sujetos a los cambios que pueda haber en los datos de la base AFIP en futuras actualizaciones):
80 = CUIT
86 = CUIL
87 = CDI
8 Flg_tipo_id_tributario Caracter Flag por Tipo Tributario
9 Id_tributaria_normalizado Numerico Numero Tributario
10 Flg_nro_tributario Caracter Flag por Nro. Tributario
11 Apellido_normalizado Caracter Apellido. Nulo para persona jurídica
12 Flg_apellido Caracter Flag por Apellido
13 Nombre_normalizado Caracter Nombre / Razón Social
14 Flg_nombre Caracter Flag por Nombre / Razón Social
15 Sexo_normalizado Caracter Sexo. Nulo para persona jurídica
16 Flg_sexo Caracter Flag por Sexo
17 Fecha_nacimiento_normalizado Caracter Fecha Nacimiento. Nulo para persona jurídica. El formato en que se entrega es DD/MM/AAAA.
18 Flg_fecha_nacimiento Caracter Flag por Fecha de Nacimiento
19 Tipo Persona Caracter Indica el tipo de persona jurídica, corresponde al campo de marca de CUIT del registro de AFIP.
Los valores posibles son:
I = cdi
L = cuil
E = cuil electoral
F = cuit personas físicas
J = cuit personas jurídicas
20 Flg MTN Caracter Indica si se aplicó el módulo de tratamiento de nombres(MTN) para la conformación del nombre y apellido resultante.
Valores Posibles “S” o “N”
21 Distancia MTN Numerico Es un valor de uso interno para Ases marca la distancia existente entre el nombre informado y el nombre de la base de contraste en caso de que se haya utilizado MTN.
Los flags que se entregan en la respuesta, indica en general el resultado de la comparación literal entre los el campos de origen y respuesta, indicando de esta forma si hubo un cambio.
Los valores posibles de estos atributos son:
VA = VALIDADO. El valor origen y destino son idénticos
CO = CORREGIDO. Se informó un valor en el origen, pero Merlín modifico el valor de la respuesta.
NV = INVÁLIDO. Los valores de origen y destino son diferentes y no se puede corregir.
AP = APORTADO. No se informo valor en el origen y Merlín aporta un valor a la respuesta.
NI = NO INFORMADO. No se informo valor en el origen y Merlín no dispone de valor para aportar.
NA = NO APLICA. El flag no aplica por la 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.

Condición Tributaria

Este módulo es opcional para aquellos clientes que hayan contratado el mismo y no forma parte del producto de normalización estándar.
El cliente debe enviar una estructura de datos  donde deberá completar al menos el campo CUIT.

</ br>

En validación tributaria se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

<nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt

<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio> el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es valtribfilear en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId> retornará un valor numérico que identifica al lote.
<clienteSFTP> nombre del usuario que ingreso el lote en el sftp

Archivo : Interfaz envío de nombres a Merlín
Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para enviar a Merlín los registros de validación tributaria.

Posición Nombre Tipo Comentario
1 IDCliente Numérico Identificación del cliente
2 CUIT Caracter CUIT de la persona
3 Denominacion Caracter Apellido o razón social, puede ser indicado todo el nombre y apellido.
Comentario: El diseño de archivo para envíos de nombres a Merlín debe ser completo, no se permite tener
campos de más, ni de menos. El campo 3 es opcional pero debe completarse con el correspondiente delimitador.
Archivo : Interfaz de nombres recibidos de Merlín
Código: ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para recibir de Merlín los registros de nombres a normalizados.

Posición Nombre Tipo Comentario
1 IDCliente Numerico Identificación del cliente
2 CUIT Caracter CUIT de la persona validada
3 Estado_cuit Caracter Código de estado que retorna Merlin, respecto de la validación o no del CUIT “VA” validado “NV” no validado
4 Denominacion_normalizado Caracter Denominación de la persona validada
5 Estado_Nombre Caracter

Código de estado que retorna Merlin, respecto de la validación o no del CUIT
“ME” Match Exacto
“MD” Match Distancia
“NM” No Match

“NN” Nombre NULL

6 Ganancias Caracter Indica la responsabilidad ante ganancias(‘NI’ , ‘AC’,’EX’) *
7 IVA Caracter Indica la responsabilidad ante el IVA (‘NI’, ‘AC’,’EX’,’NA’,’XN’,’AN’) *
8 Monotributo Caracter Indica si la persona es monotributista(‘NI’ , «Código categoría tributaria») *
9 Empleador Caracter Indica si la persona es empleador (‘N’ , ‘S’) *
Los campos 4 a 9 únicamente serán completados si el estado del registro es VA (validado), caso contrario serán devueltos en vacío.
(*) Referencias:
‘NI’, ‘N’ = No Inscripto
‘AC’, ‘S’ = Activo
‘EX’ = Exento
‘NA’ = No alcanzado
‘XN’ = Exento no alcanzado
‘AN’ = Activo no alcanzado

Emails

Este módulo es opcional para aquellos clientes que hayan contratado el mismo y no forma parte del producto de normalización estándar.
En validación de emails se respetará el siguiente formato de nombres en caso de éxito, a la izquierda los archivos que son ingresados en la carpeta de entrada y a la derecha son los archivos que dejará el proceso.

<nombreDelLote>_<identificadorServicio>.txt→<jobId>_<clienteSFTP>_<nombreDelLote>_<identificadorServicio>.txt

<nombreDelLote> string alfanumérico de vista, asignado por el cliente
<identificadorServicio> el mismo referenciará el normalizador, entrada y salida y delimitador que se utilizara para ese lote. El valor por defecto para este caso es emailfile en caso de que el cliente tenga mas de una configuración para ese servicio se le informará dicho valor.
<jobId> retornará un valor numérico que identifica al lote.
<clienteSFTP> nombre del usuario que ingreso el lote en el sftp

Archivo : Interfaz envío de nombres a Merlín
Código : ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para enviar a Merlín los registros de validación de email.

Posición Nombre Tipo Comentario
1 IDCliente Numérico Identificación del cliente
2 email Caracter Dirección de correo electrónico.
Comentario: El diseño de archivo para envíos de nombres a Merlín debe ser completo, no se permite tener
campos de más, ni de menos.

Motivos aplicados a Validados(OK)

Motivos de no resolución aplicados a No Validados (NV)

Archivo : Interfaz de nombres recibidos de Merlín
Código: ISO-8859-1 o UTF8 (Por defecto configurado para UTF-8)
Formato: Con separador de datos “|” (Pipe)

El diseño que se detalla a continuación se utilizara para recibir de Merlín los registros de nombres a normalizados.

Posición Nombre Tipo Comentario
1 IDCliente Numerico Identificación del cliente
2 Estado Caracter Indica el estado de normalización y/o validación. Para mas información ver “Estados y Motivos”.
3 Motivo Caracter Indica la razón con referencia al estado de normalización y/o validación. Para mas información ver “Estados y Motivos”.
4 Email Caracter Dirección de email validada.