Enriquecimiento de Personas

Enriquecimiento de Personas

 

Servicio de Enriquecimiento de Personas

El cliente debe enviar una estructura de Enriquecimiento de Persona debiendo completar mínimamente los campos que se detallan a continuación:

  • documentNumber: Número de documento en caso de persona física. Obligatorio salvo que se informe el número tributario.
  • tributaryNumer: Número de CUIT o CUIL. Obligatorio salvo que se informe el numeroDocumento.
  • level1: País originario del documento a consultar. informar país. AR
  • queryId Informar el número de vista según la consulta a realizar. 2
Valor Descripción
2 Consulta Personas

Los siguientes campos son los Headers Obligatorios que deben informarse:

  • Authorization: Header con el ID de acceso de cliente (ClientAccessCode).
  • Content-Type: Header que se informa el tipo de contenido del mensaje, se debe informar application/json.

Método: POST

Endpoint: https://ws.merlindataquality.com/enrichment/normalize

Parámetros de llamada
Parámetro Descripción Longitud Tipo
Authorization 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. 64 String
Content-Type Header que se informa el tipo de contenido del mensaje, se debe informar application/json. String
customAdaptersKeys Adaptadores de respuesta/modificadores de comportamiento. Array
level1 País originario del documento a consultar 64 String
documentType Tipo Documento según codificación AFIP. Nulo para persona jurídica. 2 String
documentNumber Número de documento en caso de persona física. Obligatorio salvo que se informe el número tributario. 8 String
tributaryType Valores  
  • 80=CUIT
 
  • 86=CUIL
 
  • 87=CDI
2 String
tributaryNumber Número de CUIT o CUIL. Obligatorio salvo que se informe el numeroDocumento. 11 String
lastName Apellido de la persona física. 64 String
name Nombre/s de la persona física o denominación/razón social de la entidad. 64 String
gender Sexo de la persona física. 1 String
birthDate Fecha de nacimiento de la persona física. 10 String
queryId Identificador de la consulta de datos, asociada a esta solicitud. 3 String
Mensaje JSON de petición
{
  "level1 ": "AR ",
  "tributaryNumber ": "27114786468 ",
  "queryId ": "2"
}
Respuesta

La respuesta está compuesta por una lista de elementos que tienen la siguiente estructura:

Parámetro Descripción Longitud Tipo
status Indica el estado de normalización y/o validación. 3 String
remainingCredits Créditos restantes del usuario. 16 String
transactionId Merlin asigna un id de transacción por consulta. 10 String
dataRows Estructura donde Merlin retorna los datos de la persona, mail, teléfono y domicilio. Object
row Estructura donde traerá n-elements como datos haya encontrado para un normalizador. 2 String
element Estructura de contenido de los normalizadores. 64 Object
name Nombre del campo a traer. 64
label etiqueta del normalizador de donde proviene el campo. 64
value Valor que trae el campo. 64
index Valor que indica la posición de la etiqueta. 64
merlinCustomValues Valores desarrollados por demanda del cliente o que se provee opcionalmente como ser las entre calles. 12 Object
Mensaje JSON de respuesta
{
    "status": "EN",
    "statusReason": "SM",
    "transactionId": "8de482db-8e8a-4e5f-b997-6578f8619bce",
    "nPersonEnrichment": {
        "alternativePerson": [
            {
                "emails": [],
                "addresses": [
                    {
                        "level4": "TRENQUE LAUQUEN",
                        "number": "350.0",
                        "unit": "",
                        "street": "AVDA ALTE GUILLERMO BROWN",
                        "postalCode": "6400",
                        "latitude": "-35.960995",
                        "type": "F",
                        "floor": "",
                        "longitude": "-62.736342",
                        "level2": "BUENOS AIRES"
                    }
                ],
                "identity": {
                    "lastName": "HEIM",
                    "gender": "M",
                    "tributaryNumber": "20116596661",
                    "documentType": "DNI",
                    "tributaryType": "CUIT PERSONA FISICA",
                    "documentNumber": "11659666",
                    "name": "JUAN CARLOS",
                    "birthDate": "25/01/1955",
                    "nise": "D1"
                },
                "phones": [
                    {
                        "number": "462520",
                        "doNotCallRegistry": "",
                        "type": "FIJO",
                        "ddn": "02922"
                    },
                    {
                        "number": "4545425",
                        "doNotCallRegistry": "",
                        "type": "FIJO",
                        "ddn": "0291"
                    },
                    {
                        "number": "425290",
                        "doNotCallRegistry": "",
                        "type": "FIJO",
                        "ddn": "02392"
                    },
                    {
                        "number": "4576696",
                        "doNotCallRegistry": "",
                        "type": "MOVIL",
                        "ddn": "0260"
                    }
                ]
            }
        ],
        "merlinCustomValues": {},
        "numberAlternativePerson": 1
    }
}