Manual de usuario · Colombia 2026

Guía completa de
Nómina Tools

Todo lo que necesitas saber para operar el sistema de nómina colombiana: desde el primer acceso hasta la conciliación UGPP y la exportación Contai.

1. Introducción

Nómina Tools es un sistema SaaS de gestión de nómina diseñado específicamente para empresas colombianas, con cumplimiento de la normativa laboral 2026 (SMMLV, UVT, Ley 1607, Art. 383 ET). Su objetivo es centralizar el ciclo completo de la nómina: desde la creación del empleado hasta la aprobación del corte, la exportación contable y la conciliación con la UGPP.

El sistema está orientado a contadoras y contadores que administran la nómina de una o varias empresas. No se requiere conocimiento técnico avanzado: la interfaz guía paso a paso cada proceso.

Conceptos base

ConceptoDefinición
EmpresaEntidad empleadora registrada en el sistema. Puede tener múltiples empleados activos.
EmpleadoPersona natural vinculada a la empresa mediante un contrato laboral activo.
ContratoRelación laboral de un empleado: cargo, salario, fecha de ingreso y tipo de contrato. Un empleado puede tener un contrato activo a la vez.
NovedadEvento que afecta el cálculo del período: incapacidades, vacaciones, horas extras, ausencias, etc.
Corte (período)El proceso de liquidación mensual de nómina. Se identifica con el formato YYYY-MM (ej. 2026-04).
DesprendibleComprobante individual por empleado que detalla devengos, deducciones, aportes patronales y neto a pagar.
IBCIngreso Base de Cotización — salario base usado para calcular aportes a seguridad social.
RetefuenteRetención en la fuente sobre pagos laborales, calculada por Procedimiento 1 (Art. 383 ET).
Nota
Nómina Tools utiliza el sistema de 30 días por mes y 360 días por año para todos los cálculos de tiempo (días trabajados, liquidaciones, cesantías, etc.), siguiendo el estándar normativo colombiano.

2. Primer acceso

Accede al sistema desde cualquier navegador moderno en: https://nomina.one4tools.com. No se requiere instalar ningún software.

Credenciales de prueba / primer admin

Email: admin@nomina.test
Clave: Nomina2026!
Importante
Cambia la clave del admin inmediatamente después del primer acceso. Ve a Usuarios → tu perfil → Cambiar clave.

Recorrido del dashboard

Al iniciar sesión llegas al Dashboard principal, que muestra un resumen del estado de la nómina: empleados activos, último corte, novedades pendientes y alertas del sistema.

┌─────────────────────────────────────────────────────────────┐
│  [N] Nómina Tools                                  usuario@ │
├──────────────┬──────────────────────────────────────────────┤
│              │  ┌──────────┐ ┌──────────┐ ┌──────────────┐  │
│ GENERAL      │  │ Empleados│ │ Último   │ │ Novedades    │  │
│  • Inicio    │  │ activos  │ │ corte    │ │ pendientes   │  │
│              │  │    12    │ │ 2026-03  │ │      3       │  │
│ OPERACIÓN    │  │          │ │ APROBADO │ │              │  │
│  • Empleados │  └──────────┘ └──────────┘ └──────────────┘  │
│  • Novedades │                                               │
│  • Nómina    │  Alertas del sistema                          │
│  • Liquid.   │  ⚠ 2 empleados sin cuenta bancaria           │
│              │  ℹ Próximo corte: 2026-04                    │
│ CONTROL      │                                               │
│  • Concil.   │                                               │
│  • Exportac. │                                               │
│  • Certific. │                                               │
│              │                                               │
│ ADMIN        │                                               │
│  • Saldos    │                                               │
│  • Params    │                                               │
│  • Usuarios  │                                               │
└──────────────┴─────────────────────────────────────────────-┘

El sidebar explicado

SecciónMódulosUso
GeneralInicioResumen global del estado de la nómina.
OperaciónEmpleados, Novedades, Nómina, LiquidacionesEl día a día: crear empleados, registrar novedades, procesar cortes y liquidaciones.
ControlConciliación PILA, Exportaciones, CertificadosValidación vs. UGPP, archivos Contai/PAB, y emisión de certificados.
AdminSaldos iniciales, Parámetros, UsuariosConfiguración del sistema, carga de saldos históricos y gestión de accesos.

3. Configuración inicial (Admin)

Antes de registrar el primer empleado debes verificar que los parámetros del año estén correctos y cargar los saldos acumulados de nóminas anteriores.

3.1 Verificar parámetros 2026

Ve a Admin → Parámetros y confirma los valores vigentes para 2026:

