> ## 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 documentos soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura 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 documentos soporte, se debe contar con los siguientes datos:

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

## Consultar documentos soporte

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/DocumentoSoporteNoObligadosConsultar\
**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 del documento soporte.

**FechaInicial** `string`

Filtro de búsqueda por fecha de emisió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 emisió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 de documento soporte.

**Tercero** `string`

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

**Identificacion** `string`

Filtro de búsqueda por número de identificación exacto del proveedor, 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 proveedor.
* **Fecha:** consulta por la fecha de emisión del documento.
* **Otro texto:** consulta por cualquier parte del nombre o del email del proveedor.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/DocumentoSoporteNoObligadosConsultar' \
--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": "DS",
	"Tercero": null,
	"Identificacion": null,
	"UsuarioEmail": null,
	"FullSearch": null
}'
```

### Respuesta

El servicio retorna el listado de documentos soporte ordenado por fecha de emisión y consecutivo de forma descendente. Cada registro de `rows` contiene los siguientes campos:

**DocumentoSoporteID** `int`

Código único del documento soporte (ID).

**Prefijo** `string`

Prefijo de la resolución del documento soporte.

**Consecutivo** `int`

Consecutivo del documento soporte.

**FechaCreacion** `datetime`

Fecha de emisión del documento soporte.

**UniqueID** `GUID`

Identificador único del documento soporte.

**CUDS** `string`

Código Único de Documento Soporte asignado al documento.

**ValorTotal** `decimal`

Valor total del documento soporte (valor neto + valor de impuestos).

**NombreCompleto** `string`

Nombre completo o razón social del proveedor.

**AbreviaturaDocumento** `string`

Tipo y número de identificación del proveedor con formato (ej. "NIT. 1,020,304,050-8"). Para NIT incluye el dígito de verificación.

**Email** `string`

Correo electrónico del proveedor.

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró el documento.

**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": "DS",
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}
```

```json Response theme={null}
{
    "total": 1,
    "rows": [
        {
            "DocumentoSoporteID": 2045,
            "Consecutivo": 312,
            "FechaCreacion": "2026-11-04T09:00:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
            "CUDS": "a40ee3fb63d3b4095ae8b0d71fb818da466d9f182f039be1067807738252b8a0dc30671d73c110ce28b692c4c9551a35",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "DS",
            "ValorTotal": 1308000.00,
            "AbreviaturaDocumento": "NIT. 1,020,304,050-8",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```


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