> ## 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 a los usuarios consultar el listado de facturas de compra 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](https://tech.sedierp.com/quickstart.md).

## Prerequisitos

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

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)

## Consultar facturas de compra

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/FacturasComprasConsultar\
**Tipo:** POST \
**Content Type:** application/json

**Page** `int`

Número de página a mostrar, por defecto (1).

**Rows** `int`

Número de registros a mostrar por página, por defecto (10).

**UniqueID** `GUID`

Identificador único de la factura de compra.

**Tercero** `string`

Filtro de búsqueda por cualquier parte del nombre del emisor de la factura de compra.

**Identificacion** `string`

Filtro de búsqueda por número de identificación del emisor de la factura de compra.

**NumeroDocumento** `string`

Filtro de búsqueda por número de documento (prefijo y consecutivo) de la factura de compra.

**UsuarioEmail** `string`

Filtro de búsqueda por email del usuario asignado en la factura de compra.

**EstadoAprobacionFacturaCompraID** `int`

Filtro por estado de aprobación de la factura de compra. Valores permitidos:

| EstadoAprobacionFacturaCompraID | Nombre |
| - | - |
| 1 | Pendiente de aprobación |
| 2 | Aprobada |
| 3 | Rechazada |

**FechaInicial** `string`

Fecha inicial para consultar las facturas registradas desde dicha fecha, en formato ISO 8601 (ej. "2026-10-01T00:00:00").

**FechaFinal** `string`

Fecha final para consultar las facturas registradas hasta dicha fecha, en formato ISO 8601 (ej. "2026-10-31T23:59:59").

**ConCentroCosto** `bool`

Filtro por facturas de compra con centros de costos (true: solo facturas con centros de costos).

**FullSearch** `string`

Campo de consulta múltiple. El criterio de búsqueda depende del valor enviado:

* **Numérico:** consulta por el número de identificación del emisor o por el número de documento (prefijo y consecutivo) de la factura de compra.
* **Fecha:** consulta por la fecha de registro o de emisión de la factura de compra.
* **Otro texto:** consulta por cualquier parte del nombre del emisor, del número de identificación del emisor o del número de documento (prefijo y consecutivo) de la factura de compra.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/FacturasComprasConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"UniqueID": null,
	"Tercero": null,
	"Identificacion": null,
	"NumeroDocumento": null,
	"UsuarioEmail": null,
	"EstadoAprobacionFacturaCompraID": 1,
	"FechaInicial": "2026-10-01T00:00:00",
	"FechaFinal": "2026-10-31T23:59:59",
	"ConCentroCosto": null,
	"FullSearch": null
}'
```

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "Tercero": null,
  "Identificacion": null,
  "NumeroDocumento": null,
  "UsuarioEmail": null,
  "EstadoAprobacionFacturaCompraID": 1,
  "FechaInicial": "2026-10-01T00:00:00",
  "FechaFinal": "2026-10-31T23:59:59",
  "ConCentroCosto": null,
  "FullSearch": null
}
```

```json Response theme={null}
[
  {
    "FacturaCompraID": 4821,
    "NumeroDocumento": "FE-10458",
    "FechaEmision": "2026-11-02T00:00:00",
    "FechaVencimiento": "2026-12-02T00:00:00",
    "FechaRegistro": "2026-11-03T14:22:10.337",
    "ValidoDIAN": true,
    "UUID": "5f3c1a9e8b7d4c2a9e1f0a6b3d8c7e45b2a1f9c0d3e6a8b7c4d5e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1",
    "Electronica": true,
    "EstadoAprobacionFacturaCompraID": 2,
    "NombreCompleto": "DISTRIBUIDORA ANDINA S.A.S.",
    "Celular": "3101234567",
    "UniqueID": "9b2f6c1e-4a7d-4e3b-8c15-2d9a7f0e6b34",
    "AbreviaturaDocumento": "NIT. 900.123.456",
    "CentroCostoCodigoNombre": "01.02.003 - Administración",
    "EstadoAprobacionFacturaCompraNombre": "Aprobada",
    "ValorTotal": 1190000,
    "CountAprobaciones": 2,
    "TotalRows": 2
  },
  {
    "FacturaCompraID": 4790,
    "NumeroDocumento": "A-2215",
    "FechaEmision": "2026-10-28T00:00:00",
    "FechaVencimiento": null,
    "FechaRegistro": "2026-10-29T09:05:41.120",
    "ValidoDIAN": false,
    "UUID": null,
    "Electronica": false,
    "EstadoAprobacionFacturaCompraID": 1,
    "NombreCompleto": "JUAN CARLOS PEREZ GOMEZ",
    "Celular": null,
    "UniqueID": "3e8d0a47-1c5b-4f92-a6d3-7b1e9c2f5a08",
    "AbreviaturaDocumento": "CC. 1.032.456.789",
    "CentroCostoCodigoNombre": null,
    "EstadoAprobacionFacturaCompraNombre": "Pendiente",
    "ValorTotal": 570000,
    "CountAprobaciones": 0,
    "TotalRows": 2
  }
]
```


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