Consulta detallada

{
  "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73"
}

{
    "NotaDebitoID": 418,
    "Consecutivo": 87,
    "EstadoNotaID": 1,
    "TipoDocumentoContableID": 14,
    "FechaCreacion": "2026-11-06T14:20:05.533",
    "FechaVencimiento": "2026-11-09T14:20:05.533",
    "UsuarioID": 37,
    "SucursalID": 1,
    "FacturaID": 15873,
    "ValorNeto": 75000,
    "ValorImpuestos": 9500,
    "AnulaUsuarioID": null,
    "FechaAnulacion": null,
    "ObservacionesAnulacion": null,
    "CausalRechazoDocumentoID": null,
    "PlantillaDocumentoID": 6,
    "Ruta": null,
    "CUFE": "e42966a2ecf5769a418fd9aa41c1480546066833a69d88b13bf3606c35928f2871a96a2b21e798effc49ecfb959fee27",
    "QR": null,
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAplicationResponse": null,
    "RutaAttachedDocument": null,
    "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 1,
    "CausalNotaDebitoID": 4,
    "Observaciones": "Gastos de cobranza e intereses de la factura FE-1520",
    "DispercionSMS": null,
    "NoReferenciada": null,
    "DocumentoContableID": null,
    "TerceroID": 4521,
    "MonedaID": 1,
    "Prefijo": "ND",
    "EstadoDocumentoElectronicoNombre": "PENDIENTE",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "CausalNotaDebitoNombre": "Gastos por cobrar",
    "PlantillaDocumentoNombre": "NOTA DEBITO",
    "MonedaNombre": "Peso colombiano",
    "MonedaSimbolo": "$",
    "MonedaAbreviatura": "COP",
    "ClienteID": 2210,
    "Factura": {
        "Consecutivo": 1520,
        "EstadoDocumentoElectronicoID": 2,
        "TipoOperacionID": 2,
        "TipoOperacionNombre": "Estándar",
        "FechaCreacion": "2026-11-04T10:30:00",
        "FechaVencimiento": "2026-12-04T00:00:00",
        "ValorNeto": 750000,
        "ValorImpuestos": 130500,
        "Nombres": "CLIENTE EJEMPLO S.A.S.",
        "Nombres2": null,
        "Apellidos": null,
        "Apellidos2": null,
        "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
        "Documento": "900123456",
        "Direccion": "CALLE 100 # 15-20",
        "Telefono": null,
        "Celular": "3001234567",
        "Email": "facturacion@clienteejemplo.com",
        "EmailFacturacionElectronica": "facturacion@clienteejemplo.com",
        "TipoDocumentoNombre": "NIT",
        "AbreviaturaDocumento": "NIT. 900.123.456-7",
        "CodigoOrigen": null,
        "CodigoOrigenDescripcion": "API",
        "CentroCostoNombre": null,
        "MonedaID": 1,
        "TasaCambio": null,
        "MonedaNombre": "Peso colombiano",
        "MonedaSimbolo": "$",
        "MonedaAbreviatura": "COP",
        "EstadoFacturaNombre": "PENDIENTE",
        "AreaDepartamentoCliente": "ADMINISTRACION",
        "FormaPagoNombre": "Crédito",
        "TipoFactura": {
            "Prefijo": "FE",
            "NumeroDecimales": 2,
            "NumeroDecimalesCantidad": 2,
            "DiasVencimientoFecha1": 30,
            "Descripcion": "FE - 1 a 5000 - N°: 18764000000001"
        }
    },
    "NotasDebitoDetalles": [
        {
            "NotaDebitoDetalleID": 905,
            "FacturaDetalleID": null,
            "Concepto": "GASTOS DE COBRANZA",
            "Cantidad": 1,
            "Valor": 50000,
            "ValorUnitario": 50000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": [
                {
                    "NotaDebitoDetalleImpuestoID": 1288,
                    "FacturaDetalleImpuestoID": null,
                    "ImpuestoID": 1,
                    "ValorImpuesto": 9500,
                    "ValorImpuestoFactura": null,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19
                }
            ]
        },
        {
            "NotaDebitoDetalleID": 906,
            "FacturaDetalleID": null,
            "Concepto": "INTERESES DE MORA",
            "Cantidad": 1,
            "Valor": 25000,
            "ValorUnitario": 25000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": []
        }
    ],
    "NotasDebitoAnexos": [],
    "NotasDebitoAprobacionesJerarquias": [
        {
            "NotaDebitoAprobacionJerarquiaID": 233,
            "RolID": 4,
            "Orden": 1,
            "EstadoAprobacionNotaDebitoID": 1,
            "UsuarioID": null,
            "Fecha": null,
            "Observaciones": null,
            "RolNombre": "CONTADOR",
            "EstadoAprobacionNotaDebitoNombre": "Pendiente de aprobación",
            "UsuarioNombreCompleto": null
        }
    ]
}

