> ## 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 venta 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 venta, se debe contar con los siguientes datos:

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

## Consultar facturas de venta

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

**Page** `int`

Página de consulta, por defecto (1).

**Rows** `int`

Cantidad de registros por página de consulta, por defecto (10). El máximo permitido es 30 registros por página.

**UniqueID** `GUID`

Filtro de búsqueda por identificador único de la factura de venta.

**FechaInicial** `string`

Filtro de búsqueda por fecha de creación del documento, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

**FechaFinal** `string`

Filtro de búsqueda por fecha de creación del documento, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

**Consecutivo** `int`

Filtro de búsqueda por consecutivo del documento.

**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).

**Prefijo** `string`

Filtro de búsqueda por prefijo de la resolución del documento.

**Tercero** `string`

Filtro de búsqueda por cualquier parte del nombre o razón social del cliente.

**Identificacion** `string`

Filtro de búsqueda por número de identificación exacto del cliente, sin dígito de verificación.

**UsuarioEmail** `string`

Filtro de búsqueda por email del usuario que registró el documento.

**FullSearch** `string`

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

* **Numérico:** consulta por el consecutivo del documento o por el número de identificación del cliente.
* **Fecha:** consulta por la fecha de creación del documento.
* **Otro texto:** consulta por cualquier parte del nombre o del email del cliente.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/FacturasVentasConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"UniqueID": null,
	"FechaInicial": "2026-11-01",
	"FechaFinal": "2026-11-30",
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"Prefijo": null,
	"Tercero": null,
	"Identificacion": null,
	"UsuarioEmail": null,
	"FullSearch": null
}'
```

### Respuesta

El servicio retorna el listado de facturas de venta ordenado por consecutivo de forma descendente. Cada registro de `rows` contiene los siguientes campos:

**FacturaID** `int`

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

**Prefijo** `string`

Prefijo de la resolución de la factura de venta.

**Consecutivo** `int`

Consecutivo de la factura de venta.

**FechaCreacion** `datetime`

Fecha de creación de la factura de venta.

**UniqueID** `GUID`

Identificador único de la factura de venta.

**CUFE** `string`

Código Único de Factura Electrónica asignado al documento.

**NombreCompleto** `string`

Nombre completo o razón social del cliente.

**AbreviaturaDocumento** `string`

Tipo y número de identificación del cliente con formato (ej. "NIT. 900,123,456-7"). Para NIT incluye el dígito de verificación.

**Email** `string`

Correo electrónico del cliente.

**ValorNeto** `decimal`

Valor neto de la factura de venta (antes de impuestos).

**ValorImpuestos** `decimal`

Valor total de los impuestos de la factura de venta.

**CodigoOrigenDescripcion** `string`

Descripción del origen del documento.

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró el documento.

**CausalRechazoFacturaNombre** `string`

Nombre de la causal de rechazo de la factura, si aplica.

**UrlPdf** `string`

URL para descargar la representación gráfica (PDF) de la factura de venta.

**TotalRows** `int`

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

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "FechaInicial": "2026-11-01",
  "FechaFinal": "2026-11-30",
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "Prefijo": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}
```

```json Response theme={null}
{
    "total": 2,
    "rows": [
        {
            "FacturaID": 15873,
            "Consecutivo": 1520,
            "FechaCreacion": "2026-11-04T10:30:00",
            "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
            "UniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17",
            "CUFE": "12b4ce77d1b43d2b7199b286262198bf114d75b07158fe8dc595989d6b59180919f2f2285142f48128c0cecc8b200041",
            "Email": "facturacion@clienteejemplo.com",
            "Prefijo": "FE",
            "ValorNeto": 750000.00,
            "ValorImpuestos": 130500.00,
            "CodigoOrigenDescripcion": "API",
            "AbreviaturaDocumento": "NIT. 900,123,456-7",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "CausalRechazoFacturaNombre": null,
            "UrlPdf": "https://nsx.sedierp.com/API_FAC/api/PDFs/DocumentoB?TipoDocumentoID=1&UniqueID=5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17&Attachment=true",
            "TotalRows": 2
        },
        {
            "FacturaID": 15860,
            "Consecutivo": 1519,
            "FechaCreacion": "2026-11-02T15:12:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "a3c71b09-2e5f-4d84-9b6a-0f1e7c2d5b88",
            "CUFE": "5fe3071244ef9644d38a616aeea8f187a43fe9c82a83383fd8744cb0870d10167bbb8380d83d73ce73e5f2bc45fca01b",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "FE",
            "ValorNeto": 200000.00,
            "ValorImpuestos": 38000.00,
            "CodigoOrigenDescripcion": "API",
            "AbreviaturaDocumento": "C.C. 1,020,304,050",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "CausalRechazoFacturaNombre": null,
            "UrlPdf": "https://nsx.sedierp.com/API_FAC/api/PDFs/DocumentoB?TipoDocumentoID=1&UniqueID=a3c71b09-2e5f-4d84-9b6a-0f1e7c2d5b88&Attachment=true",
            "TotalRows": 2
        }
    ],
    "result": 1
}
```


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