Skip to main content
El servicio permite a los usuarios registrar notas de ajuste a un documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta, en línea en formato JSON. La nota de ajuste se genera por el valor total del documento soporte referenciado: se copian todos sus detalles, impuestos, 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.

​
Prerequisitos

Antes de realizar el registro de una nota de ajuste, se debe contar con los siguientes datos:
  • Token solicitado mediante el API de autenticación
  • Prefijo y consecutivo del documento soporte al cual se le registrará la nota de ajuste
  • Tipo de documento de nota de ajuste configurado en la plataforma, con el prefijo que se enviará

​
Registrar nota de ajuste

Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/NotaAjusteNoObligadosInsertar
Tipo: POST
Content Type: application/json
​
string
required
Prefijo de la nota de ajuste, configurado en la plataforma (máx. 20 caracteres).
​
int
required
Consecutivo de la nota de ajuste.
​
string
required
Fecha de emisión de la nota de ajuste (ej. “2026-11-05T10:00:00”). No puede ser una fecha futura.
​
string
required
Código del concepto de corrección de la nota de ajuste.
​
string
Observaciones de la nota de ajuste (máx. 1500 caracteres).
​
string
Email del usuario que registra la nota de ajuste.
​
object
required
Documento soporte al cual se le registra la nota de ajuste.

​
Validaciones

El servicio realiza las siguientes validaciones antes de registrar el documento. Si alguna no se cumple, no se registra la nota de ajuste y se retorna el error correspondiente.
  • El documento soporte (prefijo y consecutivo) debe estar registrado en la plataforma.
  • Los datos del proveedor del documento soporte deben estar completos para la emisión del documento.
  • La FechaEmision no puede ser posterior a la fecha actual.
  • La CausalNotaAjuste debe corresponder a uno de los códigos de la tabla.
  • El Prefijo debe corresponder a un tipo de documento de nota de ajuste configurado en la plataforma.
Si ya existe una nota de ajuste con el mismo prefijo y consecutivo, el servicio no registra un nuevo documento: retorna el código de la nota existente con la descripción “Transacción exitosa, el documento ya se encuentra registrado.”

​
Respuesta

​
string
Resultado de la operación: “OK” o “Error”.
​
int
Código único de la nota de ajuste registrada o existente (ID). Retorna -1 cuando ocurre un error.
​
string
“Transacción Exitosa” cuando el registro es correcto, “Transacción exitosa, el documento ya se encuentra registrado.” cuando la nota ya existía, o el detalle del error precedido de “Error:”.