{
  "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73"
}

{
    "NotaDebitoID": 418,
    "Consecutivo": 87,
    "EstadoNotaID": 1,
    "TipoDocumentoContableID": 14,
    "FechaCreacion": "2026-11-06T14:20:05.533",
    "FechaVencimiento": "2026-11-09T14:20:05.533",
    "UsuarioID": 37,
    "SucursalID": 1,
    "FacturaID": 15873,
    "ValorNeto": 75000,
    "ValorImpuestos": 9500,
    "AnulaUsuarioID": null,
    "FechaAnulacion": null,
    "ObservacionesAnulacion": null,
    "CausalRechazoDocumentoID": null,
    "PlantillaDocumentoID": 6,
    "Ruta": null,
    "CUFE": "e42966a2ecf5769a418fd9aa41c1480546066833a69d88b13bf3606c35928f2871a96a2b21e798effc49ecfb959fee27",
    "QR": null,
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAplicationResponse": null,
    "RutaAttachedDocument": null,
    "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 1,
    "CausalNotaDebitoID": 4,
    "Observaciones": "Gastos de cobranza e intereses de la factura FE-1520",
    "DispercionSMS": null,
    "NoReferenciada": null,
    "DocumentoContableID": null,
    "TerceroID": 4521,
    "MonedaID": 1,
    "Prefijo": "ND",
    "EstadoDocumentoElectronicoNombre": "PENDIENTE",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "CausalNotaDebitoNombre": "Gastos por cobrar",
    "PlantillaDocumentoNombre": "NOTA DEBITO",
    "MonedaNombre": "Peso colombiano",
    "MonedaSimbolo": "$",
    "MonedaAbreviatura": "COP",
    "ClienteID": 2210,
    "Factura": {
        "Consecutivo": 1520,
        "EstadoDocumentoElectronicoID": 2,
        "TipoOperacionID": 2,
        "TipoOperacionNombre": "Estándar",
        "FechaCreacion": "2026-11-04T10:30:00",
        "FechaVencimiento": "2026-12-04T00:00:00",
        "ValorNeto": 750000,
        "ValorImpuestos": 130500,
        "Nombres": "CLIENTE EJEMPLO S.A.S.",
        "Nombres2": null,
        "Apellidos": null,
        "Apellidos2": null,
        "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
        "Documento": "900123456",
        "Direccion": "CALLE 100 # 15-20",
        "Telefono": null,
        "Celular": "3001234567",
        "Email": "facturacion@clienteejemplo.com",
        "EmailFacturacionElectronica": "facturacion@clienteejemplo.com",
        "TipoDocumentoNombre": "NIT",
        "AbreviaturaDocumento": "NIT. 900.123.456-7",
        "CodigoOrigen": null,
        "CodigoOrigenDescripcion": "API",
        "CentroCostoNombre": null,
        "MonedaID": 1,
        "TasaCambio": null,
        "MonedaNombre": "Peso colombiano",
        "MonedaSimbolo": "$",
        "MonedaAbreviatura": "COP",
        "EstadoFacturaNombre": "PENDIENTE",
        "AreaDepartamentoCliente": "ADMINISTRACION",
        "FormaPagoNombre": "Crédito",
        "TipoFactura": {
            "Prefijo": "FE",
            "NumeroDecimales": 2,
            "NumeroDecimalesCantidad": 2,
            "DiasVencimientoFecha1": 30,
            "Descripcion": "FE - 1 a 5000 - N°: 18764000000001"
        }
    },
    "NotasDebitoDetalles": [
        {
            "NotaDebitoDetalleID": 905,
            "FacturaDetalleID": null,
            "Concepto": "GASTOS DE COBRANZA",
            "Cantidad": 1,
            "Valor": 50000,
            "ValorUnitario": 50000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": [
                {
                    "NotaDebitoDetalleImpuestoID": 1288,
                    "FacturaDetalleImpuestoID": null,
                    "ImpuestoID": 1,
                    "ValorImpuesto": 9500,
                    "ValorImpuestoFactura": null,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19
                }
            ]
        },
        {
            "NotaDebitoDetalleID": 906,
            "FacturaDetalleID": null,
            "Concepto": "INTERESES DE MORA",
            "Cantidad": 1,
            "Valor": 25000,
            "ValorUnitario": 25000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": []
        }
    ],
    "NotasDebitoAnexos": [],
    "NotasDebitoAprobacionesJerarquias": [
        {
            "NotaDebitoAprobacionJerarquiaID": 233,
            "RolID": 4,
            "Orden": 1,
            "EstadoAprobacionNotaDebitoID": 1,
            "UsuarioID": null,
            "Fecha": null,
            "Observaciones": null,
            "RolNombre": "CONTADOR",
            "EstadoAprobacionNotaDebitoNombre": "Pendiente de aprobación",
            "UsuarioNombreCompleto": null
        }
    ]
}

