Consulta general

{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
  "FechaInicial": null,
  "FechaFinal": null,
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "Prefijo": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}

{
    "total": 1,
    "rows": [
        {
            "DocumentoSoporteAjusteID": 58,
            "Consecutivo": 15,
            "FechaCreacion": "2026-11-05T10:00:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8",
            "CUDS": "6f6868a78e27b5fb65b51e6d0a493ed00cd4966af93ec2041f69b9fabdcd453b974e87255aad34406f605b86fab391bb",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "NA",
            "ValorNeto": 1360000,
            "ValorImpuestos": -52000,
            "AbreviaturaDocumento": "NIT. 1.020.304.050-8",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
            "DocumentoSoporteConsecutivo": "DS-312",
            "CausalDocumentoSoporteAjusteNombre": "Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente",
            "TotalRows": 1
        }
    ],
    "result": 1
}

{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
  "FechaInicial": null,
  "FechaFinal": null,
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "Prefijo": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}

{
    "total": 1,
    "rows": [
        {
            "DocumentoSoporteAjusteID": 58,
            "Consecutivo": 15,
            "FechaCreacion": "2026-11-05T10:00:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8",
            "CUDS": "6f6868a78e27b5fb65b51e6d0a493ed00cd4966af93ec2041f69b9fabdcd453b974e87255aad34406f605b86fab391bb",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "NA",
            "ValorNeto": 1360000,
            "ValorImpuestos": -52000,
            "AbreviaturaDocumento": "NIT. 1.020.304.050-8",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
            "DocumentoSoporteConsecutivo": "DS-312",
            "CausalDocumentoSoporteAjusteNombre": "Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente",
            "TotalRows": 1
        }
    ],
    "result": 1
}

El servicio permite a los usuarios consultar el listado de notas de ajuste a documentos soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta, en línea en formato JSON. 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 notas de ajuste, se debe contar con los siguientes datos:

Token solicitado mediante el API de autenticación

Consultar notas de ajuste

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

int

Página de consulta, por defecto (1).

int

Cantidad de registros por página de consulta, por defecto (10). El máximo permitido es 30 registros por página.

GUID

Filtro de búsqueda por identificador único de la nota de ajuste.

GUID

Filtro de búsqueda por identificador único del documento soporte relacionado.

string

Filtro de búsqueda por fecha de emisión de la nota de ajuste, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

string

Filtro de búsqueda por fecha de emisión de la nota de ajuste, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

int

Filtro de búsqueda por consecutivo de la nota de ajuste.

int

Filtro de búsqueda por rango de consecutivos, desde el consecutivo indicado (inclusive).

int

Filtro de búsqueda por rango de consecutivos, hasta el consecutivo indicado (inclusive).

string

Filtro de búsqueda por prefijo de la nota de ajuste.

string

Filtro de búsqueda por cualquier parte del nombre o razón social del proveedor.

string

Filtro de búsqueda por número de identificación exacto del proveedor, sin dígito de verificación.

string

Filtro de búsqueda por email del usuario que registró la nota de ajuste.

string

Campo de consulta múltiple. El criterio de búsqueda depende del valor enviado:

Numérico: consulta por el consecutivo de la nota de ajuste o por el número de identificación del proveedor.
Fecha: consulta por la fecha de emisión de la nota de ajuste.
Otro texto: consulta por cualquier parte del nombre o del email del proveedor.

curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaAjusteNoObligadosConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Page": 1,
	"Rows": 10,
	"UniqueID": null,
	"DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
	"FechaInicial": null,
	"FechaFinal": null,
	"Consecutivo": null,
	"ConsecutivoInicial": null,
	"ConsecutivoFinal": null,
	"Prefijo": null,
	"Tercero": null,
	"Identificacion": null,
	"UsuarioEmail": null,
	"FullSearch": null
}'

Respuesta

El servicio retorna el listado de notas de ajuste ordenado por fecha de emisión y consecutivo de forma descendente. Cada registro de rows contiene los siguientes campos:

int

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

string

Prefijo de la nota de ajuste.

int

Consecutivo de la nota de ajuste.

datetime

Fecha de emisión de la nota de ajuste.

GUID

Identificador único de la nota de ajuste.

string

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

string

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

decimal

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

decimal

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

string

Prefijo y consecutivo del documento soporte relacionado (ej. “DS-312”).

GUID

Identificador único del documento soporte relacionado.

string

Nombre completo o razón social del proveedor.

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.

string

Correo electrónico del proveedor.

string

Nombre del usuario que registró la nota de ajuste.

int

Cantidad total de registros que cumplen con los filtros de la consulta.

{
  "Page": 1,
  "Rows": 10,
  "UniqueID": null,
  "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
  "FechaInicial": null,
  "FechaFinal": null,
  "Consecutivo": null,
  "ConsecutivoInicial": null,
  "ConsecutivoFinal": null,
  "Prefijo": null,
  "Tercero": null,
  "Identificacion": null,
  "UsuarioEmail": null,
  "FullSearch": null
}

{
    "total": 1,
    "rows": [
        {
            "DocumentoSoporteAjusteID": 58,
            "Consecutivo": 15,
            "FechaCreacion": "2026-11-05T10:00:00",
            "NombreCompleto": "JUAN CARLOS RODRIGUEZ LOPEZ",
            "UniqueID": "3d7b92a1-5e60-4c1f-9a83-c42e0f6b17d8",
            "CUDS": "6f6868a78e27b5fb65b51e6d0a493ed00cd4966af93ec2041f69b9fabdcd453b974e87255aad34406f605b86fab391bb",
            "Email": "juan.rodriguez@correo.com",
            "Prefijo": "NA",
            "ValorNeto": 1360000,
            "ValorImpuestos": -52000,
            "AbreviaturaDocumento": "NIT. 1.020.304.050-8",
            "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
            "DocumentoSoporteUniqueID": "e81a5c37-0d94-4f2b-a6c8-73b2f19d4e05",
            "DocumentoSoporteConsecutivo": "DS-312",
            "CausalDocumentoSoporteAjusteNombre": "Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente",
            "TotalRows": 1
        }
    ],
    "result": 1
}

Primeros pasos

CRM

Facturación

Custodia

Común

Prerequisitos

Consultar notas de ajuste

Respuesta

​Prerequisitos

​Consultar notas de ajuste

​Respuesta

Prerequisitos

Consultar notas de ajuste

Respuesta