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

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

## Consultar notas débito

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

**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 débito.

**Prefijo** `string`

Filtro de búsqueda por prefijo de la nota débito.

**FechaInicial** `string`

Filtro de búsqueda por fecha de creación de la nota débito, 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 débito, 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 débito.

**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 débito, 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 o de vencimiento de la nota débito.
* **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/NotasDebitoConsultar' \
--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 débito ordenado por fecha de creación de forma descendente. Cada registro de `rows` contiene los siguientes campos:

**NotaDebitoID** `int`

Código único de la nota débito (ID).

**Prefijo** `string`

Prefijo de la nota débito.

**Consecutivo** `int`

Consecutivo de la nota débito.

**FechaCreacion** `datetime`

Fecha de creación de la nota débito.

**FechaVencimiento** `datetime`

Fecha de vencimiento de la nota débito.

**ValorTotal** `decimal`

Valor total de la nota débito (valor neto + valor de impuestos).

**CUFE** `string`

Código Único de Documento Electrónico (CUDE) de la nota débito.

**UniqueID** `GUID`

Identificador único de la nota débito.

**EstadoNotaNombre** `string`

Nombre del estado de la nota débito.

**CausalNotaDebitoDescripcion** `string`

Descripción de la causal de la nota débito.

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

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró la nota débito.

**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": [
        {
            "NotaDebitoID": 418,
            "Consecutivo": 87,
            "FechaCreacion": "2026-11-06T14:20:05.533",
            "FechaVencimiento": "2026-11-09T14:20:05.533",
            "ValorTotal": 84500.00,
            "CUFE": "e42966a2ecf5769a418fd9aa41c1480546066833a69d88b13bf3606c35928f2871a96a2b21e798effc49ecfb959fee27",
            "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73",
            "Prefijo": "ND",
            "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",
            "EstadoNotaNombre": "Pendiente",
            "PrefijoFactura": "FE",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "CausalNotaDebitoDescripcion": "Gastos por cobrar",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```


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