> ## 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 de ajuste específica, al documento soporte en adquisiciones efectuadas a no obligados a expedir factura de venta, a partir de su identificador único, en línea en formato JSON. La respuesta incluye el encabezado, el documento soporte relacionado, los datos del proveedor, los detalles con sus impuestos y los recargos y descuentos.

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 de ajuste 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 de ajuste (UniqueID) obtenido del servicio de consulta de notas de ajuste

## Consultar nota de ajuste individual

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

**UniqueID** `GUID` *required*

Identificador único de la nota de ajuste.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaAjusteNoObligadosEspecificoConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8"
}'
```

### Respuesta

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

**DocumentoSoporteAjusteID** `int`

Código único de la nota de ajuste (ID).

**UniqueID** `GUID`

Identificador único de la nota de ajuste.

**Prefijo** `string`

Prefijo de la nota de ajuste.

**Consecutivo** `int`

Consecutivo de la nota de ajuste.

**FechaCreacion** `datetime`

Fecha de emisión de la nota de ajuste.

**CausalDocumentoSoporteAjusteID** `int`

Código del concepto de corrección de la nota de ajuste.

**CausalDocumentoSoporteAjusteNombre** `string`

Descripción del concepto de corrección de la nota de ajuste.

**Observaciones** `string`

Observaciones de la nota de ajuste.

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró la nota de ajuste.

**ValorNeto** `decimal`

Valor neto de la nota de ajuste (antes de impuestos).

**ValorImpuestos** `decimal`

Valor total de los impuestos y retenciones de la nota de ajuste.

**NumeroDecimales** `int`

Número de decimales configurado para los valores en la resolución del documento soporte. `NumeroDecimalesCantidad` contiene los decimales para las cantidades.

#### Documento soporte relacionado

**DocumentoSoporteID** `int`

Código único del documento soporte relacionado (ID).

**DocumentoSoportePrefijo** `string`

Prefijo del documento soporte relacionado.

**DocumentoSoporteConsecutivo** `int`

Consecutivo del documento soporte relacionado.

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

**CUDS** `string`

Código Único de Documento Soporte asignado a la nota de ajuste.

**QR** `string`

Contenido del código QR de la nota de ajuste.

**RespuestaFacturacionElectronica** `object`

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

**IsEdicionDocumento** `bool`

Indica si la nota de ajuste aún puede ser editada.

#### Proveedor

**NombreCompleto** `string`

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

**TipoDocumentoNombre** `string`

Nombre del tipo de documento de identificación del proveedor.

**Documento** `string`

Número de identificación del proveedor.

**AbreviaturaDocumento** `string`

Tipo y número de identificación del proveedor con formato (ej. "NIT. 1.020.304.050-8"). Para NIT incluye el dígito de verificación.

**Direccion** `string`

Dirección del proveedor.

**Telefono** `string`

Teléfono del proveedor.

**Celular** `string`

Celular del proveedor.

**Email** `string`

Correo electrónico del proveedor.

**EmailFacturacionElectronica** `string`

Correo electrónico del proveedor para documentos electrónicos.

#### Detalles y relacionados

**DocumentosSoporteAjustesDetalles** `array`

Detalles de la nota de ajuste, copiados del documento soporte relacionado y ordenados por el campo `Orden`.

**propiedades**

**DocumentoSoporteAjusteDetalleID** `int`

Código único del detalle (ID).

**ProductoNombre** `string`

Nombre o descripción del detalle.

**Cantidad** `number`

Cantidad del detalle.

**UnidadProductoNombre** `string`

Nombre de la unidad de medida del producto.

**ValorUnitario** `number`

Valor unitario del detalle.

**Descuento** `number`

Valor del descuento del detalle.

**ValorTotal** `number`

Valor total del detalle.

**Orden** `int`

Orden del detalle (número de posición).

**CodigoExterno** `string`

Código único del detalle del documento soporte del cual se copió este detalle.

**Impuestos** `array`

Impuestos y retenciones del detalle.

**propiedades**

**CodigoDIAN** `string`

Código DIAN del impuesto o retención (ej. "01", "05", "06").

**Nombre** `string`

Nombre del tipo de impuesto o retención.

**Porcentaje** `number`

Porcentaje del impuesto o retención.

**ValorImpuesto** `number`

Valor del impuesto o retención.

**DocumentosSoporteAjustesRecargosDescuentos** `array`

Recargos y descuentos generales de la nota de ajuste.

**propiedades**

**TipoRecargoDescuentoID** `int`

Tipo de recargo o descuento (1: Descuento, 2: Recargo).

**TipoRecargoDescuentoNombre** `string`

Nombre del tipo de recargo o descuento.

**Concepto** `string`

Concepto o descripción del recargo o descuento.

**Valor** `number`

Valor del recargo o descuento.

```json Request theme={null}
{
  "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8"
}
```

```json Response theme={null}
{
    "DocumentoSoporteAjusteID": 58,
    "TipoDocumentoSoporteAjusteID": 2,
    "Consecutivo": 15,
    "TerceroID": 5108,
    "FechaCreacion": "2026-11-05T10:00:00",
    "UsuarioID": 37,
    "SucursalID": 1,
    "ValorNeto": 1360000,
    "ValorImpuestos": -52000,
    "Observaciones": "Anulación del documento soporte DS-312",
    "CUDS": "6f6868a78e27b5fb65b51e6d0a493ed00cd4966af93ec2041f69b9fabdcd453b974e87255aad34406f605b86fab391bb",
    "QR": null,
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAttachedDocument": null,
    "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 1,
    "CausalDocumentoSoporteAjusteID": 2,
    "DocumentoSoporteID": 2045,
    "DocumentoSoporteConsecutivo": 312,
    "DocumentoSoportePrefijo": "DS",
    "Prefijo": "NA",
    "EstadoDocumentoElectronicoNombre": "PENDIENTE",
    "IsEdicionDocumento": false,
    "Nombres": "JUAN",
    "Nombres2": "CARLOS",
    "Apellidos": "RODRIGUEZ",
    "Apellidos2": "LOPEZ",
    "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
    "Documento": "1020304050",
    "Direccion": "CARRERA 7 # 45-10",
    "Telefono": null,
    "Celular": "3109876543",
    "Email": "juan.rodriguez@correo.com",
    "EmailFacturacionElectronica": "juan.rodriguez@correo.com",
    "TipoDocumentoNombre": "NIT",
    "CausalDocumentoSoporteAjusteNombre": "Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente",
    "AbreviaturaDocumento": "NIT. 1.020.304.050-8",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "IsEdicionDocumentoSoporteAjuste": false,
    "NumeroDecimales": 2,
    "NumeroDecimalesCantidad": 2,
    "DocumentosSoporteAjustesDetalles": [
        {
            "DocumentoSoporteAjusteDetalleID": 301,
            "ProductoNombre": "MATERIALES DE PINTURA",
            "Cantidad": 2,
            "ValorUnitario": 85000,
            "ValorTotal": 160000,
            "UnidadProductoID": 10,
            "CodigoExterno": "6120",
            "Orden": 1,
            "Descuento": 10000,
            "DescuentoNoGravado": 0,
            "UnidadProductoNombre": "Galón",
            "Impuestos": [
                {
                    "DocumentoSoporteAjusteDetalleImpuestoID": 410,
                    "DocumentoSoporteAjusteDetalleID": 301,
                    "TipoImpuestoID": 6,
                    "Porcentaje": 2.5,
                    "ValorImpuesto": 4000,
                    "Nombre": "ReteRenta",
                    "CodigoDIAN": "06"
                }
            ]
        },
        {
            "DocumentoSoporteAjusteDetalleID": 302,
            "ProductoNombre": "SERVICIO DE MANTENIMIENTO LOCATIVO",
            "Cantidad": 1,
            "ValorUnitario": 1200000,
            "ValorTotal": 1200000,
            "UnidadProductoID": 1,
            "CodigoExterno": "6121",
            "Orden": 2,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "UnidadProductoNombre": "Unidad",
            "Impuestos": [
                {
                    "DocumentoSoporteAjusteDetalleImpuestoID": 411,
                    "DocumentoSoporteAjusteDetalleID": 302,
                    "TipoImpuestoID": 6,
                    "Porcentaje": 4,
                    "ValorImpuesto": 48000,
                    "Nombre": "ReteRenta",
                    "CodigoDIAN": "06"
                }
            ]
        }
    ],
    "DocumentosSoporteAjustesRecargosDescuentos": [
        {
            "DocumentoSoporteAjusteRecargoDescuentoID": 19,
            "TipoRecargoDescuentoID": 1,
            "Concepto": "DESCUENTO POR PRONTO PAGO",
            "Valor": 20000,
            "TipoRecargoDescuentoNombre": "Descuento"
        }
    ]
}
```


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