El servicio permite a los usuarios consultar toda la información de una nota débito específica a partir de su identificador único, en línea en formato JSON. La respuesta incluye el encabezado, la factura relacionada, los detalles con sus impuestos, los anexos y el estado de la jerarquía de aprobación. 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 una nota débito individual, se debe contar con los siguientes datos:

Token solicitado mediante el API de autenticación
Identificador único de la nota débito (UniqueID) obtenido del servicio de consulta de notas débito

Consultar nota débito individual

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

GUID

required

Identificador único de la nota débito.

curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaDebitoEspecificaConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73"
}'

Respuesta

El servicio retorna un objeto con la información completa de la nota débito. Si no existe una nota débito con el UniqueID enviado, retorna un objeto vacío {}. A continuación se describen los campos principales; la respuesta incluye además campos de uso interno de la plataforma.

Encabezado

int

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

GUID

Identificador único de la nota débito.

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.

string

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

string

Observaciones de la nota débito.

string

Nombre de la plantilla de documento de la nota débito.

string

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

decimal

Valor neto de la nota débito (antes de impuestos).

decimal

Valor total de los impuestos de la nota débito.

string

Código de la moneda. MonedaNombre y MonedaSimbolo contienen el nombre y el símbolo de la moneda.

Estado

int

Código del estado del documento electrónico ante la DIAN.

string

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

string

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

string

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

object

Respuesta del proceso de facturación electrónica. Retorna un objeto vacío si no hay respuesta registrada.

datetime

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

string

Observaciones de la anulación, si aplica.

Factura relacionada

object

Información de la factura de venta a la cual se le registró la nota débito.

Show propiedades

int

Consecutivo de la factura. El prefijo se encuentra en TipoFactura.Prefijo.

datetime

Fecha de creación de la factura.

datetime

Fecha de vencimiento de la factura.

decimal

Valor neto de la factura.

