Búsqueda de Persona

Normalizadores y Validadores Personas y Empresas Búsqueda de Persona

Búsqueda de Persona

Descripción General

Este servicio permitirá la búsqueda de una persona, a partir de los datos que se ingresen, los mismos podrán ser, Documento, Número Tributario, Nombre, Apellido, Genero, Provincia, Localidad, CP. Retornando los datos necesarios para identificar a dicha persona en un scope postal.

Consideraciones generales

El cliente debe enviar una estructura Nombre donde deberá completar al menos los campos:

documentNumber: obligatorio salvo que se informe el numero tributario o nombre o apellido.
tributaryNumber: obligatorio salvo que se informe el numero de documento o nombre o apellido.
name: obligatorio salvo que se informe el numero tributario o numero de documento.
lastName: obligatorio salvo que se informe el numero tributario o numero de documento.
clientAccessCode: ID de acceso de cliente.

Estados para Búsqueda Personas

Estado	Descripción	Observaciones
EN	Encontrado	Cuando se encuentran datos en el DW.
NE	No Encontrado	Cuando no hay datos en el DW para los datos de entrada.
ER	Error en los datos ingresados	Cuando no se ingresa ningún dato o los datos ingresados son incorrectos (Ej: Nombre con números, DNI o Número Tributario con Letras, o algún ingreso que genere un error para la búsqueda.)

Atributos de Entrada

Atributo	Longitud Máxima	Significado
clientAccessCode	64	Identificador único de usuarios. Este valor identifica y valida en cada invocación a un usuario determinado
customAdapters	64	Adaptadores de respuesta/modificadores de comportamiento.
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 número tributario.
tributaryType	2	80=CUIT, 86=CUIL,87=CDI.
tributaryNumber	11	Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber.
names	64	Nombre/s de la persona física o denominación/razón social de la entidad.
lastNames	64	Apellido/s de la persona física.
Gender	1	Sexo de la persona física.
Level2	64	Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia.
Level4	64	Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad.
postalCode	4	Código Postal de la dirección.

Atributos de Salida

Campo	Longitud Máxima	Descripción
status	3	Indica el estado de normalización y/o validación
statusReason	2	Indica la razón con referencia al estado de normalización y/o validación.
remainingCredits	16	Créditos restantes del usuario.
transactionId	10	Merlin asigna un id de transacción por consulta.
numberAlternativePerson	2	Número de posibles personas encontradas con los datos aportados.
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 número tributario.
tributaryType	2	80=CUIT, 86=CUIL,87=CDI.
tributaryNumber	11	Número de CUIT o CUIL. Obligatorio salvo que se informe documentNumber.
names	64	Nombre/s de la persona física o denominación/razón social de la entidad.
lastNames	64	Apellido/s de la persona física.
Gender	1	Sexo de la persona física.
birthDate	10	Fecha de nacimiento de la persona.
street	64	Nombre de la calle o dirección completa.
houseNumber	10	Número de la dirección.
floor	2	Piso de la dirección.
unit	3	Departamento, número de casa, oficina, PH, local, entre otros elementos de la dirección.
Level2	64	Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia.
Level4	64	Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad.
postalCode	4	Código Postal de la dirección.