> ## 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 soporte de pago de nómina electrónica (nómina individual) de un empleado para un periodo de liquidación, en línea en formato JSON.

Si el empleado no existe en la plataforma, se registra automáticamente junto con su contrato; si ya existe, se actualizan sus datos y los de su contrato con la información enviada.

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 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
* Nómina creada en la plataforma, con un prefijo de nómina electrónica asociado
* Periodo de nómina electrónica abierto que contenga la fecha inicial de liquidación

## Registrar nómina individual

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

### Datos generales

**UsuarioEmail** `string` *required*

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

**FechaInicial** `string` *required*

Fecha de inicio del periodo de liquidación del documento, en formato AAAA-MM-DD.

**FechaFinal** `string` *required*

Fecha de fin del periodo de liquidación del documento, en formato AAAA-MM-DD.

**PeriodoNominaElectronica** `object` *required*

Periodo de nómina electrónica del documento.

**propiedades**

**PrefijoNomina** `string` *required*

Prefijo de nómina electrónica elegido por el emisor y configurado en la plataforma.

**Mes** `int` *required*

Mes del periodo de liquidación (1 a 12).

**Ano** `int` *required*

Año del periodo de liquidación (ej. 2026).

**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).

### Empleado

**Empleado** `object` *required*

Información del trabajador, aprendiz o pasante.

**propiedades**

**TipoDocumento** `int` *required*

Código del tipo de documento de identificación del empleado.

| Código | Significado |
| - | - |
| 11 | Registro civil |
| 12 | Tarjeta de identidad |
| 13 | Cédula de ciudadanía |
| 21 | Tarjeta de extranjería |
| 22 | Cédula de extranjería |
| 31 | NIT |
| 41 | Pasaporte |
| 42 | Documento de identificación extranjero |
| 47 | PEP |
| 50 | NIT de otro país |
| 91 | NUIP |

**Documento** `string` *required*

Número de identificación del empleado, sin puntos, comas, espacios ni guiones (mín. 5 caracteres).

**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. Si se envía, el contrato del empleado queda en estado retirado.

**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).

### Novedades

**NominasNovedades** `array`

Novedades de nómina del empleado en el mismo periodo. Cada novedad genera un documento de nómina adicional, asociado al documento principal y con su propio consecutivo.

Cada novedad admite los mismos campos de la sección **Liquidación y devengos**, **Deducciones** y **Soportes de pago** (incluida al menos una fecha de pago), además de los siguientes:

**propiedades**

**FechaInicial** `string` *required*

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

**FechaFinal** `string` *required*

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

**Salario** `number` *required*

Salario base del trabajador en la novedad.

**SalarioIntegral** `bool`

true = el trabajador tiene salario integral.

**AltoRiesgoPension** `bool`

true = actividades de alto riesgo según el Decreto 2090 de 2003.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NominaIndividualInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UsuarioEmail": "nomina@empresa.com",
	"FechaInicial": "2026-10-01",
	"FechaFinal": "2026-10-31",
	"PeriodoNominaElectronica": { "PrefijoNomina": "NE", "Mes": 10, "Ano": 2026 },
	"Empleado": {
		"TipoDocumento": 13,
		"Documento": "52123456",
		"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,
	"PorcentajeSolidaridadPensional": null,
	"ValorSolidaridadPensional": null,
	"TasaCambio": null,
	"Observaciones": "Nómina octubre 2026",
	"SoportesPagosFechasPagos": [
		{ "FechaPago": "2026-10-31" }
	],
	"SoportesPagosHorasExtra": [
		{ "FechaInicio": "2026-10-15T18:00:00", "FechaFinal": "2026-10-15T21:00:00", "Cantidad": 3, "TipoHoraExtraID": 1, "Valor": 42614 }
	],
	"SoportesPagosLibranzas": [
		{ "Descripcion": "LIBRANZA BANCO", "Valor": 150000 }
	],
	"NominasNovedades": []
}'
```

### Validaciones

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

**Empresa, nómina y periodo**

* La empresa debe estar habilitada ante la DIAN para emitir nómina electrónica.
* La nómina debe estar creada en la plataforma y tener asociado un prefijo de nómina electrónica.
* Debe existir un periodo de nómina electrónica abierto que contenga la `FechaInicial`.
* El documento debe contener al menos una fecha de pago en `SoportesPagosFechasPagos`.

**Empleado**

* El `TipoDocumento` debe estar configurado en la plataforma.
* El `Documento` debe tener al menos 5 caracteres y no puede contener guiones.
* 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.
* Los datos del contrato del empleado deben ser válidos para la emisión del documento.

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

Las mismas validaciones de valores y soportes aplican para cada novedad.

### Respuesta

**TipoSalida** `string`

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

**Codigo** `int`

Código único del documento de nómina individual 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",
  "FechaInicial": "2026-10-01",
  "FechaFinal": "2026-10-31",
  "PeriodoNominaElectronica": {
    "PrefijoNomina": "NE",
    "Mes": 10,
    "Ano": 2026
  },
  "Empleado": {
    "TipoDocumento": 13,
    "Documento": "52123456",
    "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,
  "PorcentajeSolidaridadPensional": null,
  "ValorSolidaridadPensional": null,
  "TasaCambio": null,
  "Observaciones": "Nómina octubre 2026",
  "SoportesPagosFechasPagos": [
    {
      "FechaPago": "2026-10-31"
    }
  ],
  "SoportesPagosHorasExtra": [
    {
      "FechaInicio": "2026-10-15T18:00:00",
      "FechaFinal": "2026-10-15T21:00:00",
      "Cantidad": 3,
      "TipoHoraExtraID": 1,
      "Valor": 42614
    }
  ],
  "SoportesPagosLibranzas": [
    {
      "Descripcion": "LIBRANZA BANCO",
      "Valor": 150000
    }
  ],
  "NominasNovedades": []
}
```

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

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: El periodo de la nomina no se encontro registrado"
}
```


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