decimal

Valor de los impuestos de la factura.

string

Nombre del estado de la factura.

string

Nombre del tipo de operación de la factura.

string

Nombre de la forma de pago de la factura.

string

Nombre completo o razón social del cliente. Nombres, Nombres2, Apellidos y Apellidos2 contienen los nombres y apellidos por separado.

string

Tipo y número de identificación del cliente con formato (ej. “NIT. 900.123.456-7”).

string

Correo electrónico del cliente. EmailFacturacionElectronica contiene el correo para documentos electrónicos.

string

Código de la moneda de la factura.

object

Resolución de facturación de la factura: Prefijo, NumeroDecimales, NumeroDecimalesCantidad, DiasVencimientoFecha1 y Descripcion.

Detalles y relacionados

array

Detalles de la nota débito. Los campos de la factura (FacturaDetalleID, ProductoNombre, FacturaCantidad, FacturaValorUnitario, ValorTotal, Descuento) solo se diligencian cuando el detalle está asociado a un detalle de la factura.

Show propiedades

int

Código único del detalle (ID).

string

Concepto o descripción del detalle.

number

Cantidad del concepto.

number

Valor unitario del concepto.

number

Valor total del detalle (ValorUnitario × Cantidad).

array

Impuestos del detalle.

Show propiedades

int

Código único del impuesto en la plataforma (ID).

string

Nombre del impuesto.

number

Porcentaje del impuesto.

number

Valor del impuesto en la nota débito.

number

Valor del impuesto en el detalle de la factura, cuando el detalle está asociado a la factura.

array

Archivos anexos de la nota débito: Nombre y Url para visualizar o descargar el archivo.

array

Estado de cada nivel de la jerarquía de aprobación de la nota débito.

Show propiedades

int

Orden del nivel de aprobación.

string

Nombre del rol que debe aprobar en este nivel.

int

Código del estado de aprobación del nivel.

string

Nombre del estado de aprobación del nivel.

datetime

Fecha de la aprobación o rechazo del nivel.

string

Observaciones registradas en el nivel de aprobación.

string

Nombre del usuario asociado al nivel de aprobación.

{
  "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73"
}

