> ## 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 de referencias

El servicio permite a los usuarios consultar las facturas de compra junto con sus referencias, archivos adjuntos e información de aprobación, en línea en formato JSON. Permite filtrar los documentos según si ya fueron migrados o no a un sistema externo.

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 referencias 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 referencias de facturas de compra

**Request URL:** https\://\{\{Ambiente}}/API\_FAC/api/FacturasCompra/FacturasComprasReferenciasConsultar\
**Tipo:** POST \
**Content Type:** application/json

**Page** `int` *required*

Página que se debe mostrar según la cantidad de registros (Rows) consultados.

**Rows** `int` *required*

Cantidad de registros que se muestran por página.

**MigradoSistemaExterno** `bool`

Filtro por estado de migración del documento: **false** para obtener los documentos no migrados a sistema externo, **true** para obtener los documentos migrados a sistema externo.

**EstadoAprobacionFacturaCompraID** `int`

Filtro por estado de aprobación de la factura de compra. Si no se envía, se consultan las facturas aprobadas (2). Valores permitidos:

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

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FAC/api/FacturasCompra/FacturasComprasReferenciasConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"MigradoSistemaExterno": false,
	"EstadoAprobacionFacturaCompraID": 2
}'
```

### Respuesta

El servicio retorna el listado de facturas de compra ordenado por fecha de aprobación de forma ascendente. Cada registro de `rows` contiene los siguientes campos:

**FacturaCompraID** `int`

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

**ProveedorDocumento** `string`

Número de identificación del proveedor (emisor de la factura).

**ProveedorNombreCompleto** `string`

Nombre completo o razón social del proveedor.

**ProveedorNombres** `string`

Nombres del proveedor (primer y segundo nombre).

**ProveedorApellidos** `string`

Apellidos del proveedor (primer y segundo apellido). Es nulo cuando el proveedor es persona jurídica.

**ProveedorCelular** `string`

Número de celular del proveedor.

**ProveedorEmail** `string`

Correo electrónico del proveedor.

**NumeroDocumento** `string`

Número de documento (prefijo y consecutivo) de la factura de compra.

**FechaEmision** `datetime`

Fecha de emisión de la factura de compra.

**FechaRegistro** `datetime`

Fecha de registro de la factura de compra en el sistema.

**AprobacionFecha** `datetime`

Fecha de la última aprobación registrada en la jerarquía de aprobación de la factura.

**ValorTotal** `decimal`

Valor total de la factura de compra (valor neto + valor de impuestos).

**UsuarioAprobacion** `string`

Nombre del usuario que realizó la última aprobación de la factura.

**EmpresaAdquiriente** `string`

Nombre de la empresa adquiriente (receptora) de la factura de compra.

**EstadoFacturaCompraNombre** `string`

Nombre del estado de aprobación de la factura de compra.

**CentroCostoCodigo** `string`

Código del centro de costos asociado a la factura de compra.

**CentroCostoNombre** `string`

Nombre del centro de costos asociado a la factura de compra.

**PrimeraObservacionAprobador** `string`

Observación registrada por el primer aprobador de la jerarquía.

**Adjuntos** `array`

Archivos adjuntos de la factura de compra. Retorna un arreglo vacío si no tiene adjuntos.

**propiedades**

**Nombre** `string`

Nombre del archivo adjunto.

**Ruta** `string`

URL para visualizar o descargar el archivo adjunto.

**Referencias** `array`

Referencias asociadas a la factura de compra. Retorna un arreglo vacío si no tiene referencias.

**propiedades**

**Referencia** `string`

Valor de la referencia.

**TotalRows** `int`

Cantidad total de registros que cumplen con los filtros de la consulta.

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "MigradoSistemaExterno": false,
  "EstadoAprobacionFacturaCompraID": 2
}
```

```json Response theme={null}
{
    "total": 2,
    "rows": [
        {
            "FacturaCompraID": 1542,
            "ProveedorDocumento": "900123456",
            "ProveedorNombreCompleto": "PROVEEDOR EJEMPLO S.A.S.",
            "ProveedorNombres": "PROVEEDOR EJEMPLO S.A.S.",
            "ProveedorApellidos": null,
            "ProveedorCelular": "3001234567",
            "ProveedorEmail": "facturacion@proveedorejemplo.com",
            "NumeroDocumento": "FE1520",
            "FechaEmision": "2026-10-05T00:00:00",
            "FechaRegistro": "2026-10-06T08:15:30.457",
            "AprobacionFecha": "2026-10-07T10:22:41.120",
            "ValorTotal": 1190000.00,
            "UsuarioAprobacion": "CARLOS PEREZ GOMEZ",
            "EmpresaAdquiriente": "EMPRESA ADQUIRIENTE S.A.S.",
            "EstadoFacturaCompraNombre": "Aprobada",
            "CentroCostoCodigo": "01-001",
            "CentroCostoNombre": "ADMINISTRACION",
            "PrimeraObservacionAprobador": "Se aprueba según orden de compra OC-345.",
            "Adjuntos": [
                {
                    "Nombre": "FE1520.pdf",
                    "Ruta": "https://nsx.sedierp.com/ArchivosCargados/FacturasCompra/FE1520.pdf"
                }
            ],
            "Referencias": [
                {
                    "Referencia": "OC-345"
                }
            ],
            "TotalRows": 2
        },
        {
            "FacturaCompraID": 1561,
            "ProveedorDocumento": "1020304050",
            "ProveedorNombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "ProveedorNombres": "JUAN CARLOS",
            "ProveedorApellidos": "RODRIGUEZ LOPEZ",
            "ProveedorCelular": "3109876543",
            "ProveedorEmail": "juan.rodriguez@correo.com",
            "NumeroDocumento": "FV3387",
            "FechaEmision": "2026-10-12T00:00:00",
            "FechaRegistro": "2026-10-12T14:42:10.210",
            "AprobacionFecha": "2026-10-14T09:05:12.830",
            "ValorTotal": 450000.00,
            "UsuarioAprobacion": "ANDREA MARTINEZ RUIZ",
            "EmpresaAdquiriente": "EMPRESA ADQUIRIENTE S.A.S.",
            "EstadoFacturaCompraNombre": "Aprobada",
            "CentroCostoCodigo": null,
            "CentroCostoNombre": null,
            "PrimeraObservacionAprobador": null,
            "Adjuntos": [],
            "Referencias": [
                {
                    "Referencia": "OC-351"
                },
                {
                    "Referencia": "REM-0098"
                }
            ],
            "TotalRows": 2
        }
    ],
    "result": 1
}
```


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