ParámetroValor 2026 referencia
SMMLV mensual$1.423.500
Auxilio de transporte$202.175
UVT (Unidad de Valor Tributario)$49.799
Tasa Salud empleado4%
Tasa Pensión empleado4%
Tasa Salud patronal8.5% (o 0% con exoneración Ley 1607)
Tasa Pensión patronal12%
Tasa ARL (nivel I–V)0.522% – 6.960%
Caja de Compensación4%
SENA2% (0% con exoneración Ley 1607)
ICBF3% (0% con exoneración Ley 1607)
Prima de servicios8.33% (1 mes/año = 15 días por semestre)
Cesantías8.33% mensual
Intereses cesantías12% anual sobre saldo cesantías
Vacaciones4.17% mensual (15 días hábiles/año)
Advertencia
Si alguno de estos valores difiere de los cargados en el sistema, NO edites el parámetro existente. Crea uno nuevo con la vigencia correcta. Ver sección 11 para el procedimiento.

3.2 Crear usuarios con roles

  1. Ve a Admin → Usuarios → Nuevo usuario.
  2. Ingresa nombre, correo electrónico y contraseña temporal.
  3. Selecciona el rol: ADMIN, CONTADOR o CONSULTA.
  4. Guarda. El usuario puede iniciar sesión de inmediato.

3.3 Cargar saldos iniciales desde Excel

Si vienes de otro sistema o de un libro de Excel, debes ingresar los saldos acumulados de cada empleado (cesantías, vacaciones, retención, etc.) para que el sistema calcule correctamente las provisiones y la retención a futuro.

Ve a Admin → Saldos iniciales → Importar Excel. El archivo debe tener exactamente estas columnas (sin encabezados adicionales):

ColumnaTipoDescripción
cedulaTexto/NúmeroNúmero de cédula del empleado (debe existir en el sistema).
fecha_corteFecha YYYY-MM-DDFecha de cierre del período acumulado (ej. 2025-12-31).
cesantias_acumDecimalSaldo acumulado de cesantías en pesos.
int_cesantias_acumDecimalIntereses de cesantías acumulados en pesos.
vacaciones_diasDecimalDías de vacaciones acumulados pendientes de disfrute.
prima_acum_semestreDecimalPrima acumulada del semestre en curso en pesos.
ingresos_añoDecimalTotal de ingresos gravables del año para cálculo retefuente.
retenciones_añoDecimalTotal de retenciones practicadas en el año.
Tip
Descarga la plantilla Excel desde el botón Descargar plantilla en la misma pantalla. Asegúrate de que la cédula de cada empleado ya esté registrada antes de importar.

4. Empleados

El módulo de empleados es el núcleo del sistema. Aquí registras toda la información laboral y personal de cada trabajador.

4.1 Crear nuevo empleado

Ve a Empleados → Nuevo empleado. El formulario tiene tres secciones:

Sección 1 — Datos personales

  • Cédula — número de documento sin puntos ni guiones. Es el identificador único.
  • Nombre completo — nombres y apellidos completos.
  • Fecha de nacimiento — formato DD/MM/YYYY.
  • Dirección y ciudad — domicilio para certificados laborales y comunicaciones.
  • Correo electrónico — para envío de desprendibles (opcional).

Sección 2 — Afiliaciones

  • EPS — entidad promotora de salud activa.
  • AFP (Pensión) — administradora de fondos de pensiones.
  • ARL — administradora de riesgos laborales y nivel de riesgo (I–V).
  • Caja de compensación — entidad de caja.
  • Cesantías — fondo de cesantías (puede ser la misma AFP o diferente).
Nota
El nivel de riesgo ARL determina la tarifa de cotización patronal. Nivel I = 0.522%, Nivel V = 6.960%. Consúltalo en el contrato de afiliación a la ARL.

Sección 3 — Cuenta bancaria

  • Banco — nombre del banco (Bancolombia, Davivienda, etc.).
  • Tipo de cuenta — Ahorros o Corriente.
  • Número de cuenta — sin espacios.
Advertencia
Si el empleado no tiene cuenta bancaria registrada, será omitido en la dispersión PAB. Asegúrate de tenerla antes de aprobar el corte.

4.2 Agregar contrato

Después de crear el empleado (o desde su perfil), haz clic en + Agregar contrato. Campos requeridos:

  • Cargo — denominación del puesto.
  • Tipo de contrato — Indefinido, Fijo, Obra/Labor, Aprendizaje.
  • Salario básico — salario mensual en pesos. No puede ser inferior al SMMLV.
  • Fecha de ingreso — primer día de trabajo. Define el cálculo de todos los acumulados.
  • Incluye auxilio de transporte — marcar si el salario es ≤ 2 SMMLV (requisito normativo).

4.3 Libranzas y embargos

Desde el perfil del empleado, sección Descuentos adicionales, puedes agregar libranzas (créditos de libranza) y embargos judiciales. Cada descuento tiene:

  • Descripción — nombre de la entidad o referencia del embargo.
  • Monto mensual — valor fijo a descontar cada período.
  • Fecha de inicio y fin — el sistema aplica el descuento solo en los cortes dentro del rango.
Importante
Los embargos tienen límites legales: no pueden superar el 50% del salario neto en la mayoría de los casos. Verifica con asesoría jurídica antes de registrar.

4.4 Desactivar y reactivar empleados

Para desactivar un empleado (retiro temporal sin liquidación): perfil del empleado → Desactivar. El empleado no aparecerá en futuros cortes pero conserva todo su historial.

