> ## 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 crédito 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 crédito 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 crédito (UniqueID) obtenido del servicio de consulta de notas crédito

## Consultar nota crédito individual

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/NotaCreditoEspecificaConsultar\
**Tipo:** POST \
**Content Type:** application/json

**UniqueID** `GUID` *required*

Identificador único de la nota crédito.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaCreditoEspecificaConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41"
}'
```

### Respuesta

El servicio retorna un objeto con la información completa de la nota crédito. Si no existe una nota crédito 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

**NotaCreditoID** `int`

Código único de la nota crédito (ID).

**UniqueID** `GUID`

Identificador único de la nota crédito.

**Prefijo** `string`

Prefijo de la nota crédito.

**Consecutivo** `int`

Consecutivo de la nota crédito.

**FechaCreacion** `datetime`

Fecha de creación de la nota crédito.

**FechaVencimiento** `datetime`

Fecha de vencimiento de la nota crédito.

**CausalNotaCreditoNombre** `string`

Descripción de la causal de la nota crédito.

**Observaciones** `string`

Observaciones de la nota crédito.

**PlantillaDocumentoNombre** `string`

Nombre de la plantilla de documento de la nota crédito.

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró la nota crédito.

**ValorNeto** `decimal`

Valor neto de la nota crédito (antes de impuestos).

**ValorImpuestos** `decimal`

Valor total de los impuestos de la nota crédito.

#### 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 crédito.

**QR** `string`

Contenido del código QR de la nota crédito 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 crédito, 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 crédito.

**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

**NotasCreditoDetalles** `array`

Detalles de la nota crédito. 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**

**NotaCreditoDetalleID** `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).

**MandanteNombreCompleto** `string`

Nombre del mandante del detalle, si aplica.

**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 crédito.

**ValorImpuestoFactura** `number`

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

**NotasCreditoAnexos** `array`

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

**NotasCreditoAprobacionesJerarquias** `array`

Estado de cada nivel de la jerarquía de aprobación de la nota crédito.

**propiedades**

**Orden** `int`

Orden del nivel de aprobación.

**RolNombre** `string`

Nombre del rol que debe aprobar en este nivel.

**EstadoAprobacionNotaCreditoID** `int`

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

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

**NotasCreditoRecargosDescuentos** `array`

Recargos y descuentos generales de la nota crédito: `TipoRecargoDescuentoNombre`, `Concepto` y `Valor`.

```json Request theme={null}
{
  "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41"
}
```

```json Response theme={null}
{
    "NotaCreditoID": 3127,
    "Consecutivo": 245,
    "EstadoNotaID": 1,
    "TipoDocumentoContableID": 12,
    "FechaCreacion": "2026-11-05T09:12:44.317",
    "FechaVencimiento": "2026-11-08T09:12:44.317",
    "UsuarioID": 37,
    "SucursalID": 1,
    "FacturaID": 15873,
    "NoReferenciada": null,
    "ValorNeto": 450000,
    "ValorImpuestos": 85500,
    "AnulaUsuarioID": null,
    "FechaAnulacion": null,
    "ObservacionesAnulacion": null,
    "CausalRechazoDocumentoID": null,
    "PlantillaDocumentoID": 5,
    "CUFE": "6e4cd73a68a794357fdb53da488a718475576787258df00bc30089983783e4b960472c890d6413ae87ec08dde13d8627",
    "QR": null,
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAplicationResponse": null,
    "RutaAttachedDocument": null,
    "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 1,
    "CausalNotaCreditoID": 2,
    "Observaciones": "Devolución parcial de la factura FE-1520",
    "DispercionSMS": null,
    "DocumentoContableID": null,
    "TerceroID": 4521,
    "MonedaID": 1,
    "Prefijo": "NC",
    "EstadoDocumentoElectronicoNombre": "PENDIENTE",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "CausalNotaCreditoNombre": "Devolución de parte de los bienes; no aceptación de partes del servicio",
    "PlantillaDocumentoNombre": "NOTA CREDITO",
    "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"
        }
    },
    "NotasCreditoDetalles": [
        {
            "NotaCreditoDetalleID": 6410,
            "FacturaDetalleID": null,
            "MandanteTerceroID": null,
            "Cantidad": 1,
            "Concepto": "LICENCIA ANUAL MODULO CONTABLE",
            "Valor": 450000,
            "ValorUnitario": 450000,
            "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,
            "MandanteNombreCompleto": null,
            "ProductoAbreviatura": null,
            "AIU": false,
            "Impuestos": [
                {
                    "NotaCreditoDetalleImpuestoID": 7741,
                    "FacturaDetalleImpuestoID": null,
                    "ImpuestoID": 1,
                    "ValorImpuesto": 85500,
                    "ValorImpuestoFactura": null,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19
                }
            ]
        }
    ],
    "NotasCreditoAnexos": [],
    "NotasCreditoAprobacionesJerarquias": [
        {
            "NotaCreditoAprobacionJerarquiaID": 812,
            "RolID": 4,
            "Orden": 1,
            "EstadoAprobacionNotaCreditoID": 1,
            "UsuarioID": null,
            "Fecha": null,
            "Observaciones": null,
            "RolNombre": "CONTADOR",
            "EstadoAprobacionNotaCreditoNombre": "Pendiente de aprobación",
            "UsuarioNombreCompleto": null
        }
    ],
    "NotasCreditoRecargosDescuentos": []
}
```


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