> ## 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 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 crédito, 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 crédito

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/NotasCredito/NotasCreditoConsultar](https://portal.sedierp.com/API_FAC/api/NotasCredito/NotasCreditoConsultar)\
**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 crédito 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 crédito, 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 crédito, 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 crédito.

**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 crédito (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/NotasCredito/NotasCreditoConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"TerceroID": 48213,
	"Page": 1,
	"Rows": 10,
	"FechaInicial": "2026-10-01",
	"FechaFinal": "2026-10-31",
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"EstadoNotaID": null,
	"Prefijo": null,
	"OrigenFacturaID": null,
	"CodigoOrigen": null,
	"FacturaUniqueID": null
}'
```

### Respuesta

El servicio retorna el listado de notas crédito 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 crédito.

**Consecutivo** `int`

Consecutivo de la nota crédito.

**FechaCreacion** `datetime`

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

**FechaVencimiento** `date`

Fecha de vencimiento de la nota crédito.

**ValorNeto** `decimal`

Valor neto de la nota crédito.

**ValorImpuestos** `decimal`

Valor de los impuestos de la nota crédito.

**Observaciones** `string`

Observaciones de la nota crédito.

**CausalNotaCreditoDescripcion** `string`

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

**EstadoNotaNombre** `string`

Nombre del estado de la nota crédito.

**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 crédito, cuando aplica.

**ObservacionesAnulacion** `string`

Observaciones de la anulación, cuando aplica.

**DIANKey** `string`

CUDE de la nota crédito.

**QR** `string`

Contenido del código QR de la nota crédito electrónica.

**UniqueID** `GUID`

Identificador único de la nota crédito.

**FacturaPrefijoConsecutivo** `string`

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

**FacturaDIANKey** `string`

CUFE de la factura relacionada.

**FacturaUniqueID** `GUID`

Identificador único 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-10-31",
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "EstadoNotaID": null,
  "Prefijo": null,
  "OrigenFacturaID": null,
  "CodigoOrigen": null,
  "FacturaUniqueID": null
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "Consecutivo": 312,
            "FechaCreacion": "2026-10-20T10:15:42",
            "FechaVencimiento": "2026-10-20T00:00:00",
            "ValorNeto": 450000.0,
            "ValorImpuestos": 85500.0,
            "FechaAnulacion": null,
            "ObservacionesAnulacion": null,
            "QR": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=9aa3de802d6b103dc3fc6d0acaf1210092619ba313cf5f129d6e2aaa7c8f79d83661a18e0fcd916ec9d08aef17dcd7ec",
            "DIANKey": "9aa3de802d6b103dc3fc6d0acaf1210092619ba313cf5f129d6e2aaa7c8f79d83661a18e0fcd916ec9d08aef17dcd7ec",
            "UniqueID": "2d6ab937-3b29-4b79-89d3-6d9b541711bb",
            "Observaciones": "Descuento por pronto pago canon de octubre",
            "Prefijo": "NC",
            "CausalNotaCreditoDescripcion": "Rebaja o descuento parcial o total",
            "EstadoNotaNombre": "Aprobada",
            "EstadoDocumentoElectronicoNombre": "Aceptado",
            "CausalRechazoDocumentoDescripcion": null,
            "FacturaDIANKey": "69b7d0712bb239608b1429c29653d22e7de36b2d92303497be3845721523f50436d17e9b72a4146d0e701a35ecb5f165",
            "FacturaUniqueID": "57bd2b7e-73fa-42c8-aa1d-89aca45dc02e",
            "FacturaPrefijoConsecutivo": "FV-1520",
            "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.