Para reactivar: misma pantalla → Reactivar. Si el empleado fue liquidado, deberás crear un nuevo contrato.


5. Novedades

Las novedades son eventos que modifican el salario del empleado en un período. Deben registrarse antes de calcular el corte.

5.1 Los 12 tipos de novedad

CódigoNombreCuándo usarlaEfecto en nómina
INCAPACIDAD_EPSIncapacidad EPSEnfermedad general o accidente no laboral con certificado médico.Días 1–2 los paga la empresa al 66.67%; días 3+ los paga la EPS al 66.67%.
INCAPACIDAD_ARLIncapacidad ARLAccidente de trabajo o enfermedad laboral con concepto ARL.La ARL reconoce el 100% del salario desde el día 1.
VACACIONESVacaciones disfrutadasPeríodo de descanso remunerado (15 días hábiles/año).Deduce días laborales pero paga salario vacaciones (salario/30 × días).
LICENCIA_REMUNERADALicencia remuneradaLicencia de maternidad, paternidad, luto u otra con derecho a pago.No descuenta días del salario; según tipo puede ser pagada por EPS.
LICENCIA_NO_REMUNERADALicencia no remuneradaPermiso sin goce de sueldo acordado entre partes.Descuenta días laborados proporcionalmente. No se aporta a SS por esos días.
AUSENCIAAusencia injustificadaFalta sin excusa válida ni licencia aprobada.Descuento proporcional del salario y posible afectación disciplinaria.
HORA_EXTRA_DIURNAHora extra diurnaHoras trabajadas después de la jornada ordinaria entre 6am–9pm.Recargo del 25% sobre el valor hora ordinaria.
HORA_EXTRA_NOCTURNAHora extra nocturnaHoras extra trabajadas entre 9pm–6am en día ordinario.Recargo del 75% sobre el valor hora ordinaria.
HORA_EXTRA_DOMINICALHora extra dominicalHoras extra en domingo o festivo diurno.Recargo del 100% sobre el valor hora ordinaria.
HORA_EXTRA_NOCTURNA_DOMINICALHora extra nocturna dominicalHoras extra en domingo/festivo entre 9pm–6am.Recargo del 150% sobre el valor hora ordinaria.
RECARGO_NOCTURNORecargo nocturnoTrabajo ordinario (dentro de la jornada) entre 9pm–6am.Recargo del 35% sobre el valor hora ordinaria.
RECARGO_DOMINICALRecargo dominical/festivoTrabajo ordinario en domingo o festivo sin compensatorio.Recargo del 75% sobre el salario proporcional del día.

5.2 Crear una novedad manualmente

  1. Ve a Novedades → Nueva novedad.
  2. Selecciona el empleado (búsqueda por nombre o cédula).
  3. Selecciona el tipo de novedad.
  4. Ingresa fecha inicio y fecha fin (o cantidad para horas extra/recargos).
  5. Para incapacidades, ingresa el diagnóstico (código CIE-10 o descripción).
  6. Agrega observaciones si es necesario (número de resolución, juzgado, etc.).
  7. Guarda. La novedad queda pendiente y será incluida en el próximo corte del período correspondiente.

5.3 Importar novedades masivamente desde Excel

Para períodos con muchas novedades (ej. cierre de mes con múltiples incapacidades), usa la importación masiva: Novedades → Importar Excel.

Columnas del archivo (encabezados exactos en la fila 1):

ColumnaTipoObligatorioNotas
cedulaTextoCédula del empleado ya registrado.
tipoTextoCódigo exacto del tipo (ej. INCAPACIDAD_EPS).
fecha_inicioYYYY-MM-DDPrimer día de la novedad.
fecha_finYYYY-MM-DDPara ausencias/licencias/vacacionesÚltimo día inclusive.
cantidadNúmeroPara horas extra/recargosNúmero de horas a registrar.
diagnosticoTextoSolo para incapacidadesCódigo CIE-10 o texto libre.
observacionesTextoNoNotas adicionales.
Tip
Descarga la plantilla desde Novedades → Importar Excel → Descargar plantilla. No cambies los nombres de las columnas.

5.4 Error de solapamiento

Si al guardar o importar aparece el error "Novedad solapada", significa que ya existe otra novedad para ese empleado que cubre parte o todo el mismo período.

Pasos para resolverlo:

  1. Ve al perfil del empleado → pestaña Novedades.
  2. Revisa las novedades existentes en el rango de fechas.
  3. Elimina o ajusta las fechas de la novedad conflictiva.
  4. Vuelve a guardar la nueva novedad.

6. Corte de nómina mensual

El corte de nómina es el proceso central del sistema. Consolida todos los devengos y deducciones del mes, genera los desprendibles y produce los archivos para pago y contabilidad.

