Consulta de referencias

{
  "Page": 1,
  "Rows": 10,
  "MigradoSistemaExterno": false,
  "EstadoAprobacionFacturaCompraID": 2
}

{
    "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
}

{
  "Page": 1,
  "Rows": 10,
  "MigradoSistemaExterno": false,
  "EstadoAprobacionFacturaCompraID": 2
}

{
    "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
}

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.

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

Consultar referencias de facturas de compra

Request URL: https://{{Ambiente}}/API_FAC/api/FacturasCompra/FacturasComprasReferenciasConsultar
Tipo: POST
Content Type: application/json

int

required

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

int

required

Cantidad de registros que se muestran por página.

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.

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

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:

int

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

string

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

string

Nombre completo o razón social del proveedor.

string

Nombres del proveedor (primer y segundo nombre).

string

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

string

Número de celular del proveedor.

string

Correo electrónico del proveedor.

string

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

datetime

Fecha de emisión de la factura de compra.

datetime

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

datetime

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

decimal

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

string

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

string

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

string

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

string

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

string

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

string

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

array

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

Show propiedades

string

Nombre del archivo adjunto.

string

URL para visualizar o descargar el archivo adjunto.

array

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

Show propiedades

string

Valor de la referencia.

int

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

{
  "Page": 1,
  "Rows": 10,
  "MigradoSistemaExterno": false,
  "EstadoAprobacionFacturaCompraID": 2
}

{
    "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
}

Primeros pasos

CRM

Facturación

Custodia

Común

Consulta de referencias

Prerequisitos

Consultar referencias de facturas de compra

Respuesta

​Prerequisitos

​Consultar referencias de facturas de compra

​Respuesta

Prerequisitos

Consultar referencias de facturas de compra

Respuesta