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

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

## Consultar notas crédito

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/NotasCreditoConsultar\
**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 crédito.

**FacturaUniqueID** `GUID`

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

**Consecutivo** `int`

Filtro de búsqueda por consecutivo de la nota crédito.

**Prefijo** `string`

Filtro de búsqueda por prefijo de la nota crédito.

**FechaInicial** `string`

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

**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ó la nota crédito.

**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 crédito, por el consecutivo de la factura relacionada o por el número de identificación del cliente.
* **Fecha:** consulta por la fecha de creación de la nota crédito.
* **Otro texto:** consulta por cualquier parte del nombre, email, dirección o celular del cliente.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotasCreditoConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"UniqueID": null,
	"FacturaUniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17",
	"Consecutivo": null,
	"Prefijo": null,
	"FechaInicial": null,
	"FechaFinal": null,
	"Tercero": null,
	"Identificacion": null,
	"UsuarioEmail": null,
	"FullSearch": null
}'
```

### Respuesta

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

**NotaCreditoID** `int`

Código único de la nota crédito (ID).

**Prefijo** `string`

Prefijo de la nota crédito.

**Consecutivo** `int`

Consecutivo de la nota crédito.

**FechaCreacion** `datetime`

Fecha de creación de la nota crédito.

**FechaVencimiento** `datetime`

Fecha de vencimiento de la nota crédito.

**ValorTotal** `decimal`

Valor total de la nota crédito (valor neto + valor de impuestos).

**CUFE** `string`

Código Único de Documento Electrónico (CUDE) de la nota crédito.

**UniqueID** `GUID`

Identificador único de la nota crédito.

**CausalNotaCreditoDescripcion** `string`

Descripción de la causal de la nota crédito.

**PrefijoFactura** `string`

Prefijo de la factura de venta relacionada.

**FacturaConsecutivo** `int`

Consecutivo de la factura de venta relacionada.

**FacturaFecha** `datetime`

Fecha de creación de la factura de venta relacionada.

**FacturaValor** `decimal`

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

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

**NombreUsuarioCompleto** `string`

Nombre del usuario que registró la nota crédito.

**TotalRows** `int`

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

```json Request theme={null}
{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "FacturaUniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17",
  "Consecutivo": null,
  "Prefijo": null,
  "FechaInicial": null,
  "FechaFinal": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}
```

```json Response theme={null}
{
    "total": 1,
    "rows": [
        {
            "NotaCreditoID": 3127,
            "Consecutivo": 245,
            "FechaCreacion": "2026-11-05T09:12:44.317",
            "FechaVencimiento": "2026-11-08T09:12:44.317",
            "ValorTotal": 535500.00,
            "CUFE": "6e4cd73a68a794357fdb53da488a718475576787258df00bc30089983783e4b960472c890d6413ae87ec08dde13d8627",
            "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41",
            "Prefijo": "NC",
            "FacturaConsecutivo": 1520,
            "FacturaValor": 880500.00,
            "FacturaFecha": "2026-11-04T10:30:00",
            "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
            "AbreviaturaDocumento": "NIT. 900,123,456-7",
            "Email": "facturacion@clienteejemplo.com",
            "PrefijoFactura": "FE",
            "CausalNotaCreditoDescripcion": "Devolución de parte de los bienes; no aceptación de partes del servicio",
            "NombreUsuarioCompleto": "CARLOS PEREZ GOMEZ",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```


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