Flujo completo paso a paso

  1. Captura todas las novedades del mes
    Verifica que todas las incapacidades, vacaciones, horas extra y ausencias del período estén registradas en el módulo de Novedades.
  2. Revisa empleados activos con contrato
    En Empleados, asegúrate de que todos tengan contrato activo y cuenta bancaria registrada.
  3. Crear el corte
    Ve a Nómina → Nuevo corte. Escribe el período en formato YYYY-MM (ej. 2026-04). El sistema crea un corte en estado BORRADOR.
  4. Calcular
    Haz clic en Calcular nómina. El sistema procesa todos los empleados activos aplicando novedades, parámetros normativos vigentes, retefuente y provisiones.
  5. Revisar desprendibles
    Haz clic en cualquier empleado para ver su desprendible detallado. Verifica los totales antes de aprobar.
  6. Aprobar el corte
    Solo disponible para roles ADMIN o CONTADOR. Haz clic en Aprobar corte. El estado cambia a APROBADA. A partir de este momento el corte es de solo lectura.
  7. Generar dispersión bancaria
    Con el corte aprobado, ve a Exportaciones → Dispersión PAB y genera el archivo para Bancolombia.
  8. Generar archivos Contai
    Ve a Exportaciones y descarga los comprobantes 9, 11 (Seguridad Social) y 11 (Provisiones).

6.1 El desprendible explicado

SecciónConceptoDescripción
DEVENGOSSalario básicoSalario proporcional a días trabajados en el mes.
DEVENGOSAuxilio de transporteSi salario ≤ 2 SMMLV. No cotizable para SS.
DEVENGOSHoras extras / recargosValores calculados según tipo de novedad.
DEVENGOSVacaciones disfrutadasPago del período de vacaciones (no es deducción en este mes).
DEVENGOSOtros ingresosBonificaciones, comisiones u otros devengos.
DEDUCCIONESSalud empleado4% del IBC.
DEDUCCIONESPensión empleado4% del IBC.
DEDUCCIONESRetención en la fuenteProcedimiento 1, Art. 383 ET. Puede ser $0.
DEDUCCIONESLibranzas / embargosDescuentos adicionales registrados en el perfil.
APORTE PATRONALSalud patronal8.5% del IBC (0% con exoneración Ley 1607 para salarios ≤ 10 SMMLV).
APORTE PATRONALPensión patronal12% del IBC.
APORTE PATRONALARLSegún nivel de riesgo (0.522% – 6.960%) del IBC.
APORTE PATRONALCCF (Caja)4% del IBC.
APORTE PATRONALSENA2% del IBC (0% con exoneración Ley 1607).
APORTE PATRONALICBF3% del IBC (0% con exoneración Ley 1607).
PROVISIONESPrima de servicios8.33% del salario + AUX transporte (12.5 días por semestre).
PROVISIONESCesantías8.33% del salario + AUX transporte.
PROVISIONESIntereses cesantías1% mensual sobre el saldo de cesantías acumuladas.
PROVISIONESVacaciones4.17% del salario básico.
TOTALIBCSalario base para calcular aportes a seguridad social.
TOTALNeto a pagarTotal devengos − Total deducciones empleado.
Nota
El IBC se calcula como: salario devengado − auxilio de transporte (el aux. transporte no es cotizable). Para empleados con salario integral, aplican reglas especiales.

6.2 Estados del corte

EstadoDescripciónAcciones disponibles
BORRADORCorte creado pero no calculado/aprobado aún.Calcular, eliminar.
APROBADACorte aprobado por admin/contador. Solo lectura.Ver desprendibles, exportar, reversar (solo admin).
PAGADAMarca opcional luego de subir la dispersión al banco.Ver, exportar.
REVERSADAEl corte fue anulado para corrección. No tiene efectos.Crear nuevo corte del mismo período.

7. Liquidación final

La liquidación final se usa cuando un empleado termina su relación laboral, sin importar la causa: renuncia voluntaria, despido con o sin justa causa, mutuo acuerdo, o vencimiento de contrato a término fijo.

Advertencia
No confundas liquidación final con el corte mensual. La liquidación final cierra definitivamente el contrato y calcula los conceptos de ley pendientes. Solo se puede liquidar un empleado que tiene contrato activo.

7.1 ¿Cuándo usar la liquidación final?

  • Retiro voluntario (renuncia): el empleado tiene derecho a todo lo liquidado excepto indemnización.
  • Despido sin justa causa: el empleado tiene derecho a indemnización adicional según días de antigüedad.
  • Despido con justa causa: no hay indemnización adicional.
  • Vencimiento de contrato a término fijo: se liquida igual que una terminación normal.

7.2 Cálculo de días 30/360

Nómina Tools usa el sistema normativo colombiano de meses de 30 días y años de 360 días para todos los cálculos de tiempo. Este es el estándar del Código Sustantivo del Trabajo.

Días del período actual
= (Día de retiro) − (Día inicio del mes) + 1, usando 30 como máximo para el mes
Días del semestre (para prima)
= Días desde el 1 de enero o 1 de julio hasta la fecha de retiro (máx. 180 días)
Días de vacaciones disfrutadas
= Total días de vacaciones gozados en el año corriente. El sistema los toma de las novedades tipo VACACIONES.
Total acumulado cesantías
= Saldo inicial cargado + cesantías provisionadas en todos los cortes

