Saltearse al contenido
Factus API

Obtener datos de adquirientes

El endpoint permite consultar el nombre o razón social y la dirección de correo electrónico asociada a un adquiriente, utilizando como criterios de búsqueda el tipo y número de documento.

La DIAN ha implementado un nuevo servicio de consulta para completar la información de adquirientes con el objetivo de facilitar y agilizar la generación de facturas electrónicas.

Método: GET

Endpoint 

https://api-sandbox.factus.com.co/v2/dian/acquirer?identification_document_id=&identification_number=

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Content-Type : application/json
Indica que los datos se envían en formato JSON.
Authorization Bearer token_de_acceso
Token de autenticación necesario para acceder al recurso. Ver Cómo generar token
Accept : application/json
Indica que la respuesta debe estar en formato JSON.
Nota: Reemplaza token_de_acceso con el token proporcionado tras autenticarte.

Variables de Ruta, Path Variables

Sección titulada «Variables de Ruta, Path Variables»
identification_document_id string

Código que corresponda al tipo de identificación. Para saber cual ID corresponde al tipo de identificación consulte la siguiente tabla.

Códigos de tipos de documentos.
identification_number string

Número de documento del adquiriente.

Response

Sección titulada «Response»

La consulta devuelve un objecto con el nombre y correo del adquiriente.

CampoDescripción
nameNombre del adquiriente.
emailEmail del adquiriente.

Ejemplo de respuesta

Sección titulada «Ejemplo de respuesta»
{
  "status": "OK",
  "message": "Solicitud exitosa",
  "data": {
    "name": "Nombre Cédula de ciudadanía 5",
    "email": "Mail_Cédula de ciudadanía_5@mail.com"
  }
}

Datos de prueba

Sección titulada «Datos de prueba»

Estos son los datos de ejemplo proporcionados por la DIAN, destinados exclusivamente para realizar consultas y pruebas en entornos de prueba.

