> ## 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 detallada

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](https://tech.sedierp.com/quickstart.md).

## 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](https://tech.sedierp.com/quickstart.md)
* 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

**UniqueID** `GUID` *required*

Identificador único de la nota débito.

```bash theme={null}
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

**NotaDebitoID** `int`

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

**UniqueID** `GUID`

Identificador único de la nota débito.

**Prefijo** `string`

Prefijo de la nota débito.

**Consecutivo** `int`

Consecutivo de la nota débito.

**FechaCreacion** `datetime`

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

**FechaVencimiento** `datetime`

Fecha de vencimiento de la nota débito.

**CausalNotaDebitoNombre** `string`

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

**Observaciones** `string`

Observaciones de la nota débito.

**PlantillaDocumentoNombre** `string`

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

**UsuarioNombreCompleto** `string`

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

**ValorNeto** `decimal`

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

**ValorImpuestos** `decimal`

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

**MonedaAbreviatura** `string`

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

#### Estado

**EstadoDocumentoElectronicoID** `int`

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

**EstadoDocumentoElectronicoNombre** `string`

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

**CUFE** `string`

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

**QR** `string`

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

**RespuestaFacturacionElectronica** `object`

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

**FechaAnulacion** `datetime`

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

**ObservacionesAnulacion** `string`

Observaciones de la anulación, si aplica.

#### Factura relacionada

**Factura** `object`

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

**propiedades**

**Consecutivo** `int`

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

**FechaCreacion** `datetime`

Fecha de creación de la factura.

**FechaVencimiento** `datetime`

Fecha de vencimiento de la factura.

**ValorNeto** `decimal`

Valor neto de la factura.

**ValorImpuestos** `decimal`

Valor de los impuestos de la factura.

**EstadoFacturaNombre** `string`

Nombre del estado de la factura.

**TipoOperacionNombre** `string`

Nombre del tipo de operación de la factura.

**FormaPagoNombre** `string`

Nombre de la forma de pago de la factura.

**NombreCompleto** `string`

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

**AbreviaturaDocumento** `string`

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

**Email** `string`

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

**MonedaAbreviatura** `string`

Código de la moneda de la factura.

**TipoFactura** `object`

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

#### Detalles y relacionados

**NotasDebitoDetalles** `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.

**propiedades**

**NotaDebitoDetalleID** `int`

Código único del detalle (ID).

**Concepto** `string`

Concepto o descripción del detalle.

**Cantidad** `number`

Cantidad del concepto.

**ValorUnitario** `number`

Valor unitario del concepto.

**Valor** `number`

Valor total del detalle (ValorUnitario × Cantidad).

**Impuestos** `array`

Impuestos del detalle.

**propiedades**

**ImpuestoID** `int`

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

**ImpuestoNombre** `string`

Nombre del impuesto.

**Porcentaje** `number`

Porcentaje del impuesto.

**ValorImpuesto** `number`

Valor del impuesto en la nota débito.

**ValorImpuestoFactura** `number`

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

**NotasDebitoAnexos** `array`

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

**NotasDebitoAprobacionesJerarquias** `array`

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

**propiedades**

**Orden** `int`

Orden del nivel de aprobación.

**RolNombre** `string`

Nombre del rol que debe aprobar en este nivel.

**EstadoAprobacionNotaDebitoID** `int`

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

**EstadoAprobacionNotaDebitoNombre** `string`

Nombre del estado de aprobación del nivel.

**Fecha** `datetime`

Fecha de la aprobación o rechazo del nivel.

**Observaciones** `string`

Observaciones registradas en el nivel de aprobación.

**UsuarioNombreCompleto** `string`

Nombre del usuario asociado al nivel de aprobación.

```json Request theme={null}
{
  "UniqueID": "9b14d6e2-7f30-4a85-b2c9-1e6d8a4f0c73"
}
```

```json Response theme={null}
{
    "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
        }
    ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.