7.3 Proceso paso a paso

  1. Ve a Liquidaciones → Nueva liquidación.
  2. Busca el empleado por cédula o nombre.
  3. Ingresa la fecha de retiro (último día laborado).
  4. Selecciona la causa del retiro.
  5. El sistema calcula automáticamente:
    • Salario días pendientes del último mes.
    • Prima de servicios proporcional al semestre.
    • Cesantías acumuladas (saldo más período actual).
    • Intereses sobre cesantías.
    • Vacaciones pendientes de disfrutar (en dinero).
    • Indemnización por despido sin justa causa (si aplica).
  6. Revisa el detalle de cada fila. Si hay discrepancias, ajusta los días manualmente en los campos editables.
  7. Haz clic en Aprobar liquidación. El empleado queda inactivo automáticamente.

7.4 Qué significa cada fila del resultado

ConceptoFórmula simplificadaNota
Salario pendiente(Salario / 30) × días trabajados en el mes de retiroIncluye auxilio de transporte si aplica.
Prima proporcional(Salario + AUX / 360) × días del semestre × 0.5Fracción del semestre actual no pagada.
CesantíasSaldo acumulado + (Salario + AUX / 360) × días del períodoIncluye saldo inicial cargado.
Intereses cesantíasCesantías × 12% × (días acumulados / 360)Mínimo el proporcional del año.
Vacaciones pendientes(Salario / 720) × días laborados sin vacacionesEn dinero, no en días.
Indemnización sin justa causaEscala legal: 30 días salario/año + proporcionalSolo si causa = DESPIDO_SIN_JUSTA_CAUSA.
DeduccionesSalud + Pensión empleado del período pendienteSobre el IBC del período.
Neto a pagarSuma de devengos − deducciones

8. Exportaciones Contai y PAB

Desde Control → Exportaciones puedes generar todos los archivos necesarios para contabilidad y pago de nómina. Todos los archivos están disponibles solo para cortes en estado APROBADA o PAGADA.

8.1 Comprobante 9 — Nómina

Archivo contable con el resumen de la nómina del período. Incluye una línea por empleado con devengos, deducciones y aportes patronales en formato compatible con el software contable Contai.

  • Cuándo usarlo: al cerrar contabilidad del mes.
  • Contenido: una fila por empleado × período. Columnas: código empleado, centro de costo, cuenta contable, débito, crédito, descripción.
  • Formato: Excel (.xlsx).

8.2 Comprobante 11 — Seguridad Social

Archivo contable de aportes patronales (salud, pensión, ARL, caja, SENA, ICBF) agrupados por entidad. Se usa para registrar el gasto y el pasivo de aportes.

  • Cuándo usarlo: junto con la planilla PILA del mes.
  • Requiere: número de PILA del período registrado en la pantalla de exportación.

8.3 Comprobante 11 — Provisiones

Archivo contable de las provisiones del mes: prima de servicios, cesantías, intereses de cesantías y vacaciones provisionadas.

  • Cuándo usarlo: mensualmente, junto con el cierre contable.
  • Genera una línea de gasto (débito) y una de pasivo (crédito) por cada concepto de provisión.

8.4 Dispersión PAB — Bancolombia

Archivo para subir al portal web de Bancolombia (Pagos en Lote / PAB) y pagar la nómina electrónicamente. El sistema genera un archivo con el formato exacto que requiere el banco.

  • Requiere: código empresa Bancolombia (lo entrega el ejecutivo de cuenta).
  • Contenido: una fila por empleado con número de cuenta, banco, tipo, nombre, cédula y valor neto a pagar.
  • Employees omitidos: empleados sin cuenta bancaria registrada no aparecen en el archivo. Recibe una alerta indicando quiénes fueron omitidos.
Tip
Para configurar el código empresa Bancolombia, ve a Admin → Parámetros → Configuración empresa → Código PAB Bancolombia.

9. Conciliación PILA (UGPP)

La PILA (Planilla Integrada de Liquidación de Aportes) es el archivo que reportas mensualmente a las entidades de seguridad social. La UGPP (Unidad de Gestión Pensional y Parafiscales) fiscaliza que los aportes declarados coincidan con los salarios pagados.

El módulo de conciliación compara los valores de la PILA que liquidaste contra lo que calculó el sistema, e identifica discrepancias antes de que la UGPP las detecte.

9.1 Importar la PILA mensual

  1. Descarga el reporte de la planilla PILA desde el operador (Aportes en Línea, SOI, etc.) en formato Excel.
  2. Ve a Control → Conciliación PILA → Importar PILA.
  3. Selecciona el período y sube el archivo.

Columnas requeridas en el archivo PILA:

ColumnaDescripción
cedulaCédula del empleado.
ibcIngreso Base de Cotización reportado en la PILA.
diasDías cotizados en el período.
aporte_saludTotal aporte salud (empleado + patronal) en la PILA.
aporte_pensionTotal aporte pensión (empleado + patronal) en la PILA.
aporte_arlAporte ARL patronal en la PILA.

