> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta general

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](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

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

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)

## Consultar facturas

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/Facturas/FacturasConsultar](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.

**Page** `int`

Página de consulta. Es obligatorio cuando se envía `Rows`.

**Rows** `int`

Cantidad de registros por página de consulta. Si no se envía, se retornan todas las facturas que cumplen los filtros.

**TerceroID** `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](https://tech.sedierp.com/datos-del-cliente.md).

**FechaInicial** `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`.

**FechaFinal** `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.

**Consecutivo** `int`

Filtro de búsqueda por consecutivo exacto de la factura.

**ConsecutivoInicial** `int`

Filtro de búsqueda por rango de consecutivos, desde el consecutivo indicado (inclusive).

**ConsecutivoFinal** `int`

Filtro de búsqueda por rango de consecutivos, hasta el consecutivo indicado (inclusive).

**EstadoFacturaID** `int`

Filtro de búsqueda por código del estado de la factura (ID).

**Prefijo** `string`

Prefijo de la factura (máx. 10 caracteres). Actualmente este filtro no se aplica en la consulta.

**OrigenFacturaID** `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.

**CodigoOrigen** `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`.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/Facturas/FacturasConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"TerceroID": 48213,
	"FechaInicial": "2026-01-01",
	"FechaFinal": "2026-10-31",
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"EstadoFacturaID": null,
	"Prefijo": null,
	"OrigenFacturaID": null,
	"CodigoOrigen": null
}'
```

### 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:

**FacturaID** `int`

Código único de la factura (ID).

**Prefijo** `string`

Prefijo del tipo de factura.

**Consecutivo** `int`

Consecutivo de la factura.

**FechaCreacion** `datetime`

Fecha de creación de la factura.

**NombreCompleto** `string`

Nombre completo o razón social del cliente.

**AbreviaturaDocumento** `string`

Tipo y número de documento del cliente con formato (ej. "C.C. 1,032,456,789").

**UniqueID** `GUID`

Identificador único de la factura. Se utiliza para [descargar sus archivos](https://tech.sedierp.com/descarga-de-archivo-zip.md), [aceptarla](https://tech.sedierp.com/aceptar-factura.md) o [rechazarla](https://tech.sedierp.com/rechazar-factura.md).

**CUFE** `string`

CUFE de la factura electrónica.

**Tipo** `int`

Tipo de documento. Siempre es 1 (factura).

**ValorTotal** `decimal`

Valor total de la factura (valor neto más impuestos).

**MonedaAbreviatura** `string`

Abreviatura de la moneda de la factura.

**CodigoOrigenDescripcion** `string`

Descripción del origen de la factura (proceso y documento que la generó).

**NotasCreditoDebito** `array`

Notas crédito y notas débito asociadas a la factura. Es `null` cuando la factura no tiene notas.

**TotalRows** `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"}`).

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "TerceroID": 48213,
  "FechaInicial": "2026-01-01",
  "FechaFinal": "2026-10-31",
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "EstadoFacturaID": null,
  "Prefijo": null,
  "OrigenFacturaID": null,
  "CodigoOrigen": null
}
```

```json Exitosa theme={null}
{
    "data": [
        {
            "FacturaID": 20817,
            "Consecutivo": 1520,
            "FechaCreacion": "2026-10-01T08:15:42",
            "NombreCompleto": "LAURA MARTINEZ ROJAS",
            "UniqueID": "698236ef-c704-4063-bf81-f114677aced7",
            "CUFE": "1a99889fdccdf6325f42cc1218ad6180cb2918127833092729c619210545c52212bca287f64cada80181198c5354a70a",
            "Prefijo": "FE",
            "Tipo": 1,
            "ValorTotal": 1850000.0,
            "CodigoOrigenDescripcion": "Contrato de arrendamiento No. 345",
            "AbreviaturaDocumento": "C.C. 1,032,456,789",
            "NotasCreditoDebito": null,
            "MonedaAbreviatura": "COP",
            "TotalRows": 1
        }
    ],
    "result": 1,
    "message": "Transacción exitosa"
}
```

```json Sin resultados theme={null}
{
    "data": [],
    "result": 1,
    "message": "Transacción exitosa"
}
```

```json Error theme={null}
{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "TerceroID": [
            "The TerceroID field is required."
        ]
    },
    "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.