Skip to main content
El servicio permite a los usuarios consultar el listado de facturas de venta en línea en formato JSON. El método de solicitud es POST y se requiere un encabezado “Authorization” para la autenticación, que debe contener un token JWT obtenido previamente del servicio de autenticación.

​
Prerequisitos

Antes de realizar la consulta de facturas de venta, se debe contar con los siguientes datos:

​
Consultar facturas de venta

Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/FacturasVentasConsultar
Tipo: POST
Content Type: application/json
​
int
Página de consulta, por defecto (1).
​
int
Cantidad de registros por página de consulta, por defecto (10). El máximo permitido es 30 registros por página.
​
GUID
Filtro de búsqueda por identificador único de la factura de venta.
​
string
Filtro de búsqueda por fecha de creación del documento, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.
​
string
Filtro de búsqueda por fecha de creación del documento, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.
​
int
Filtro de búsqueda por consecutivo del documento.
​
int
Filtro de búsqueda por rango de consecutivos, desde el consecutivo indicado (inclusive).
​
int
Filtro de búsqueda por rango de consecutivos, hasta el consecutivo indicado (inclusive).
​
string
Filtro de búsqueda por prefijo de la resolución del documento.
​
string
Filtro de búsqueda por cualquier parte del nombre o razón social del cliente.
​
string
Filtro de búsqueda por número de identificación exacto del cliente, sin dígito de verificación.
​
string
Filtro de búsqueda por email del usuario que registró el documento.
​
string
Campo de consulta múltiple. El criterio de búsqueda depende del valor enviado:
  • Numérico: consulta por el consecutivo del documento o por el número de identificación del cliente.
  • Fecha: consulta por la fecha de creación del documento.
  • Otro texto: consulta por cualquier parte del nombre o del email del cliente.

​
Respuesta

El servicio retorna el listado de facturas de venta ordenado por consecutivo de forma descendente. Cada registro de rows contiene los siguientes campos:
​
int
Código único de la factura de venta (ID).
​
string
Prefijo de la resolución de la factura de venta.
​
int
Consecutivo de la factura de venta.
​
datetime
Fecha de creación de la factura de venta.
​
GUID
Identificador único de la factura de venta.
​
string
Código Único de Factura Electrónica asignado al documento.
​
string
Nombre completo o razón social del cliente.
​
string
Tipo y número de identificación del cliente con formato (ej. “NIT. 900,123,456-7”). Para NIT incluye el dígito de verificación.
​
string
Correo electrónico del cliente.
​
decimal
Valor neto de la factura de venta (antes de impuestos).
​
decimal
Valor total de los impuestos de la factura de venta.
​
string
Descripción del origen del documento.
​
string
Nombre del usuario que registró el documento.
​
string
Nombre de la causal de rechazo de la factura, si aplica.
​
string
URL para descargar la representación gráfica (PDF) de la factura de venta.
​
int
Cantidad total de registros que cumplen con los filtros de la consulta.