9.2 Los 3 estados de conciliación

OK — Los aportes coinciden

La diferencia entre lo declarado en PILA y lo calculado por el sistema es menor a $1 (tolerancia de redondeo). No se requiere acción.

⚠️
ALERTA — Diferencia menor o caso especial

La diferencia está entre $1 y $5.000, o el empleado aparece en la PILA pero no en el sistema (o viceversa), o los días cotizados son diferentes. Revisa manualmente. Puede ser un novedad no registrada o un empleado con incapacidad cubierta por EPS.

ERROR — Discrepancia grave

Diferencia mayor a $5.000, empleado totalmente ausente de la PILA, subcotización (IBC menor al SMMLV sin justificación), o empleado con más de 30 días. Requiere corrección urgente antes del cierre UGPP.

9.3 Qué hacer con cada estado

EstadoAcción recomendada
OKNinguna. El período está conciliado correctamente.
ALERTARevisa el detalle del empleado. Si hay novedad no registrada, créala y recalcula. Si el empleado aparece solo en PILA, verifica si ingresó en el período y no fue registrado.
ERROR — subcotizaciónVerifica si el IBC calculado es correcto. Si el error está en la PILA, presenta corrección ante el operador antes del vencimiento del período.
ERROR — empleado faltante en PILAEl empleado activo no fue incluido en la planilla. Presenta planilla de corrección con el operador PILA. Riesgo de sanción UGPP.
ERROR — diferencia graveIdentifica la causa (novedad no registrada, cambio salarial no aplicado, etc.). Corrige en el sistema y en la PILA. Documenta el ajuste.
Importante
La UGPP puede imponer sanciones de hasta 5 veces el valor de los aportes en mora. Resuelve todos los errores antes del último día del mes siguiente al período conciliado.

10. Certificados laborales

El módulo de certificados genera PDFs de certificado laboral para empleados activos o retirados. Son útiles para trámites bancarios, solicitudes de visa, arriendos, estudios de crédito y otros usos del empleado.

10.1 Generar un certificado

  1. Ve a Control → Certificados.
  2. Busca el empleado por nombre o cédula.
  3. Selecciona el tipo de certificado:
    • Con salario — incluye cargo, fecha de ingreso y salario mensual. Para la mayoría de trámites financieros.
    • Sin salario — incluye cargo y fecha de ingreso, pero omite el valor del salario. Para trámites donde el empleado prefiere discreción.
  4. Ingresa la ciudad de expedición (aparece en el encabezado del certificado).
  5. Haz clic en Generar PDF. El archivo se descarga automáticamente.
Nota
El certificado incluye: nombre de la empresa, NIT, nombre del representante legal firmante (configurable en Admin → Parámetros → Empresa), datos del empleado, fecha de expedición y declaración de vinculación vigente.

10.2 Para empleados retirados

Los empleados liquidados también pueden recibir certificado. El documento indicará que la vinculación estuvo vigente entre las fechas de ingreso y retiro. El tipo de certificado disponible para retirados es siempre sin salario actual (ya que no están activos).


11. Parámetros normativos

Los parámetros normativos son los valores legales que usa el sistema para calcular la nómina: SMMLV, UVT, tasas de cotización, auxilio de transporte, límites para retefuente, etc. Están organizados por vigencia: cada parámetro tiene una fecha desde cuando aplica y (opcionalmente) una fecha hasta cuando aplica.

La regla de oro — NUNCA editar, siempre crear

Importante
NUNCA modifiques un parámetro existente que ya fue usado en un corte aprobado. Editarlo alteraría retroactivamente el cálculo de nóminas pasadas, lo cual es incorrecto y puede generar problemas de auditoría.

La regla es: crear un nuevo parámetro con la nueva vigencia y cerrar el anterior con una fecha de fin el día antes.

Ejemplo: cambio de SMMLV para 2027

Supón que el SMMLV para 2027 fue fijado en $1.520.000. El proceso es:

  1. Ve a Admin → Parámetros.
  2. Busca el parámetro SMMLV vigente (2026-01-01 en adelante).
  3. Edita ese parámetro existente solo para agregar vigenciaHasta: 2026-12-31.
  4. Crea un nuevo parámetro:
    • Nombre: SMMLV
    • Valor: 1520000
    • vigenciaDesde: 2027-01-01
    • vigenciaHasta: (dejar vacío)
  5. Guarda. A partir del primer corte de enero 2027, el sistema usará el nuevo valor automáticamente.
Tip
Puedes realizar este cambio con anticipación. El sistema aplica el parámetro según la fecha del período del corte, no la fecha en que lo creas.

Cuándo necesitas editar parámetros

  • Cambio de SMMLV (normalmente cada enero).
  • Cambio de UVT (normalmente cada enero por resolución DIAN).
  • Reforma de tarifas de cotización a seguridad social (infrecuente).
  • Nueva escala de retención en la fuente (Art. 383 ET).
  • Cambio del porcentaje o tope de intereses de cesantías.

