Consultar datos del adquiriente

El método GetDatosAdquirientes permite consultar los datos de identificación y contacto del adquiriente o comprador de un documento electrónico.

La información devuelta corresponde a los datos suministrados directamente por la DIAN, de acuerdo con la información disponible para el tipo y número de identificación consultados.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/GetDatosAdquirientes/{guidEmpresa}/{tipoIdentificacion}/{numeroIdentificacion}

Endpoint

Dato	Valor
Método HTTP	GET
Operación	GetDatosAdquirientes

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
GuidEmpresa	string	Sí	Identificador único de la empresa que realiza la consulta.
TipoIdentificacion	string	Sí	Código del tipo de identificación del adquiriente (ver tabla siguiente).
NumeroIdentificacion	string	Sí	Número de identificación del adquiriente que se desea consultar.

Códigos de tipo de identificación

Código	Descripción
11	Registro civil
12	Tarjeta de identidad
13	Cédula de ciudadanía
21	Tarjeta de extranjería
22	Cédula de extranjería
31	NIT
41	Pasaporte
42	Documento de identificación extranjero
47	Permiso especial de permanencia (PEP)

Ejemplo de solicitud

Ambiente: demostración.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/GetDatosAdquirientes/3408859dc7cc426991edcb70220bbfb6/13/123456789

Consultar datos del adquiriente en el ambiente de demostración

Estructura de la respuesta

La respuesta contiene el estado de la consulta y los datos de identificación y contacto del adquiriente que devuelve el servicio.

Campo	Descripción
Estado	Código del estado de la consulta (ver tabla siguiente).
Detalle	Mensaje descriptivo del resultado. Si ocurre un error, puede describir el inconveniente o la respuesta recibida de la DIAN.
TipoIdentificacion	Tipo de identificación del adquiriente consultado.
Identificación	Número de identificación del adquiriente consultado.
RazonSocial	Razón social o nombre completo del adquiriente suministrado por la DIAN.
Email	Correo electrónico del adquiriente suministrado por la DIAN. Puede no estar disponible.
PrimerNombre	Primer nombre del adquiriente.
OtrosNombres	Otros nombres del adquiriente. Puede venir vacío.
PrimerApellido	Primer apellido del adquiriente. Puede venir vacío.
SegundoApellido	Segundo apellido del adquiriente. Puede venir vacío.

Estados de respuesta

Estado	Descripción
UNICO	Consulta exitosa únicamente en la DIAN.
EXITO	La información consultada proviene de la DIAN y es consistente.
DISCR	La información consultada proviene de la DIAN, pero puede no ser consistente. Se recomienda validar los datos con el cliente.
ERROR	Se presentó un error durante la consulta. Revisa el campo Detalle.

Tratamiento de los nombres y apellidos

Cuando el tipo de identificación es diferente de NIT o NIT de otro país, el sistema puede separar el nombre del adquiriente en los campos PrimerNombre, OtrosNombres, PrimerApellido y SegundoApellido. Para identificaciones de tipo NIT, el nombre se representa mediante el campo RazonSocial.

Casos de uso

El método GetDatosAdquirientes puede utilizarse para:

• Consultar información del adquiriente: obtener los datos disponibles para un tipo y número de identificación.
• Completar información del comprador: recuperar la razón social o los nombres y apellidos disponibles.
• Consultar datos de contacto: obtener el correo electrónico cuando esté disponible en la respuesta.
• Validar información: revisar el estado y el detalle de la consulta para determinar si los datos requieren una verificación adicional.

Consideraciones importantes

• Identificador de empresa: el parámetro GuidEmpresa debe corresponder a la empresa que realiza la consulta.
• Tipo de identificación: se debe enviar el código correspondiente al documento del adquiriente.
• Consistencia de los datos: cuando el estado sea DISCR, se recomienda validar directamente la información con el cliente.
• Información no disponible: algunos campos pueden venir vacíos, dependiendo de la respuesta de la DIAN.
• Nombre de las propiedades: verifica en el modelo de respuesta si el campo de identificación se serializa como Identificación o Identificacion.