Consulta general

{
  "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
}

{
    "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
}

{
  "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
}

{
    "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
}

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.

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

Consultar notas débito

Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/NotasDebitoConsultar
Tipo: POST
Content Type: application/json

int

Página de consulta, por defecto (1).

int

Cantidad de registros por página de consulta, por defecto (10). El máximo permitido es 30 registros por página.

GUID

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

GUID

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

int

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

string

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

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.

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.

string

Filtro de búsqueda por cualquier parte del nombre o razón social del cliente.

string

Filtro de búsqueda por número de identificación exacto del cliente, sin dígito de verificación.

string

Filtro de búsqueda por email del usuario que registró la nota débito.

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.

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:

int

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

string

Prefijo de la nota débito.

int

Consecutivo de la nota débito.

datetime

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

datetime

Fecha de vencimiento de la nota débito.

decimal

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

string

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

GUID

Identificador único de la nota débito.

string

Nombre del estado de la nota débito.

string

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

string

Prefijo de la factura de venta relacionada.

int

Consecutivo de la factura de venta relacionada.

datetime

Fecha de creación de la factura de venta relacionada.

decimal

Valor total de la factura de venta relacionada (valor neto + valor de impuestos).

string

Nombre completo o razón social del cliente.

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.

string

Correo electrónico del cliente.

string

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

int

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

{
  "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
}

{
    "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
}

Primeros pasos

CRM

Facturación

Custodia

Común

Prerequisitos

Consultar notas débito

Respuesta

​Prerequisitos

​Consultar notas débito

​Respuesta

Prerequisitos

Consultar notas débito

Respuesta