12. Usuarios del sistema

Nómina Tools tiene un sistema de roles que controla qué puede hacer cada usuario. Solo el rol ADMIN puede gestionar usuarios.

Los 3 roles

RolPermisosPara quién
ADMINTodo: crear/eliminar usuarios, editar parámetros, reversar nóminas aprobadas, acceso total a todos los módulos.Administrador del sistema o contador responsable principal.
CONTADOROperar nómina completa: crear/editar/aprobar cortes, exportar archivos, conciliar PILA, generar liquidaciones y certificados. NO puede crear/eliminar usuarios ni editar parámetros.Contador auxiliar, asistente contable.
CONSULTASolo lectura en todos los módulos. No puede crear ni modificar nada.Gerente, revisor fiscal, auditor externo.

Gestión de usuarios

Crear usuario

  1. Ve a Admin → Usuarios → Nuevo usuario.
  2. Ingresa nombre completo, correo electrónico y contraseña temporal.
  3. Selecciona el rol.
  4. Guarda.

Editar usuario

  1. En la lista de usuarios, haz clic en el nombre del usuario.
  2. Edita nombre, correo o rol según necesidad.
  3. Guarda.

Cambiar contraseña

  1. Desde el perfil del usuario, haz clic en Cambiar clave.
  2. Ingresa la nueva contraseña (mínimo 8 caracteres, incluir mayúscula y número).
  3. Guarda. El usuario deberá usar la nueva clave en su próximo inicio de sesión.

Eliminar usuario

  1. En la lista de usuarios, haz clic en el icono de eliminar (papelera) del usuario.
  2. Confirma la acción en el diálogo.
Advertencia
El sistema tiene dos salvaguardas que no se pueden omitir:
No puedes eliminarte a ti mismo.
No puedes eliminar al último administrador — siempre debe haber al menos un ADMIN activo.

13. Preguntas frecuentes

¿Por qué sale "Ya existe una nómina para este período"?

Solo puede existir un corte de nómina por período (mes). Si intentas crear un corte para 2026-04 y ya existe uno, el sistema lo rechaza.

Revisa el estado del corte existente:

  • BORRADOR — puedes recalcularlo o eliminarlo y crear uno nuevo.
  • APROBADA — no puedes crear uno nuevo sin reversar el aprobado. Solo un admin puede reversar.
  • REVERSADA — el corte fue anulado, puedes crear uno nuevo para ese período.

Un empleado fue omitido en la dispersión PAB

Los empleados son omitidos de la dispersión cuando no tienen cuenta bancaria registrada. Pasos:

  1. Ve al perfil del empleado → sección Cuenta bancaria.
  2. Verifica que tenga banco, tipo de cuenta (Ahorros/Corriente) y número de cuenta.
  3. Guarda los datos bancarios.
  4. Vuelve a generar la dispersión PAB. El empleado aparecerá incluido.
Nota
La dispersión puede generarse múltiples veces. Si ya subiste un archivo al banco y luego agregas el empleado, genera uno nuevo solo con ese empleado o con todos (el banco ignorará duplicados si el archivo tiene referencia única).

La conciliación marca errores en salud patronal

Si el sistema calculó $0 en salud patronal pero la PILA muestra un valor, o viceversa, verifica si la empresa aplica exoneración Ley 1607.

La Ley 1607 de 2012 exonera a las empresas de pagar salud patronal (8.5%), SENA (2%) e ICBF (3%) para empleados con salario inferior a 10 SMMLV, siempre que sean personas jurídicas y no personas naturales.

Para verificar y configurar: Admin → Parámetros → Configuración empresa → Exoneración Ley 1607. Si está activa, los aportes patronales de salud, SENA e ICBF serán $0 para los empleados elegibles.

No sé cuántos días poner en la liquidación final

No los pongas manualmente — el sistema los calcula automáticamente a partir de la fecha de ingreso del contrato y la fecha de retiro que ingreses. Solo debes ajustar los días si hay un acuerdo especial documentado.

Recuerda: Colombia usa meses de 30 días y años de 360 días. Aunque febrero tenga 28 días o un mes tenga 31, el sistema usa 30 para todos los meses. Esto es lo correcto según el Código Sustantivo del Trabajo.

¿Qué pasa si cambia el SMMLV en 2027?

Crea un nuevo parámetro con vigenciaDesde: 2027-01-01 antes de procesar el primer corte de enero 2027. Cierra el parámetro 2026 con vigenciaHasta: 2026-12-31. Ver sección 11 para el procedimiento detallado.

Tip
El Ministerio de Trabajo anuncia el SMMLV antes del 31 de diciembre. Puedes configurar el nuevo parámetro con anticipación sin afectar los cortes del año en curso.

¿Puedo modificar un desprendible aprobado?

