Registro nuevo

{
  "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": []
}

{
    "TipoSalida": "OK",
    "Codigo": 98214,
    "Descripcion": "Transacción Exitosa"
}

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

{
  "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": []
}

{
    "TipoSalida": "OK",
    "Codigo": 98214,
    "Descripcion": "Transacción Exitosa"
}

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

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.

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

string

required

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

string

required

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

string

required

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

object

required

Periodo de nómina electrónica del documento.

Show propiedades

string

required

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

int

required

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

int

required

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

number

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

string

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

Empleado

object

required

Información del trabajador, aprendiz o pasante.

Show propiedades

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

string

required

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

string

required

Primer nombre del empleado.

string

Otros nombres del empleado.

string

required

Primer apellido del empleado.

string

Segundo apellido del empleado.

string

Dirección de residencia del empleado.

string

Número de celular del empleado.

string

required

Correo electrónico del empleado.

string

Código del trabajador.

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

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

string

required

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

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

number

required

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

string

Código de la moneda, según la tabla de monedas. Si no se envía, se utiliza el peso colombiano (COP).

string

required

Código DIAN del medio de pago de la nómina, según la tabla de medios de pago (ej. “47” para transferencia débito bancaria).

string

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

string

Tipo de cuenta bancaria del empleado.

Código	Nombre
1	Ahorros
2	Corriente

string

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

bool

true = el trabajador tiene salario integral.

bool

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

Liquidación y devengos

string

Fecha de retiro del trabajador, en formato AAAA-MM-DD. Si se envía, el contrato del empleado queda en estado retirado.

int

required

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

number

required

Sueldo correspondiente a los días laborados.

number

Valor del auxilio de transporte, según aplique.

int

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

number

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

number

Valor pagado por prima no salarial.

number

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

number

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

number

Valor pagado por intereses de cesantías.

number

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

number

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

number

Valor pagado por dotación.

number

Valor pagado por apoyo de sostenimiento.

number

Valor pagado por teletrabajo.

number

Valor pagado por bonificación de retiro.

number

Valor pagado por indemnización.

number

Valor pagado por reintegro por parte del empleador.

Deducciones

number

required

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

number

required

Valor de la deducción de salud del trabajador.

number

required

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

number

required

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

number

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

number

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

number

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

number

Valor de la deducción al fondo de subsistencia.

number

Valor de la deducción por cooperativas.

number

Valor de la deducción por embargos fiscales.

number

Valor de la deducción por planes complementarios.

number

Valor de la deducción por conceptos educativos.

number

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

number

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

number

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

number

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

number

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

Soportes de pago

array

required

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

Show propiedades

string

required

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

array

Horas extra y recargos del periodo.

Show propiedades

string

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

string

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

number

required

Cantidad de horas.

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

number

required

Valor pagado por las horas.

array

Vacaciones del periodo.

Show propiedades

string

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

string

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

int

required

Cantidad de días.

int

required

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

number

required

Valor pagado por vacaciones.

array

Incapacidades del periodo.

Show propiedades

string

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

string

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

int

required

Cantidad de días.

int

required

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

number

required

Valor pagado por la incapacidad.

array

Licencias del periodo.

Show propiedades

string

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

string

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

int

required

Cantidad de días.

int

required

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

number

required

Valor pagado por la licencia.

array

Auxilios salariales o no salariales.

Show propiedades

int

required

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

number

required

Valor pagado por el auxilio.

array

Bonificaciones salariales o no salariales.

Show propiedades

int

required

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

number

required

Valor pagado por la bonificación.

array

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

Show propiedades

number

Valor del pago salarial.

number

Valor del pago no salarial.

number

Valor del pago de alimentación salarial.

number

Valor del pago de alimentación no salarial.

array

Comisiones del periodo.

Show propiedades

number

required

Valor pagado por comisión.

array

Compensaciones del periodo.

Show propiedades

int

required

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

number

required

Valor pagado por la compensación.

array

Otros conceptos devengados.

Show propiedades

int

required

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

string

Descripción del concepto.

number

required

Valor pagado por el concepto.

array

Anticipos devengados: Valor (requerido).

array

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

array

Anticipos deducidos: Valor (requerido).

array

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

array

Libranzas del trabajador con entidades financieras.

Show propiedades

string

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

number

required

Valor de la deducción por libranza.

array

Deducciones por aportes a sindicatos.

Show propiedades

number

Porcentaje de la deducción.

number

Valor de la deducción.

array

Otras deducciones: Valor (requerido).

Novedades

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:

Show propiedades

string

required

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

string

required

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

number

required

Salario base del trabajador en la novedad.

bool

true = el trabajador tiene salario integral.

bool

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

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

string

Resultado de la operación: “OK” o “Error”.

int

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

string

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

{
  "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": []
}

{
    "TipoSalida": "OK",
    "Codigo": 98214,
    "Descripcion": "Transacción Exitosa"
}

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

Primeros pasos

CRM

Facturación

Custodia

Común

Prerequisitos

Registrar nómina individual

Datos generales

Empleado

Liquidación y devengos

Deducciones

Soportes de pago

Novedades

Validaciones

Respuesta

​Prerequisitos

​Registrar nómina individual

​Datos generales

​Empleado

​Liquidación y devengos

​Deducciones

​Soportes de pago

​Novedades

​Validaciones

​Respuesta

Prerequisitos

Registrar nómina individual

Datos generales

Empleado

Liquidación y devengos

Deducciones

Soportes de pago

Novedades

Validaciones

Respuesta