Skip to main content
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.

​
Prerequisitos

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

​
Consultar notas crédito

Request URL: https://portal.sedierp.com/API_FAC/api/NotasCredito/NotasCreditoConsultar
Tipo: POST
Content Type: application/json
​
int
required
Código único del cliente (ID) que inició sesión. Se obtiene del campo TerceroID del servicio de datos del cliente. El servicio retorna las notas crédito de las facturas de este cliente.
​
int
Página de consulta. Es obligatorio cuando se envía 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.
​
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.
​
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.
​
int
Filtro de búsqueda por consecutivo exacto de la nota crédito.
​
int
Filtro de búsqueda por rango de consecutivos, desde el consecutivo indicado (inclusive).
​
int
Filtro de búsqueda por rango de consecutivos, hasta el consecutivo indicado (inclusive).
​
int
Filtro de búsqueda por código del estado de la nota crédito (ID).
​
string
Filtro de búsqueda por prefijo exacto de la factura relacionada (ej. “FV”). Máximo 10 caracteres.
​
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”).
​
string
Filtro de búsqueda por código del registro que originó la factura relacionada, según su origen. Debe ser numérico.
​
GUID
Filtro de búsqueda por identificador único de la factura relacionada.

​
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:
​
string
Sigla del tipo de documento contable de la nota crédito.
​
int
Consecutivo de la nota crédito.
​
datetime
Fecha de creación de la nota crédito.
​
date
Fecha de vencimiento de la nota crédito.
​
decimal
Valor neto de la nota crédito.
​
decimal
Valor de los impuestos de la nota crédito.
​
string
Observaciones de la nota crédito.
​
string
Descripción de la causal de la nota crédito.
​
string
Nombre del estado de la nota crédito.
​
string
Nombre del estado del documento electrónico ante la DIAN.
​
string
Descripción de la causal de rechazo del documento electrónico, cuando aplica.
​
date
Fecha de anulación de la nota crédito, cuando aplica.
​
string
Observaciones de la anulación, cuando aplica.
​
string
CUDE de la nota crédito.
​
string
Contenido del código QR de la nota crédito electrónica.
​
GUID
Identificador único de la nota crédito.
​
string
Prefijo y consecutivo de la factura relacionada (ej. “FV-1520”).
​
string
CUFE de la factura relacionada.
​
GUID
Identificador único de la factura relacionada.
​
string
Descripción del origen de la factura relacionada.
​
int
Cantidad total de registros que cumplen con los filtros de la consulta.