Consulta detallada

{
  "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41"
}

{
    "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": []
}

{
  "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41"
}

{
    "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": []
}

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.

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

GUID

required

Identificador único de la nota crédito.

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

int

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

GUID

Identificador único de la nota crédito.

string

Prefijo de la nota crédito.

int

Consecutivo de la nota crédito.

datetime

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

datetime

Fecha de vencimiento de la nota crédito.

string

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

string

Observaciones de la nota crédito.

string

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

string

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

decimal

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

decimal

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

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

string

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

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

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).

string

Nombre del mandante del detalle, si aplica.

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

number

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

array

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

array

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

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.

array

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

{
  "UniqueID": "c7f20e93-41ab-4d6c-8e15-3b9a0d2f6c41"
}

{
    "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": []
}

Primeros pasos

CRM

Facturación

Custodia

Común

Consulta detallada

Prerequisitos

Consultar nota crédito individual

Respuesta

Encabezado

Estado

Factura relacionada

Detalles y relacionados

​Prerequisitos

​Consultar nota crédito individual

​Respuesta

​Encabezado

​Estado

​Factura relacionada

​Detalles y relacionados

Prerequisitos

Consultar nota crédito individual

Respuesta

Encabezado

Estado

Factura relacionada

Detalles y relacionados