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.
Nota: El QueryId asignado por el cliente se determina en función de la vista de enriquecimiento que se va a consultar. Este ID puede variar dependiendo de los datos específicos que se necesiten. Existen vistas predefinidas ya desarrolladas y otras que pueden ser creadas bajo demanda según los requerimientos del cliente.
| Valor | Descripción |
| 32 | Consulta Identidad y Contactabilidad |
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
| 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
{
"birthDate": "",
"documentNumber": {{ nro_documento }},
"documentType": "",
"gender": "",
"lastName": "",
"level1": "AR",
"name": "",
"queryId": "32",
"tributaryNumber": "",
"tributaryType": ""
}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 |
| 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": "19175e05-a5ee-44eb-89ca-4db6ae969612",
"nPersonEnrichment": {
"alternativePerson": [
{
"emails": [
{
"type": "LABORAL",
"email": {{correo_electrónico}},
}
],
"addresses": [
{
"level5": "NUÑEZ",
"level4": "CIUDAD AUTONOMA BUENOS AIRES",
"door": "true",
"shop": "",
"observation": "",
"latitude": "-34.54136",
"postalCode": "1429",
"streetintersection1": "CUBA",
"streetintersection2": "VUELTA DE OBLIGADO",
"type": "F",
"building": "",
"home": "true",
"number": {{ numero_de_la_calle}},
"unit": "",
"geoType": "1",
"motive": "SM",
"cpa": "C1429DXK",
"street": {{nombre_de_la_calle}},
"state": "CO",
"level1": "ARGENTINA",
"floor": "",
"level3": "CAPITAL FEDERAL",
"longitude": {{longitud}},
"level2": "CAPITAL FEDERAL"
},
],
"identity": {
"lastName": {{ nompre_de_la_empresa}},
"deceased": "",
"gender": "",
"tributaryNumber": {{ numero_tributario}},
"documentType": "",
"tributaryType": "CUIT PERSONA JURIDICA",
"documentNumber": "",
"entityType": "JURIDICA",
"fullName": {{ nompre_completo_de_la_empresa}},
"birthDate": "01/10/1993",
"documentRemplace": "",
"documentTypeCode": "",
"nationality": "",
"tributaryCodeAfip": "J",
"name": "",
"voter": "",
"residence": "ARGENTINA",
"tributaryCode": "80",
"deceasedDate": "",
"maritalStatus": ""
},
"phones": [
{
"number": {{ numero_de_teléfono}},
"phoneType": "",
"doNotCallRegistry": "true",
"type": "MOVIL",
"operator": "TELEFONICA MOVILES ARGENTINA S. A.",
"ddn": "011"
},
]
}
],
"merlinCustomValues": {},
"numberAlternativePerson": 1
}
}
}