> ## 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 el documento de nómina individual de ajuste de tipo **reemplazar**, que corrige una nómina individual registrada previamente en la plataforma, en línea en formato JSON.

El documento de ajuste se genera con el prefijo de ajuste configurado en la nómina y con un consecutivo asignado automáticamente. Conserva el periodo de liquidación (fechas inicial y final) de la nómina referenciada y reemplaza sus valores con la información enviada. Los datos del empleado y de su contrato también se actualizan.

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 ajuste de una nómina individual, se debe contar con los siguientes datos:

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)
* Empresa habilitada ante la DIAN para emitir nómina electrónica
* Prefijo y consecutivo de la nómina individual que se va a ajustar
* Prefijo de ajuste de nómina electrónica configurado en la nómina

## Ajustar nómina individual

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

### Datos generales

**UsuarioEmail** `string` *required*

Email del usuario de la plataforma con el cual se registra el documento.

**NominaReferenciada** `string` *required*

Prefijo y consecutivo de la nómina individual que se va a ajustar, unidos sin separador (ej. "NE250").

**TasaCambio** `number`

Tasa de cambio a pesos colombianos. Es obligatoria cuando la moneda del empleado es diferente a COP.

**Observaciones** `string`

Observaciones generales del documento (máx. 5000 caracteres).

### Datos del empleado

El empleado se identifica a partir de la nómina referenciada. Los siguientes datos actualizan la información del empleado y de su contrato.

**Nombres** `string` *required*

Primer nombre del empleado.

**Nombres2** `string`

Otros nombres del empleado.

**Apellidos** `string` *required*

Primer apellido del empleado.

**Apellidos2** `string`

Segundo apellido del empleado.

**Direccion** `string`

Dirección de residencia del empleado.

**Celular** `string`

Número de celular del empleado.

**Email** `string` *required*

Correo electrónico del empleado.

**Codigo** `string`

Código del trabajador.

**TipoEmpleado** `string` *required*

Tipo de cotizante según la clasificación de PILA.

| Código | Tipo de trabajador |
| - | - |
| 01 | Dependiente |
| 02 | Servicio doméstico |
| 04 | Madre comunitaria |
| 12 | Aprendices del SENA en etapa lectiva |
| 18 | Funcionarios públicos sin tope máximo de IBC |
| 19 | Aprendices del SENA en etapa productiva |
| 21 | Estudiantes de postgrado en salud |
| 22 | Profesor de establecimiento particular |
| 23 | Estudiantes aportes solo riesgos laborales |
| 30 | Dependiente entidades o universidades públicas con régimen especial en salud |
| 31 | Cooperados o pre cooperativas de trabajo asociado |
| 47 | Trabajador dependiente de entidad beneficiaria del sistema general de participaciones - aportes patronales |
| 51 | Trabajador de tiempo parcial |
| 54 | Pre pensionado de entidad en liquidación |
| 56 | Pre pensionado con aporte voluntario a salud |
| 58 | Estudiantes de prácticas laborales en el sector público |

**SubTipoEmpleado** `string` *required*

Subtipo de cotizante según la clasificación de PILA.

| Código | Subtipo de trabajador |
| - | - |
| 00 | No aplica |
| 01 | Dependiente pensionado por vejez activo |

**FechaIngreso** `string` *required*

Fecha de ingreso del trabajador, en formato AAAA-MM-DD.

**TipoContrato** `string` *required*

Tipo de contrato del empleado.

| Código | Tipo de contrato |
| - | - |
| 1 | Término fijo |
| 2 | Término indefinido |
| 3 | Obra o labor |
| 4 | Aprendizaje |
| 5 | Prácticas o pasantías |

**Salario** `number` *required*

Sueldo o salario base del trabajador. Es obligatorio si no se envía `ValorApoyoSostenimiento`.

**Moneda** `string`

