> ## 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 asociadas a las facturas del cliente, 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 el **AccessToken** (JWT) obtenido previamente del servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

Antes de realizar la consulta de notas débito, se debe contar con los siguientes datos:

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)
* Código único del cliente (TerceroID) obtenido del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)

## Consultar notas débito

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/NotasDebito/NotasDebitoConsultar](https://portal.sedierp.com/API_FAC/api/NotasDebito/NotasDebitoConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**TerceroID** `int` *required*

Código único del cliente (ID) que inició sesión. Se obtiene del campo `TerceroID` del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md). El servicio retorna las notas débito de las facturas de este cliente.

**Page** `int`

Página de consulta. Es obligatorio cuando se envía `Rows`.

**Rows** `int`

Cantidad de registros por página de consulta. Si no se envía (o es 0), el servicio retorna todos los registros sin paginar.

**FechaInicial** `date`

Filtro de búsqueda por fecha de creación de la nota débito, desde la fecha indicada (inclusive). Formato `yyyy-MM-dd`. Solo se tiene en cuenta la fecha, no la hora.

**FechaFinal** `date`

Filtro de búsqueda por fecha de creación de la nota débito, hasta la fecha indicada (inclusive). Formato `yyyy-MM-dd`. Solo se tiene en cuenta la fecha, no la hora.

**Consecutivo** `int`

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

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

**EstadoNotaID** `int`

Filtro de búsqueda por código del estado de la nota débito (ID).

**Prefijo** `string`

Filtro de búsqueda por prefijo exacto de la factura relacionada (ej. "FV"). Máximo 10 caracteres.

**OrigenFacturaID** `string`

Filtro de búsqueda por código del origen de la factura relacionada (ID). Se pueden enviar varios códigos separados por coma (ej. "1,3").

**CodigoOrigen** `string`

Filtro de búsqueda por código del registro que originó la factura relacionada, según su origen. Debe ser numérico.

**FacturaUniqueID** `GUID`

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

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/NotasDebito/NotasDebitoConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"TerceroID": 48213,
	"Page": 1,
	"Rows": 10,
	"FechaInicial": "2026-10-01",
	"FechaFinal": "2026-11-04",
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"EstadoNotaID": null,
	"Prefijo": null,
	"OrigenFacturaID": null,
	"CodigoOrigen": null,
	"FacturaUniqueID": null
}'
```

### Respuesta

El servicio retorna el listado de notas débito ordenado por fecha de creación de forma descendente. Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 (`{"Code": 401, "Message": "El TokenAcceso no es valido"}`).

Cada registro de `rows` contiene los siguientes campos:

**Prefijo** `string`

Sigla del tipo de documento contable 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** `date`

Fecha de vencimiento de la nota débito.

**ValorNeto** `decimal`

Valor neto de la nota débito.

**ValorImpuestos** `decimal`

Valor de los impuestos de la nota débito.

**Observaciones** `string`

Observaciones de la nota débito.

**CausalNotaDebitoDescripcion** `string`

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

**EstadoNotaNombre** `string`

Nombre del estado de la nota débito.

**EstadoDocumentoElectronicoNombre** `string`

Nombre del estado del documento electrónico ante la DIAN.

**CausalRechazoDocumentoDescripcion** `string`

Descripción de la causal de rechazo del documento electrónico, cuando aplica.

**FechaAnulacion** `date`

Fecha de anulación de la nota débito, cuando aplica.

**ObservacionesAnulacion** `string`

Observaciones de la anulación, cuando aplica.

**DIANKey** `string`

CUDE de la nota débito.

**QR** `string`

Contenido del código QR de la nota débito electrónica.

**UniqueID** `GUID`

Identificador único de la nota débito.

**FacturaPrefijoConsecutivo** `string`

Prefijo y consecutivo de la factura relacionada (ej. "FV-1533").

**FacturaDIANKey** `string`

CUFE de la factura relacionada.

**FacturaUniqueID** `GUID`

Identificador único de la factura relacionada.

**OrigenFacturaNombre** `string`

Nombre del origen de la factura relacionada.

**CodigoOrigenDescripcion** `string`

Descripción del origen de la factura relacionada.

**TotalRows** `int`

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

```json Request theme={null}
{
  "TerceroID": 48213,
  "Page": 1,
  "Rows": 10,
  "FechaInicial": "2026-10-01",
  "FechaFinal": "2026-11-04",
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "EstadoNotaID": null,
  "Prefijo": null,
  "OrigenFacturaID": null,
  "CodigoOrigen": null,
  "FacturaUniqueID": null
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "Consecutivo": 88,
            "FechaCreacion": "2026-10-28T09:42:10",
            "FechaVencimiento": "2026-11-12T00:00:00",
            "ValorNeto": 120000.0,
            "ValorImpuestos": 0.0,
            "FechaAnulacion": null,
            "ObservacionesAnulacion": null,
            "QR": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=06f72cf154aaeb79c8d0adb3271276913ab75deffdde033521c09201ad7233b503930e854abd39eb2faeca4eb8feb5eb",
            "DIANKey": "06f72cf154aaeb79c8d0adb3271276913ab75deffdde033521c09201ad7233b503930e854abd39eb2faeca4eb8feb5eb",
            "UniqueID": "add76678-6730-4c64-9a03-6c9a06b26830",
            "Observaciones": "Cobro de intereses de mora canon de septiembre",
            "Prefijo": "ND",
            "CausalNotaDebitoDescripcion": "Intereses",
            "EstadoNotaNombre": "Aprobada",
            "EstadoDocumentoElectronicoNombre": "Aceptado",
            "CausalRechazoDocumentoDescripcion": null,
            "FacturaDIANKey": "d41f3b3957c10e6c4244ce01847ff2974b12cf5af73f11a2f9fac9c9c4a92928db6535b7c1d228b9b05511cdb366e508",
            "FacturaUniqueID": "a83ff920-5f7a-4b29-87a4-9a8caa5d8f0b",
            "OrigenFacturaNombre": "Contratos de arrendamiento",
            "FacturaPrefijoConsecutivo": "FV-1533",
            "CodigoOrigenDescripcion": "Contrato 2045",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "The offset specified in a OFFSET clause may not be negative., "
}
```


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