ID de documentoNúmero de documentoNombre o Razón SocialCorreo de recepción de factura electrónica
11199991Nombre Registro civil 1Mail_Registro civil_1@mail.com
11199992Nombre Registro civil 2Mail_Registro civil_2@mail.com
11199993Nombre Registro civil 3Mail_Registro civil_3@mail.com
11199994Nombre Registro civil 4Mail_Registro civil_4@mail.com
11199995Nombre Registro civil 5Mail_Registro civil_5@mail.com
11199996Nombre Registro civil 6Mail_Registro civil_6@mail.com
11199997Nombre Registro civil 7Mail_Registro civil_7@mail.com
11199998Nombre Registro civil 8Mail_Registro civil_8@mail.com
11199999Nombre Registro civil 9Mail_Registro civil_9@mail.com
111999910Nombre Registro civil 10Mail_Registro civil_10@mail.com
21299991Nombre Tarjeta de identidad 1Mail_Tarjeta de identidad_1@mail.com
21299992Nombre Tarjeta de identidad 2Mail_Tarjeta de identidad_2@mail.com
21299993Nombre Tarjeta de identidad 3Mail_Tarjeta de identidad_3@mail.com
21299994Nombre Tarjeta de identidad 4Mail_Tarjeta de identidad_4@mail.com
21299995Nombre Tarjeta de identidad 5Mail_Tarjeta de identidad_5@mail.com
21299996Nombre Tarjeta de identidad 6Mail_Tarjeta de identidad_6@mail.com
21299997Nombre Tarjeta de identidad 7Mail_Tarjeta de identidad_7@mail.com
21299998Nombre Tarjeta de identidad 8Mail_Tarjeta de identidad_8@mail.com
21299999Nombre Tarjeta de identidad 9Mail_Tarjeta de identidad_9@mail.com
212999910Nombre Tarjeta de identidad 10Mail_Tarjeta de identidad_10@mail.com
31399991Nombre Cédula de ciudadanía 1Mail_Cédula de ciudadanía_1@mail.com
31399992Nombre Cédula de ciudadanía 2Mail_Cédula de ciudadanía_2@mail.com
31399993Nombre Cédula de ciudadanía 3Mail_Cédula de ciudadanía_3@mail.com
31399994Nombre Cédula de ciudadanía 4Mail_Cédula de ciudadanía_4@mail.com
31399995Nombre Cédula de ciudadanía 5Mail_Cédula de ciudadanía_5@mail.com
31399996Nombre Cédula de ciudadanía 6Mail_Cédula de ciudadanía_6@mail.com
31399997Nombre Cédula de ciudadanía 7Mail_Cédula de ciudadanía_7@mail.com
31399998Nombre Cédula de ciudadanía 8Mail_Cédula de ciudadanía_8@mail.com
31399999Nombre Cédula de ciudadanía 9Mail_Cédula de ciudadanía_9@mail.com
313999910Nombre Cédula de ciudadanía 10Mail_Cédula de ciudadanía_10@mail.com
42199991Nombre Tarjeta de extranjería 1Mail_Tarjeta de extranjería_1@mail.com
42199992Nombre Tarjeta de extranjería 2Mail_Tarjeta de extranjería_2@mail.com
42199993Nombre Tarjeta de extranjería 3Mail_Tarjeta de extranjería_3@mail.com
42199994Nombre Tarjeta de extranjería 4Mail_Tarjeta de extranjería_4@mail.com
42199995Nombre Tarjeta de extranjería 5Mail_Tarjeta de extranjería_5@mail.com
42199996Nombre Tarjeta de extranjería 6Mail_Tarjeta de extranjería_6@mail.com
42199997Nombre Tarjeta de extranjería 7Mail_Tarjeta de extranjería_7@mail.com
42199998Nombre Tarjeta de extranjería 8Mail_Tarjeta de extranjería_8@mail.com
42199999Nombre Tarjeta de extranjería 9Mail_Tarjeta de extranjería_9@mail.com
421999910Nombre Tarjeta de extranjería 10Mail_Tarjeta de extranjería_10@mail.com
52299991Nombre Cédula de extranjería 1Mail_Cédula de extranjería_1@mail.com
52299992Nombre Cédula de extranjería 2Mail_Cédula de extranjería_2@mail.com
52299993Nombre Cédula de extranjería 3Mail_Cédula de extranjería_3@mail.com
52299994Nombre Cédula de extranjería 4Mail_Cédula de extranjería_4@mail.com
52299995Nombre Cédula de extranjería 5Mail_Cédula de extranjería_5@mail.com
52299996Nombre Cédula de extranjería 6Mail_Cédula de extranjería_6@mail.com
52299997Nombre Cédula de extranjería 7Mail_Cédula de extranjería_7@mail.com
52299998Nombre Cédula de extranjería 8Mail_Cédula de extranjería_8@mail.com
52299999Nombre Cédula de extranjería 9Mail_Cédula de extranjería_9@mail.com
522999910Nombre Cédula de extranjería 10Mail_Cédula de extranjería_10@mail.com
63199991Nombre NIT 1Mail_NIT_1@mail.com
63199992Nombre NIT 2Mail_NIT_2@mail.com
63199993Nombre NIT 3Mail_NIT_3@mail.com
63199994Nombre NIT 4Mail_NIT_4@mail.com
63199995Nombre NIT 5Mail_NIT_5@mail.com
63199996Nombre NIT 6Mail_NIT_6@mail.com
63199997Nombre NIT 7Mail_NIT_7@mail.com
63199998Nombre NIT 8Mail_NIT_8@mail.com
63199999Nombre NIT 9Mail_NIT_9@mail.com
631999910Nombre NIT 10Mail_NIT_10@mail.com
74199991Nombre Pasaporte 1Mail_Pasaporte_1@mail.com
74199992Nombre Pasaporte 2Mail_Pasaporte_2@mail.com
74199993Nombre Pasaporte 3Mail_Pasaporte_3@mail.com
74199994Nombre Pasaporte 4Mail_Pasaporte_4@mail.com
74199995Nombre Pasaporte 5Mail_Pasaporte_5@mail.com
74199996Nombre Pasaporte 6Mail_Pasaporte_6@mail.com
74199997Nombre Pasaporte 7Mail_Pasaporte_7@mail.com
74199998Nombre Pasaporte 8Mail_Pasaporte_8@mail.com
74199999Nombre Pasaporte 9Mail_Pasaporte_9@mail.com
741999910Nombre Pasaporte 10Mail_Pasaporte_10@mail.com
84299991Nombre Documento de identificación extranjero 1Mail_Documento de identificación extranjero_1@mail.com
84299992Nombre Documento de identificación extranjero 2Mail_Documento de identificación extranjero_2@mail.com
84299993Nombre Documento de identificación extranjero 3Mail_Documento de identificación extranjero_3@mail.com
84299994Nombre Documento de identificación extranjero 4Mail_Documento de identificación extranjero_4@mail.com
84299995Nombre Documento de identificación extranjero 5Mail_Documento de identificación extranjero_5@mail.com
84299996Nombre Documento de identificación extranjero 6Mail_Documento de identificación extranjero_6@mail.com
84299997Nombre Documento de identificación extranjero 7Mail_Documento de identificación extranjero_7@mail.com
84299998Nombre Documento de identificación extranjero 8Mail_Documento de identificación extranjero_8@mail.com
84299999Nombre Documento de identificación extranjero 9Mail_Documento de identificación extranjero_9@mail.com
842999910Nombre Documento de identificación extranjero 10Mail_Documento de identificación extranjero_10@mail.com
105099991Nombre NIT de otro país 1Mail_NIT de otro país_1@mail.com
105099992Nombre NIT de otro país 2Mail_NIT de otro país_2@mail.com
105099993Nombre NIT de otro país 3Mail_NIT de otro país_3@mail.com
105099994Nombre NIT de otro país 4Mail_NIT de otro país_4@mail.com
105099995Nombre NIT de otro país 5Mail_NIT de otro país_5@mail.com
105099996Nombre NIT de otro país 6Mail_NIT de otro país_6@mail.com
105099997Nombre NIT de otro país 7Mail_NIT de otro país_7@mail.com
105099998Nombre NIT de otro país 8Mail_NIT de otro país_8@mail.com
105099999Nombre NIT de otro país 9Mail_NIT de otro país_9@mail.com
1050999910Nombre NIT de otro país 10Mail_NIT de otro país_10@mail.com
119199991Nombre NUIP * 1Mail_NUIP *_1@mail.com
119199992Nombre NUIP * 2Mail_NUIP *_2@mail.com
119199993Nombre NUIP * 3Mail_NUIP *_3@mail.com
119199994Nombre NUIP * 4Mail_NUIP *_4@mail.com
119199995Nombre NUIP * 5Mail_NUIP *_5@mail.com
119199996Nombre NUIP * 6Mail_NUIP *_6@mail.com
119199997Nombre NUIP * 7Mail_NUIP *_7@mail.com
119199998Nombre NUIP * 8Mail_NUIP *_8@mail.com
119199999Nombre NUIP * 9Mail_NUIP *_9@mail.com
1191999910Nombre NUIP * 10Mail_NUIP *_10@mail.com