Código de la moneda, según la [tabla de monedas](https://tech.sedierp.com/monedas.md). Si no se envía, se utiliza el peso colombiano (COP).

**FormaPago** `string` *required*

Código DIAN del medio de pago de la nómina, según la [tabla de medios de pago](https://tech.sedierp.com/medios-de-pago.md) (ej. "47" para transferencia débito bancaria).

**Banco** `string`

Nombre de la entidad bancaria donde el trabajador recibe el pago de nómina.

**TipoCuentaBanco** `string`

Tipo de cuenta bancaria del empleado.

| Código | Nombre |
| - | - |
| 1 | Ahorros |
| 2 | Corriente |

**Cuenta** `string`

Número de la cuenta bancaria del empleado para el pago de nómina.

**SalarioIntegral** `bool`

true = el trabajador tiene salario integral.

**AltoRiesgoPension** `bool`

true = el trabajador desarrolló durante el periodo actividades de alto riesgo descritas en el Decreto 2090 de 2003.

### Liquidación y devengos

**FechaRetiro** `string`

Fecha de retiro del trabajador, en formato AAAA-MM-DD.

**DiasTrabajados** `int` *required*

Cantidad de días laborados durante el periodo de pago.

**SueldoTrabajado** `number` *required*

Sueldo correspondiente a los días laborados.

**AuxilioTransporte** `number`

Valor del auxilio de transporte, según aplique.

**DiasBasePrima** `int`

Cantidad de días a los que corresponde el pago de la prima legal. Es obligatorio si se envía `ValorPrima`.

**ValorPrima** `number`

Valor pagado por prima legal. Es obligatorio si se envía `DiasBasePrima`.

**ValorPrimaNoSalarial** `number`

Valor pagado por prima no salarial.

**ValorCesantias** `number`

Valor pagado por cesantías. Si se envía, `PorcentajeInteresCesantias` y `ValorInteresCesantias` son obligatorios.

**PorcentajeInteresCesantias** `number`

Porcentaje de intereses de cesantías (0 a 100).

**ValorInteresCesantias** `number`

Valor pagado por intereses de cesantías.

**ViaticoAlojamientoSalarial** `number`

Valor de viáticos, manutención y alojamiento de carácter salarial.

**ViaticoAlojamientoNoSalarial** `number`

Valor de viáticos, manutención y alojamiento de carácter no salarial.

**ValorDotacion** `number`

Valor pagado por dotación.

**ValorApoyoSostenimiento** `number`

Valor pagado por apoyo de sostenimiento.

**ValorTeletrabajo** `number`

Valor pagado por teletrabajo.

**ValorBonificacionRetiro** `number`

Valor pagado por bonificación de retiro.

**ValorIndemnizacion** `number`

Valor pagado por indemnización.

**ValorDevengoReintegro** `number`

Valor pagado por reintegro por parte del empleador.

### Deducciones

**PorcentajeSalud** `number` *required*

Porcentaje de deducción de salud que paga el trabajador (0 a 100).

**ValorSalud** `number` *required*

Valor de la deducción de salud del trabajador.

**PorcentajePension** `number` *required*

Porcentaje de deducción de pensión que paga el trabajador.

**ValorPension** `number` *required*

Valor de la deducción de pensión del trabajador.

**PorcentajeSolidaridadPensional** `number`

Porcentaje de deducción al fondo de solidaridad pensional (0 a 100). Se envía junto con `ValorSolidaridadPensional`.

**ValorSolidaridadPensional** `number`

Valor de la deducción al fondo de solidaridad pensional.

**FondoSubsistenciaPorcentaje** `number`

Porcentaje de deducción al fondo de subsistencia (0 a 100). Se envía junto con `FondoSubsistenciaValor`.

**FondoSubsistenciaValor** `number`

Valor de la deducción al fondo de subsistencia.

**ValorCooperativa** `number`

Valor de la deducción por cooperativas.

**ValorEmbargoFiscal** `number`

Valor de la deducción por embargos fiscales.

**ValorPlanComplementario** `number`

Valor de la deducción por planes complementarios.

**ValorEducacion** `number`

Valor de la deducción por conceptos educativos.

**ValorDeduccionReintegro** `number`

Valor de la deducción por reintegro por parte del trabajador.

**ValorDeuda** `number`

Valor de la deducción por deudas del trabajador con la empresa.

**ValorPensionVoluntaria** `number`

Valor de la deducción por aportes a pensión voluntaria.

**ValorRetencionFuente** `number`

Valor de la retención en la fuente del trabajador.

**ValorAFC** `number`

Valor de la deducción por aportes a cuentas AFC.

### Soportes de pago

**SoportesPagosFechasPagos** `array` *required*

Fechas de pago del documento. Debe contener al menos una fecha.

**propiedades**

**FechaPago** `string` *required*

Fecha de pago, en hora de Colombia (UTC-5), en formato AAAA-MM-DD.

**SoportesPagosHorasExtra** `array`

Horas extra y recargos del periodo.

**propiedades**

**FechaInicio** `string`

Fecha y hora de inicio, en formato AAAA-MM-DDTHH:MM:SS.

**FechaFinal** `string`

Fecha y hora de fin, en formato AAAA-MM-DDTHH:MM:SS.

**Cantidad** `number` *required*

Cantidad de horas.

**TipoHoraExtraID** `int` *required*

Tipo de hora extra o recargo.

| Código | Nombre |
| - | - |
| 1 | Hora extra diurna |
| 2 | Hora extra nocturna |
| 3 | Hora recargo nocturno |
| 4 | Hora extra diurna dominical y festivos |
| 5 | Hora recargo diurno dominical y festivos |
| 6 | Hora extra nocturna dominical y festivos |
| 7 | Hora recargo nocturno dominical y festivos |

**Valor** `number` *required*

Valor pagado por las horas.

**SoportesPagosVacaciones** `array`

Vacaciones del periodo.

**propiedades**

**FechaInicio** `string`

Fecha de inicio, en formato AAAA-MM-DD.

**FechaFin** `string`

Fecha de fin, en formato AAAA-MM-DD.

**Cantidad** `int` *required*

Cantidad de días.

**TipoVacacionID** `int` *required*

Tipo de vacaciones (1: Normales, 2: Compensadas en dinero).

**Valor** `number` *required*

Valor pagado por vacaciones.

**SoportesPagosIncapacidades** `array`

Incapacidades del periodo.

**propiedades**

**FechaInicio** `string`

Fecha de inicio, en formato AAAA-MM-DD.

**FechaFin** `string`

Fecha de fin, en formato AAAA-MM-DD.

**Cantidad** `int` *required*

Cantidad de días.

**TipoIncapacidadID** `int` *required*

Tipo de incapacidad (1: Común, 2: Profesional, 3: Laboral).

**Valor** `number` *required*

Valor pagado por la incapacidad.

**SoportesPagosLicencias** `array`

Licencias del periodo.

**propiedades**

**FechaInicio** `string`

Fecha de inicio, en formato AAAA-MM-DD.

**FechaFin** `string`

Fecha de fin, en formato AAAA-MM-DD.

**Cantidad** `int` *required*

Cantidad de días.

**TipoLicenciaID** `int` *required*

Tipo de licencia (1: Maternidad o paternidad, 2: Remunerada, 3: No remunerada).

**Valor** `number` *required*

Valor pagado por la licencia.

**SoportesPagosAuxilios** `array`

Auxilios salariales o no salariales.

**propiedades**

**TipoDevengoID** `int` *required*

Tipo de devengo (1: Salarial, 2: No salarial).

**Valor** `number` *required*

Valor pagado por el auxilio.

**SoportesPagosBonificaciones** `array`

Bonificaciones salariales o no salariales.

**propiedades**

**TipoDevengoID** `int` *required*

Tipo de devengo (1: Salarial, 2: No salarial).

**Valor** `number` *required*

Valor pagado por la bonificación.

**SoportesPagosBonoEPCTVs** `array`

Bonos electrónicos o de papel de servicio, cheques, tarjetas y vales.

**propiedades**

**PagoS** `number`

Valor del pago salarial.

**PagoNS** `number`

Valor del pago no salarial.

**PagoAlimentacionS** `number`

Valor del pago de alimentación salarial.

**PagoAlimentacionNS** `number`

Valor del pago de alimentación no salarial.

**SoportesPagosComisiones** `array`

Comisiones del periodo.

**propiedades**

**Valor** `number` *required*

Valor pagado por comisión.

**SoportesPagosCompensaciones** `array`

Compensaciones del periodo.

**propiedades**

**TipoCompensacionID** `int` *required*

Tipo de compensación (1: Ordinarias, 2: Extraordinarias).

**Valor** `number` *required*

Valor pagado por la compensación.

**SoportesPagosOtrosConceptos** `array`

Otros conceptos devengados.

**propiedades**

**TipoDevengoID** `int` *required*

Tipo de devengo (1: Salarial, 2: No salarial).

**Descripcion** `string`

Descripción del concepto.

**Valor** `number` *required*

Valor pagado por el concepto.

**SoportesPagosDevengosAnticipos** `array`

Anticipos devengados: `Valor` (requerido).

**SoportesPagosDevengosTerceros** `array`

Pagos a terceros por beneficios en cabeza del trabajador: `Valor` (requerido).

**SoportesPagosDeduccionesAnticipos** `array`

Anticipos deducidos: `Valor` (requerido).

**SoportesPagosDeduccionesTerceros** `array`

Pagos a terceros por deducciones en cabeza del trabajador: `Valor` (requerido).

**SoportesPagosLibranzas** `array`

Libranzas del trabajador con entidades financieras.

**propiedades**

**Descripcion** `string`

Descripción de la libranza (máx. 100 caracteres).

**Valor** `number` *required*

Valor de la deducción por libranza.

**SoportesPagosSindicatos** `array`

Deducciones por aportes a sindicatos.

**propiedades**

**Porcentaje** `number`

Porcentaje de la deducción.

**Deduccion** `number`

Valor de la deducción.

**SoportesPagosOtrasDeducciones** `array`

Otras deducciones: `Valor` (requerido).

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NominaAjusteInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UsuarioEmail": "nomina@empresa.com",
	"NominaReferenciada": "NE250",
	"Nombres": "MARIA",
	"Nombres2": "FERNANDA",
	"Apellidos": "GOMEZ",
	"Apellidos2": "RUIZ",
	"Direccion": "CALLE 45 # 12-30",
	"Celular": "3156789012",
	"Email": "maria.gomez@correo.com",
	"Codigo": "EMP-015",
	"TipoEmpleado": "01",
	"SubTipoEmpleado": "00",
	"FechaIngreso": "2024-03-01",
	"TipoContrato": "2",
	"Salario": 2500000,
	"Moneda": "COP",
	"FormaPago": "47",
	"Banco": "BANCOLOMBIA",
	"TipoCuentaBanco": "1",
	"Cuenta": "12345678901",
	"SalarioIntegral": false,
	"AltoRiesgoPension": false,
	"FechaRetiro": null,
	"DiasBasePrima": null,
	"DiasTrabajados": 30,
	"SueldoTrabajado": 2500000,
	"AuxilioTransporte": 200000,
	"ValorPrima": null,
	"ValorPrimaNoSalarial": null,
	"ValorCesantias": null,
	"PorcentajeInteresCesantias": null,
	"ValorInteresCesantias": null,
	"PorcentajeSalud": 4,
	"ValorSalud": 100000,
	"PorcentajePension": 4,
	"ValorPension": 100000,
	"TasaCambio": null,
	"Observaciones": "Ajuste por bonificación no incluida en la nómina original",
	"SoportesPagosFechasPagos": [
		{
			"FechaPago": "2026-11-30"
		}
	],
	"SoportesPagosBonificaciones": [
		{
			"TipoDevengoID": 2,
			"Valor": 300000
		}
	],
	"SoportesPagosLibranzas": [
		{
			"Descripcion": "LIBRANZA BANCO",
			"Valor": 150000
		}
	]
}'
```

### Validaciones

El servicio realiza las siguientes validaciones antes de registrar el documento. Si alguna no se cumple, no se registra el ajuste y se retorna el error correspondiente.

**Nómina referenciada**

* La empresa debe estar habilitada ante la DIAN para emitir nómina electrónica.
* La nómina referenciada (prefijo y consecutivo) debe estar registrada en la plataforma y ser de tipo nómina individual.
* La nómina referenciada no debe tener un documento de eliminación registrado. Si es una novedad, tampoco debe estar eliminada la nómina de la cual depende.
* Los datos del contrato del empleado deben ser válidos para la emisión del documento.

**Empleado**

* El `TipoEmpleado`, el `SubTipoEmpleado` y el `TipoContrato` deben ser códigos válidos.
* La moneda debe estar configurada en la plataforma. Si es diferente a COP, la `TasaCambio` es obligatoria.
* La `FormaPago` debe corresponder a un medio de pago definido por la DIAN. Si no está configurado en la plataforma, se registra automáticamente.
* El `TipoCuentaBanco`, si se envía, debe ser válido.

**Valores**

* El `Salario` es obligatorio si no se envía `ValorApoyoSostenimiento`.
* `DiasBasePrima` y `ValorPrima` se deben enviar juntos.
* `ValorCesantias`, `PorcentajeInteresCesantias` y `ValorInteresCesantias` se deben enviar juntos.
* Los porcentajes de salud, intereses de cesantías, solidaridad pensional y fondo de subsistencia deben estar entre 0 y 100.
* El porcentaje y el valor de solidaridad pensional se deben enviar juntos; lo mismo aplica para el fondo de subsistencia.
* Los tipos enviados en los soportes de pago (devengo, compensación, hora extra, incapacidad, licencia y vacaciones) deben ser válidos.
* Los valores se redondean según el número de decimales configurado en el prefijo de nómina electrónica.

### Respuesta

**TipoSalida** `string`

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

**Codigo** `int`

Código único del documento de ajuste registrado (ID). Retorna -1 cuando ocurre un error.

**Descripcion** `string`

"Transacción Exitosa" cuando el registro es correcto, o el detalle del error precedido de "Error:".

```json Request theme={null}
{
  "UsuarioEmail": "nomina@empresa.com",
  "NominaReferenciada": "NE250",
  "Nombres": "MARIA",
  "Nombres2": "FERNANDA",
  "Apellidos": "GOMEZ",
  "Apellidos2": "RUIZ",
  "Direccion": "CALLE 45 # 12-30",
  "Celular": "3156789012",
  "Email": "maria.gomez@correo.com",
  "Codigo": "EMP-015",
  "TipoEmpleado": "01",
  "SubTipoEmpleado": "00",
  "FechaIngreso": "2024-03-01",
  "TipoContrato": "2",
  "Salario": 2500000,
  "Moneda": "COP",
  "FormaPago": "47",
  "Banco": "BANCOLOMBIA",
  "TipoCuentaBanco": "1",
  "Cuenta": "12345678901",
  "SalarioIntegral": false,
  "AltoRiesgoPension": false,
  "FechaRetiro": null,
  "DiasBasePrima": null,
  "DiasTrabajados": 30,
  "SueldoTrabajado": 2500000,
  "AuxilioTransporte": 200000,
  "ValorPrima": null,
  "ValorPrimaNoSalarial": null,
  "ValorCesantias": null,
  "PorcentajeInteresCesantias": null,
  "ValorInteresCesantias": null,
  "PorcentajeSalud": 4,
  "ValorSalud": 100000,
  "PorcentajePension": 4,
  "ValorPension": 100000,
  "TasaCambio": null,
  "Observaciones": "Ajuste por bonificación no incluida en la nómina original",
  "SoportesPagosFechasPagos": [
    {
      "FechaPago": "2026-11-30"
    }
  ],
  "SoportesPagosBonificaciones": [
    {
      "TipoDevengoID": 2,
      "Valor": 300000
    }
  ],
  "SoportesPagosLibranzas": [
    {
      "Descripcion": "LIBRANZA BANCO",
      "Valor": 150000
    }
  ]
}
```

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

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: No se puede hacer un ajuste por que la nomina ya se elimino."
}
```


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