> ## 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 notas de ajuste a 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 notas de ajuste, se debe contar con los siguientes datos:

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

## Consultar notas de ajuste

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/NotaAjusteNoObligadosConsultar\
**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 nota de ajuste.

**DocumentoSoporteUniqueID** `GUID`

Filtro de búsqueda por identificador único del documento soporte relacionado.

**FechaInicial** `string`

Filtro de búsqueda por fecha de emisión de la nota de ajuste, 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 de la nota de ajuste, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

**Consecutivo** `int`

Filtro de búsqueda por consecutivo de la nota de ajuste.

**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 nota de ajuste.

**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ó la nota de ajuste.

**FullSearch** `string`

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

* **Numérico:** consulta por el consecutivo de la nota de ajuste o por el número de identificación del proveedor.
* **Fecha:** consulta por la fecha de emisión de la nota de ajuste.
* **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/NotaAjusteNoObligadosConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"UniqueID": null,
	"DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
	"FechaInicial": null,
	"FechaFinal": null,
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"Prefijo": null,
	"Tercero": null,
	"Identificacion": null,
	"UsuarioEmail": null,
	"FullSearch": null
}'
```

### Respuesta

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

**DocumentoSoporteAjusteID** `int`

Código único de la nota de ajuste (ID).

**Prefijo** `string`

Prefijo de la nota de ajuste.

**Consecutivo** `int`

Consecutivo de la nota de ajuste.

**FechaCreacion** `datetime`

Fecha de emisión de la nota de ajuste.

**UniqueID** `GUID`

Identificador único de la nota de ajuste.

**CUDS** `string`

Código Único de Documento Soporte asignado a la nota de ajuste.

**CausalDocumentoSoporteAjusteNombre** `string`

Descripción del concepto de corrección de la nota de ajuste.

**ValorNeto** `decimal`

Valor neto de la nota de ajuste (antes de impuestos).

**ValorImpuestos** `decimal`

Valor total de los impuestos y retenciones de la nota de ajuste.

**DocumentoSoporteConsecutivo** `string`

Prefijo y consecutivo del documento soporte relacionado (ej. "DS-312").

**DocumentoSoporteUniqueID** `GUID`

Identificador único del documento soporte relacionado.

**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ó la nota de ajuste.

**TotalRows** `int`

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

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
  "FechaInicial": null,
  "FechaFinal": null,
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "Prefijo": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}
```

```json Response theme={null}
{
    "total": 1,
    "rows": [
        {
            "DocumentoSoporteAjusteID": 58,
            "Consecutivo": 15,
            "FechaCreacion": "2026-11-05T10:00:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8",
            "CUDS": "6f6868a78e27b5fb65b51e6d0a493ed00cd4966af93ec2041f69b9fabdcd453b974e87255aad34406f605b86fab391bb",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "NA",
            "ValorNeto": 1360000,
            "ValorImpuestos": -52000,
            "AbreviaturaDocumento": "NIT. 1.020.304.050-8",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
            "DocumentoSoporteConsecutivo": "DS-312",
            "CausalDocumentoSoporteAjusteNombre": "Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```


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