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

​
Prerequisitos

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

​
Consultar notas débito

Request URL: https://portal.sedierp.com/API_FAC/api/NotasDebito/NotasDebitoConsultar
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 débito 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 débito, 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 débito, 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 débito.
​
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 débito (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 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:
​
string
Sigla del tipo de documento contable de la nota débito.
​
int
Consecutivo de la nota débito.
​
datetime
Fecha de creación de la nota débito.
​
date
Fecha de vencimiento de la nota débito.
​
decimal
Valor neto de la nota débito.
​
decimal
Valor de los impuestos de la nota débito.
​
string
Observaciones de la nota débito.
​
string
Descripción de la causal de la nota débito.
​
string
Nombre del estado de la nota débito.
​
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 débito, cuando aplica.
​
string
Observaciones de la anulación, cuando aplica.
​
string
CUDE de la nota débito.
​
string
Contenido del código QR de la nota débito electrónica.
​
GUID
Identificador único de la nota débito.
​
string
Prefijo y consecutivo de la factura relacionada (ej. “FV-1533”).
​
string
CUFE de la factura relacionada.
​
GUID
Identificador único de la factura relacionada.
​
string
Nombre del origen 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.