Enriquecimiento de Personas

Normalizadores y Validadores Personas y Empresas Enriquecimiento de Personas

Enriquecimiento de Personas

Descripción General

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>2</queryId>

Número de Vista de queryId

Valor	Descripción
2	Consulta Personas

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.

Codificación Tipo Email

Valor	Descripción
PERSONAL	Informa que el email informado es de uso personal.
LABORAL	Informa que el email informado es de uso laboral.

Atributos de entrada

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.

Atributos de salida

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».
remainingCredits	16	Créditos restantes del usuario.
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.