El cliente debe enviar una estructura de Enriquecimiento de Persona debiendo completar mínimamente los campos que se detallan a continuación:
Valor | Descripción |
2 | Consulta Personas |
Los siguientes campos son los Headers Obligatorios que deben informarse:
Método: POST
Endpoint: https://ws.merlindataquality.com/enrichment/normalize
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 |
{ "level1 ": "AR ", "tributaryNumber ": "27114786468 ", "queryId ": "2" }
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 |
{ "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 } }