Consideraciones generales
El cliente debe enviar una estructura de Enriquecimiento de Personas según lo detallado en el apartado «Atributos de entrada» debiendo completar mínimamente los campos que se detallan a continuación:
- documentNumber: obligatorio salvo que se informe el numero tributario.
- tributaryNumer: puede no completarse si se informa el documentNumber.
- clientAccessCode: ID de acceso de cliente.
- level1: informar país. <level1>AR</level1>
- queryId: Informar el numero de vista según la consulta a realizar. <queryId>32</queryId>
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.
Número de Vista de queryId
| Valor |
Descripción |
| 32 |
Consulta Identidad y Contactabilidad |
Estados para Enriquecimiento
| Valor |
Descripción |
| EN |
Registro validado y enriquecido |
| DU |
Registro que requiere Auditoria |
| NE |
Registro no Validado |
| ER |
Error en los datos ingresados |
El resultado del proceso de enriquecimiento sera la estructura de datos detallada en el apartado «Atributos de salida»
Codificación Tipo Tributario
| Valor |
Descripción |
| 80 |
CUIT |
| 86 |
CUIL |
| 87 |
CDI |
Codificación Tipo Documento
| 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 (C.I.) excepto 15 |
Codificación Tipo Dirección
| Valor |
Descripción |
| F |
Indica que el domicilio es una dirección de tipo Fiscal. |
| L |
Indica que el domicilio es una dirección Laboral. |
| E |
Indica que el domicilio es una dirección Electoral. |
Codificación Tipo Telefono
| Valor |
Descripción |
| FIJO |
Informa que el numero informado es un teléfono fijo |
| MOVIL |
Informa que el numero informado es un teléfono móvil/celular. |
| Valor |
Descripción |
| PERSONAL |
Informa que el email informado es de uso personal. |
| LABORAL |
Informa que el email informado es de uso laboral. |
| 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». |
| level1 |
64 |
País originario del documento a consultar |
| 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 el numeroDocumento. |
| lastNames |
64 |
Apellido 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. |
| queryId |
3 |
Identificador de la consulta de datos, asociada a esta solicitud. |
| 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». |
| |
|
|
| transactionId |
10 |
Merlin asigna un id de transacción por consulta. |
| dataRows |
– |
Estructura donde Merlin retorna los datos de la persona, mail, telefono y domicilio. |
| row |
2 |
Estructura donde traerá n-elements como datos haya encontrado para un normalizador. |
| element |
64 |
Estructura de contenido de los normalizadores. |
| name |
64 |
Nombre del campo a traer. |
| label |
64 |
etiqueta del normalizador de donde proviente el campo. |
| value |
64 |
Valor que trae el campo. |
| index |
64 |
Valor que indica la posición de la etiqueta. |
| merlinCustomValues |
12 |
Valores desarrollados por demanda del cliente o que se provee opcionalmente como ser las entre calles. |
Para ver más detalles de los WebServices:
Formato de mensajería JSON
