Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa
Método ConsultaAdquiriente
Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Para que puedan verificar los tipos de identificación permitidos, les pedimos amablemente que consulten la Tabla 3. Allí encontrarán el listado completo de las identificaciones válidas. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.
- REQUEST
- Parámetros a Enviar
| Tipo | Identificador | Descripción |
|---|---|---|
| String | tipoIdentificacion | Tipo de Identificación del adquiriente |
| String | numeroIdentificacion | Número de Identificación del adquiriente |
- RESPONSE
- Parámetros a recibir
| Tipo | Identificador | Descripción |
|---|---|---|
| int | codigo | Indica el Estado de la operación retornado por el servicio |
| String | correoReceptor | Correo electrónico del adquiriente o comprador |
| String | mensaje | Mensaje que devuelva la api |
| String | nombreReceptor | Nombre o razón social del adquiriente o comprador |
| String | resultado | Resultado de la operación retornada por el servicio |
@IMPORTANTE: El consumo de este método está contemplado solamente por las siguientes URL´s:
URL´s Servicio SOAP
Ambiente DEMO
https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
Ambiente de Producción
https://emision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
URL´s Servicio REST
Ambiente DEMO
https://demoemision21-api.thefactoryhka.com.co/api/adquiriente/consulta
Ambiente de Producción
https://emision21-api.thefactoryhka.com.co/api/adquiriente/consulta
A continuación encontrará los ejemplos SOAP y REST dando click en el siguiente enlace:
Ejemplos:
| Códigos Genéricos | Resultado | Código de Respuesta | Mensaje |
|---|---|---|---|
| Envío satisfactorio | Procesado | 200 | Se retornan datos del Adquiriente |
| Error | Error al consultar la informacion | 400 | Tipo de identificación inválido |
| Error | Error al consultar la información | 500 | Error al momento de procesar la transacción, información de adquiriente no encontrado |
Recomendación: Asegúrese que el tipo de documento del adquiriente concuerde con el número de documento ya que de lo contrario retornara valores incorrectos.
Preguntas frecuentes
-
1. ¿Qué es el servicio "Consulta Adquiriente" de la DIAN?
Es un servicio web implementado por la DIAN que permite consultar el nombre, razón social y correo electrónico de un adquiriente o comprador utilizando únicamente su tipo y número de identificación. Su objetivo principal es facilitar y agilizar la generación de facturas electrónicas, permitiendo completar automáticamente los datos del adquiriente y evitando el ingreso manual, mejorando así la eficiencia en los procesos de facturación.
-
2. ¿Cuál es la base normativa para este servicio?
Este servicio se fundamenta en la Resolución 202 del 31 de marzo de 2025, la cual modifica los artículos 69 y 70 de la Resolución 165. El artículo 69 establece los datos mínimos exigibles al adquiriente (nombre/razón social, tipo y número de identificación, y correo electrónico) para la expedición de la factura electrónica. El artículo 70 describe el servicio provisto por la DIAN para facilitar la obtención de estos datos. La solicitud mínima de estos datos proviene de la circular externa número 007 del 24 de octubre de 2022, que buscaba evitar la exigencia de requisitos adicionales a los establecidos legalmente para la facturación electrónica.
-
3. ¿Qué tan confiable es la data que retorna la DIAN.?
El servicio, al recibir el Tipo y Número de identificación, busca en sus registros para completar automáticamente los datos necesarios para la factura electrónica de la siguiente manera:
Adquirente Facturador Electrónico: Si el documento de identificación consultado pertenece a un contribuyente registrado ante la DIAN como facturador electrónico, el sistema retornará el correo electrónico que dicho facturador haya declarado como correo de recepción de documentos electrónicos. Esta información se obtiene directamente de los registros de la DIAN. Data confiable
Adquirente No Facturador con RUT: En caso de que el adquiriente no esté registrado como facturador electrónico, el sistema procederá a verificar la existencia de un correo asociado al RUT. De encontrarse un correo, se mostrará el correo electrónico que figure en dicho registro. Data confiable
Persona Natural No Facturadora sin RUT: Si el adquiriente corresponde a una persona natural que no es facturadora electrónica y no posee un RUT registrado, el sistema realizará una búsqueda retrospectiva de la última factura electrónica emitida a ese número de identificación. El correo electrónico asociado a dicho adquiriente en esa factura será el valor retornado. Cabe destacar que esta información puede ser actualizada. Si el adquiriente modifica su dirección de correo electrónico en una factura posterior, esta actualización se reflejará en la API al día siguiente. Es tan confiable, o la confiabilidad de la data depende de la data dada por este comprador.
-
4. ¿Se puede realizar la consulta masivamente?
Tal como lo indica el articulo 4 de la resolución 000202 del 31/03/2025, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónico, Para el efecto la DIAN establecerá los mecanismos técnicos y procedimientos para garantizar que el servicio de facilitación de información sea seguro y controlado uno a uno.
-
5. ¿Es obligatorio el uso de este servicio?
No es obligatorio, es un servicio opcional. Sin embargo, aunque no es mandatorio, su uso mejora la robustez y la eficiencia de la facturación, especialmente en escenarios de facturación a clientes finales
-
6. ¿Es importante la concordancia entre el tipo de documento y el número de documento durante la consulta?
Sí, es muy importante asegurar que el tipo de identificación registrado sea congruente con el número de identificación de la persona, si se envía un tipo de identificación incorrecto para un número dado (por ejemplo, cédula de ciudadanía para un NIT de empresa), el servicio puede retornar valores incorrectos o incongruentes en el nombre del receptor.
-
7. ¿Se puede realizar la consulta por lotes (facturación masiva)?
No, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónica. El artículo 4 de la resolución 202 que modifica el articulo 70 de la resolución 165 deja claro que no es posible hacer este proceso, el servicio está diseñado para realizar las consultas de forma uno a uno es decir si se van a generar 100 facturas, se deben realizar 100 consultas individuales. No está estipulado para la facturación por lotes o masiva.
-
8. ¿Este servicio de consulta tiene un costo adicional?
No, no tiene costo adicional. Es un servicio gratuito implementado directamente por la DIAN, si se trabaja con una casa de software, será esta la encargada de implementar el servicio dentro de su software o ERP.
-
9. ¿Supone este servicio un tiempo adicional de espera para el usuario final al momento de facturar?
Según la documentación, es al contrario. El objetivo de este servicio que implementa la DIAN es hacer el proceso de facturación más ágil, al usuario solo se le solicitará el tipo y número de identificación. Al implementar este servicio en el software, automáticamente traerá la información del nombre o correo electrónico, evitando la digitalización manual de estos datos, lo cual puede ser más rápido que pedirlos y digitarlos. El adquiriente o comprador solo tendría que confirmar si el nombre y correo traídos automáticamente son correctos. Esto busca mejorar la eficiencia.