Skip to main content
El servicio permite consultar el listado de facturas de venta emitidas al cliente que inició sesión en el portal de clientes, 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 el AccessToken (JWT) obtenido previamente del servicio de inicio de sesión.

​
Prerequisitos

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

​
Consultar facturas

Request URL: https://portal.sedierp.com/API_FAC/api/Facturas/FacturasConsultar
Tipo: POST
Content Type: application/json El servicio solo retorna las facturas del cliente y la empresa del AccessToken.
​
int
Página de consulta. Es obligatorio cuando se envía Rows.
​
int
Cantidad de registros por página de consulta. Si no se envía, se retornan todas las facturas que cumplen los filtros.
​
int
required
Código único del cliente (ID). Es obligatorio por validación del modelo, pero el valor enviado no se utiliza: las facturas siempre se filtran por el cliente del AccessToken. Se recomienda enviar el TerceroID del servicio de datos del cliente.
​
date
Filtro de búsqueda por fecha de creación de la factura, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora. Acepta los formatos yyyy-MM-dd, yyyy-MM-ddTHH:mm:ss y dd/MM/yyyy.
​
date
Filtro de búsqueda por fecha de creación de la factura, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.
​
int
Filtro de búsqueda por consecutivo exacto de la factura.
​
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).
​
int
Filtro de búsqueda por código del estado de la factura (ID).
​
string
Prefijo de la factura (máx. 10 caracteres). Actualmente este filtro no se aplica en la consulta.
​
string
Filtro de búsqueda por código del origen de la factura (ID), es decir, el proceso de la plataforma que generó la factura.
​
string
Filtro de búsqueda por código del documento en el origen de la factura (máx. 30 caracteres). Se usa junto con OrigenFacturaID.

​
Respuesta

El servicio retorna en data el listado de facturas ordenado por fecha de creación de forma descendente. Si ninguna factura cumple los filtros, data es una lista vacía. Cada registro de data contiene los siguientes campos:
​
int
Código único de la factura (ID).
​
string
Prefijo del tipo de factura.
​
int
Consecutivo de la factura.
​
datetime
Fecha de creación de la factura.
​
string
Nombre completo o razón social del cliente.
​
string
Tipo y número de documento del cliente con formato (ej. “C.C. 1,032,456,789”).
​
GUID
Identificador único de la factura. Se utiliza para descargar sus archivos, aceptarla o rechazarla.
​
string
CUFE de la factura electrónica.
​
int
Tipo de documento. Siempre es 1 (factura).
​
decimal
Valor total de la factura (valor neto más impuestos).
​
string
Abreviatura de la moneda de la factura.
​
string
Descripción del origen de la factura (proceso y documento que la generó).
​
array
Notas crédito y notas débito asociadas a la factura. Es null cuando la factura no tiene notas.
​
int
Cantidad total de facturas que cumplen con los filtros de la consulta.
Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 ({"Code": 401, "Message": "El TokenAcceso no es valido"}).