{
    "NotaDebitoID": 418,
    "Consecutivo": 87,
    "EstadoNotaID": 1,
    "TipoDocumentoContableID": 14,
    "FechaCreacion": "2026-11-06T14:20:05.533",
    "FechaVencimiento": "2026-11-09T14:20:05.533",
    "UsuarioID": 37,
    "SucursalID": 1,
    "FacturaID": 15873,
    "ValorNeto": 75000,
    "ValorImpuestos": 9500,
    "AnulaUsuarioID": null,
    "FechaAnulacion": null,
    "ObservacionesAnulacion": null,
    "CausalRechazoDocumentoID": null,
    "PlantillaDocumentoID": 6,
    "Ruta": null,
    "CUFE": "e42966a2ecf5769a418fd9aa41c1480546066833a69d88b13bf3606c35928f2871a96a2b21e798effc49ecfb959fee27",
    "QR": null,
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAplicationResponse": null,
    "RutaAttachedDocument": null,
    "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 1,
    "CausalNotaDebitoID": 4,
    "Observaciones": "Gastos de cobranza e intereses de la factura FE-1520",
    "DispercionSMS": null,
    "NoReferenciada": null,
    "DocumentoContableID": null,
    "TerceroID": 4521,
    "MonedaID": 1,
    "Prefijo": "ND",
    "EstadoDocumentoElectronicoNombre": "PENDIENTE",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "CausalNotaDebitoNombre": "Gastos por cobrar",
    "PlantillaDocumentoNombre": "NOTA DEBITO",
    "MonedaNombre": "Peso colombiano",
    "MonedaSimbolo": "$",
    "MonedaAbreviatura": "COP",
    "ClienteID": 2210,
    "Factura": {
        "Consecutivo": 1520,
        "EstadoDocumentoElectronicoID": 2,
        "TipoOperacionID": 2,
        "TipoOperacionNombre": "Estándar",
        "FechaCreacion": "2026-11-04T10:30:00",
        "FechaVencimiento": "2026-12-04T00:00:00",
        "ValorNeto": 750000,
        "ValorImpuestos": 130500,
        "Nombres": "CLIENTE EJEMPLO S.A.S.",
        "Nombres2": null,
        "Apellidos": null,
        "Apellidos2": null,
        "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
        "Documento": "900123456",
        "Direccion": "CALLE 100 # 15-20",
        "Telefono": null,
        "Celular": "3001234567",
        "Email": "facturacion@clienteejemplo.com",
        "EmailFacturacionElectronica": "facturacion@clienteejemplo.com",
        "TipoDocumentoNombre": "NIT",
        "AbreviaturaDocumento": "NIT. 900.123.456-7",
        "CodigoOrigen": null,
        "CodigoOrigenDescripcion": "API",
        "CentroCostoNombre": null,
        "MonedaID": 1,
        "TasaCambio": null,
        "MonedaNombre": "Peso colombiano",
        "MonedaSimbolo": "$",
        "MonedaAbreviatura": "COP",
        "EstadoFacturaNombre": "PENDIENTE",
        "AreaDepartamentoCliente": "ADMINISTRACION",
        "FormaPagoNombre": "Crédito",
        "TipoFactura": {
            "Prefijo": "FE",
            "NumeroDecimales": 2,
            "NumeroDecimalesCantidad": 2,
            "DiasVencimientoFecha1": 30,
            "Descripcion": "FE - 1 a 5000 - N°: 18764000000001"
        }
    },
    "NotasDebitoDetalles": [
        {
            "NotaDebitoDetalleID": 905,
            "FacturaDetalleID": null,
            "Concepto": "GASTOS DE COBRANZA",
            "Cantidad": 1,
            "Valor": 50000,
            "ValorUnitario": 50000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": [
                {
                    "NotaDebitoDetalleImpuestoID": 1288,
                    "FacturaDetalleImpuestoID": null,
                    "ImpuestoID": 1,
                    "ValorImpuesto": 9500,
                    "ValorImpuestoFactura": null,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19
                }
            ]
        },
        {
            "NotaDebitoDetalleID": 906,
            "FacturaDetalleID": null,
            "Concepto": "INTERESES DE MORA",
            "Cantidad": 1,
            "Valor": 25000,
            "ValorUnitario": 25000,
            "CodigoExterno": null,
            "Orden": null,
            "ProductoID": null,
            "ProductoNombre": null,
            "FacturaCantidad": null,
            "FacturaValorUnitario": null,
            "ValorDiario": null,
            "ValorTotal": null,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": []
        }
    ],
    "NotasDebitoAnexos": [],
    "NotasDebitoAprobacionesJerarquias": [
        {
            "NotaDebitoAprobacionJerarquiaID": 233,
            "RolID": 4,
            "Orden": 1,
            "EstadoAprobacionNotaDebitoID": 1,
            "UsuarioID": null,
            "Fecha": null,
            "Observaciones": null,
            "RolNombre": "CONTADOR",
            "EstadoAprobacionNotaDebitoNombre": "Pendiente de aprobación",
            "UsuarioNombreCompleto": null
        }
    ]
}

Primeros pasos

CRM

Facturación

Custodia

Común

Consulta detallada

Prerequisitos

Consultar nota débito individual

Respuesta

Encabezado

Estado

Factura relacionada

Detalles y relacionados

​Prerequisitos

​Consultar nota débito individual

​Respuesta

​Encabezado

​Estado

​Factura relacionada

​Detalles y relacionados

Prerequisitos

Consultar nota débito individual

Respuesta

Encabezado

Estado

Factura relacionada

Detalles y relacionados