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

Campo
Longitud Máxima Descripción
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.

Para ver más detalles de los WebServices:

Formato de mensajería JSON

Formato de mensajería SOAP