No directamente. Una vez aprobado, el corte es inmutable para garantizar la integridad del registro. Si necesitas corregirlo:

  1. Un ADMIN debe reversar el corte (Nómina → Corte → Reversar).
  2. El estado cambia a REVERSADA.
  3. Corrige la novedad o el dato que estaba mal.
  4. Crea un nuevo corte para el mismo período.
  5. Calcula y aprueba el nuevo corte.
Advertencia
Si ya subiste la dispersión PAB al banco y la nómina fue pagada, consulta con el área financiera antes de reversar. Puede requerir una nota débito o gestión bancaria adicional.

¿Cómo respalda el sistema la información?

El servidor realiza una copia de seguridad automática de la base de datos cada noche (backup diario). Las copias se retienen por un mínimo de 7 días. En caso de pérdida de datos, el administrador del servidor puede restaurar desde cualquiera de estos puntos.

Adicionalmente, cada exportación que generas (Contai, PAB, conciliación) es tu respaldo local. Se recomienda guardar todos los archivos exportados en una carpeta organizada por año y mes.

¿Qué pasa si pierdo el acceso de administrador?

Si perdiste la clave del último usuario ADMIN y no puedes ingresar al sistema, debes contactar al administrador del servidor (la persona que desplegó y mantiene la aplicación en el VPS).

El administrador puede restablecer la contraseña del usuario admin directamente desde la base de datos o desde la consola del servidor. No hay recuperación de clave por correo en la versión actual.


14. Glosario

TérminoDefinición
SMMLVSalario Mínimo Mensual Legal Vigente. Base de referencia para la mayoría de los cálculos laborales y de seguridad social en Colombia. Para 2026: $1.423.500.
UVTUnidad de Valor Tributario. Medida para expresar los valores tributarios en Colombia. Fijada anualmente por la DIAN. Para 2026: $49.799.
IBCIngreso Base de Cotización. Es el salario sobre el que se calculan los aportes a seguridad social. Equivale al salario devengado sin incluir el auxilio de transporte ni conceptos no constitutivos de salario.
PILAPlanilla Integrada de Liquidación de Aportes. Archivo mensual que reporta y paga los aportes a salud, pensión, ARL y parafiscales de todos los empleados ante las entidades respectivas.
UGPPUnidad de Gestión Pensional y Parafiscales. Entidad del Estado que fiscaliza el correcto pago de aportes a la seguridad social. Puede imponer sanciones por subcotización o pagos incorrectos.
Ley 1607 de 2012Reforma tributaria que creó la exoneración de aportes patronales a salud (8.5%), SENA (2%) e ICBF (3%) para personas jurídicas en empleados con salario inferior a 10 SMMLV.
Art. 383 ETArtículo 383 del Estatuto Tributario. Define la tabla de retención en la fuente sobre pagos laborales. La retención se calcula por Procedimiento 1 (mensualmente) usando la tabla de rangos en UVT.
Retefuente Procedimiento 1Método de cálculo de retención en la fuente mensual: se calcula el impuesto sobre el ingreso mensual usando la tabla de rangos del Art. 383 ET, sin proyectar el año.
CesantíasPrestación social equivalente a un mes de salario por año trabajado. Se acumulan mensualmente (8.33%) y se consignan en el fondo de cesantías del empleado antes del 15 de febrero de cada año.
Prima de serviciosPrestación social equivalente a 15 días de salario por semestre. Se paga en junio y diciembre. Se provisiona mensualmente al 8.33%.
Intereses de cesantíasRendimiento sobre el saldo de cesantías acumuladas. Corresponde al 12% anual, pagados directamente al empleado en enero de cada año (no al fondo).
Exoneración parafiscalesBeneficio de la Ley 1607 por el que personas jurídicas no pagan aportes patronales a salud, SENA e ICBF para empleados elegibles.
Dispersión PABArchivo generado por el sistema para pagar la nómina electrónicamente a través del portal bancario de Bancolombia (Pagos en Lote o PAB).
ContaiSoftware contable colombiano. Los archivos Contai (Comprobantes 9 y 11) son archivos Excel con formato específico para importar automáticamente los registros contables de nómina en ese software.

15. Contacto y soporte

Nómina Tools es una solución administrada. Para resolver dudas técnicas o reportar errores en el sistema, contacta al equipo responsable de tu implementación.

Administrador del sistema
Contacta al administrador asignado a tu empresa para dudas sobre accesos, respaldos o configuración del servidor.
Soporte funcional (nómina)
Para preguntas sobre cálculos, parámetros normativos o novedades especiales, consulta con el contador responsable o con tu asesor laboral.
Reportar un error técnico
Si encuentras un comportamiento inesperado del sistema (error en pantalla, cálculo incorrecto, exportación fallida), anota:
  • La sección del sistema donde ocurrió.
  • El período y/o empleado involucrado.
  • El mensaje de error exacto (captura de pantalla si es posible).
  • Los pasos que realizaste justo antes del error.
Nota
La URL de producción del sistema es https://nomina.one4tools.com. Este manual está disponible públicamente en https://nomina.one4tools.com/manual y no requiere iniciar sesión.
Nómina Tools — Manual v1.0 · Colombia 2026 · one4tools.com