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

# Registro nuevo

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](https://tech.sedierp.com/quickstart.md).

## 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](https://tech.sedierp.com/quickstart.md)
* 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

**Prefijo** `string` *required*

Prefijo de la nota de ajuste, configurado en la plataforma (máx. 20 caracteres).

**Consecutivo** `int` *required*

Consecutivo de la nota de ajuste.

**FechaEmision** `string` *required*

Fecha de emisión de la nota de ajuste (ej. "2026-11-05T10:00:00"). No puede ser una fecha futura.

**CausalNotaAjuste** `string` *required*

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

| Código | Descripción |
| - | - |
| 1 | Devolución parcial de los bienes y/o no aceptación parcial del servicio |
| 2 | Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente |
| 3 | Rebaja o descuento parcial o total |
| 4 | Ajuste de precio |
| 5 | Otros |

**Observaciones** `string`

Observaciones de la nota de ajuste (máx. 1500 caracteres).

**UsuarioEmail** `string`

Email del usuario que registra la nota de ajuste.

**DocumentoSoporte** `object` *required*

Documento soporte al cual se le registra la nota de ajuste.

**propiedades**

**Prefijo** `string` *required*

Prefijo de la resolución del documento soporte.

**Consecutivo** `int` *required*

Consecutivo del documento soporte.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaAjusteNoObligadosInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"Prefijo": "NA",
	"Consecutivo": 15,
	"FechaEmision": "2026-11-05T10:00:00",
	"CausalNotaAjuste": "2",
	"Observaciones": "Anulación del documento soporte DS-312",
	"UsuarioEmail": "compras@empresa.com",
	"DocumentoSoporte": {
		"Prefijo": "DS",
		"Consecutivo": 312
	}
}'
```

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

> [!NOTE]
>
> 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

**TipoSalida** `string`

Resultado de la operación: "OK" o "Error".

**Codigo** `int`

Código único de la nota de ajuste registrada o existente (ID). Retorna -1 cuando ocurre un error.

**Descripcion** `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:".

```json Request theme={null}
{
  "Prefijo": "NA",
  "Consecutivo": 15,
  "FechaEmision": "2026-11-05T10:00:00",
  "CausalNotaAjuste": "2",
  "Observaciones": "Anulación del documento soporte DS-312",
  "UsuarioEmail": "compras@empresa.com",
  "DocumentoSoporte": {
    "Prefijo": "DS",
    "Consecutivo": 312
  }
}
```

```json Exitosa theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 58,
    "Descripcion": "Transacción Exitosa"
}
```

```json Existente theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 58,
    "Descripcion": "Transacción exitosa, el documento ya se encuentra registrado."
}
```

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: No se encontro el documento soporte relacionado"
}
```


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