Skip to main content
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.

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

​
string
required
Email del usuario de la plataforma con el cual se registra el documento.
​
string
required
Prefijo y consecutivo de la nómina individual que se va a ajustar, unidos sin separador (ej. “NE250”).
​
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).

​
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.
​
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.
​
string
required
Subtipo de cotizante según la clasificación de PILA.
​
string
required
Fecha de ingreso del trabajador, en formato AAAA-MM-DD.
​
string
required
Tipo de contrato del empleado.
​
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.
​
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.
​
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.
​
array
Horas extra y recargos del periodo.
​
array
Vacaciones del periodo.
​
array
Incapacidades del periodo.
​
array
Licencias del periodo.
​
array
Auxilios salariales o no salariales.
​
array
Bonificaciones salariales o no salariales.
​
array
Bonos electrónicos o de papel de servicio, cheques, tarjetas y vales.
​
array
Comisiones del periodo.
​
array
Compensaciones del periodo.
​
array
Otros conceptos devengados.
​
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.
​
array
Deducciones por aportes a sindicatos.
​
array
Otras deducciones: Valor (requerido).

​
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

​
string
Resultado de la operación: “OK” o “Error”.
​
int
Código único del documento de ajuste 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:”.