Quiero calcular y revisar una nómina¶
Paso previo fusionado: Calcular IBC y aportes del período¶
Vistas contrastadas en 067ec7a21cf049451cd349ae473e872883f98e77, 2026-09-13; no ejecutado en el ejemplo. Administrador BPS entra por Liquidación y recibos → Calcular IBC y aportes del período. Selecciona compañía, período y trabajadores autorizados antes de Calcular. El asistente declara que trabaja con contrato vigente el mes completo; los contratos que inician o terminan dentro del mes se omiten con motivo.
En el resultado, revisar calculados, completados, existentes y no procesados. Cada trabajador muestra estado, detalle, Dónde resolver el faltante y enlaces a trazas IBC/aportes; ARL/FSP/parafiscales pueden estar como columnas opcionales. Ya existía no es un cálculo nuevo. Usar Ver cálculos de IBC del período para contrastar la traza y volver después a Preliquidar período; no saltar el productor escribiendo valores en la lista de consulta.
Si aparece no apto, omitido o bloqueado, atender la causa por trabajador y la pantalla indicada antes de avanzar. H-8 sigue separado: completar IBC no produce por sí mismo la aplicación mensual de retención. Fuente: asistente fusionado.
Primera nómina pendiente por H-8 — 2026-09-13
BPSPayrollE 067ec7a2, Development 37956195: el código del asistente exige Administrador de Nómina BPS + Responsable de RR. HH. para preliquidar y generar recibo. La pantalla de Aplicaciones mensuales (retención) es de consulta y la guía de instalación mantiene H-8: falta la entrada que produce la retención del mes. No se generó ni finalizó un recibo nuevo en este recorrido. Las pruebas de agosto que siguen son históricas. Consulte Mi primera nómina antes de planificar el cierre.
Ficha de verificación
BPSNOMINA 1.0 · Verificada el 2026-08-17 · Código 4073760e (dev-fase3 de xdiegob/PayrollBPS) · Entorno: instancia limpia local sobre ese commit, 17 módulos, sin datos de demostración · Roles usados: Operador de nómina y Administrador de Nómina, ambos con rol de RR. HH. · Datos sintéticos · Estado externo: no aplica.
Corrección respecto de la versión anterior de esta guía
La V1.1 de esta página afirmaba que no existía ningún botón ni asistente para ejecutar la preliquidación. Eso era cierto en el commit 4b0f549d; ha dejado de serlo. En el commit congelado de BPSNOMINA 1.0 existe el asistente Ejecutar nómina mensual BPS (F5-F6), comprobado en pantalla. La afirmación anterior queda retirada.
Qué vas a lograr¶
Producir una preliquidación técnica del mes, entender su semáforo de consistencia y llegar al recibo productivo con el neto pagable.
Para qué sirve¶
La preliquidación consolida trazas ya calculadas (aportes, FSP, ARL, parafiscales, deducciones) y las deja revisables antes de producir cualquier salida externa.
Qué no hace¶
No paga, no dispersa y no envía nada a un tercero. El recibo calculado es un insumo trazable, no una instrucción al banco.
Captura V1.0, canon anterior. Los cinco elementos del menú siguen siendo los mismos en el commit verificado; el aspecto del lanzador y el icono de la aplicación sí cambiaron.
Antes de empezar¶
| Control | Qué validar |
|---|---|
| Rol | Operador de nómina o superior. |
| Período | Debe ser un mes calendario completo. La preliquidación por quincena no existe todavía. |
| Personas | Empleados aptos. Ver Crear un empleado y contrato. |
| Novedades | Confirmadas y con soporte. Ver Registrar tiempo o una novedad. |
| Trazas previas | Debe existir exactamente una traza por concepto y empleado en el período. |
Ruta exacta¶
Nómina BPS → Liquidación y recibos
| Opción | Sirve para | Resultado esperado | Límite |
|---|---|---|---|
| Conceptos | Revisar componentes de cálculo | Concepto trazable y clasificado | No sustituye fuente legal ni aprobación de política. |
| Pre-entradas de trabajo | Preparar insumos previos al cálculo | Insumos detectables antes de liquidar | No certifica asistencia externa. |
| Preliquidaciones técnicas | Verificar el cálculo interno | Alertas, diferencias y faltantes visibles | No es comprobante final. |
| Recibos productivos | Gestionar el recibo en su flujo permitido | Recibo trazable por empleado y período | No paga ni envía a terceros. |
| Liquidaciones definitivas | Retiro o terminación | Cálculo y soporte de revisión | Requiere validación jurídica o contable según el caso. |
Cómo nace una preliquidación¶
No se crea a mano
La preliquidación solo la crea el servicio interno (preliquidar). Si intentas crearla directamente verás: «La preliquidacion solo se crea por el servicio (preliquidar).»
Además es inmutable («La preliquidacion es inmutable.») y no se elimina («Las preliquidaciones no se eliminan.»). Esto es deliberado: es una pieza probatoria.
Solo puede existir una preliquidación por empleado, compañía y período.
Sí hay un asistente, y es del Administrador¶
Ruta: Nómina BPS → Liquidación y recibos → Preliquidar período
Instancia limpia local sobre el commit 4073760e, rol Administrador de Nómina, datos sintéticos. El asistente se llama internamente Ejecutar nómina mensual BPS (F5-F6) y su propio aviso lo dice: «Esta confirmación ejecuta el servicio BPS existente. No crea datos de demostración ni reemplaza los controles de trazas y consistencia.» La imagen muestra el asistente abierto; no demuestra el resultado de ejecutarlo.
Pide tres cosas: la operación, el trabajador y el último día del período. Al confirmar, invoca el mismo servicio interno preliquidar, con todos sus controles intactos: el asistente es una puerta, no un atajo.
Un operador de nómina NO puede ejecutarla
La acción está reservada al Administrador de Nómina. Con rol de operador verá esta denegación:
«No puede acceder a los registros 'Ejecutar nómina mensual BPS (F5-F6)' (bps.nomina.ejecutar.wizard). Esta operación está permitida para los siguientes grupos: Nómina BPS Colombia/Administrador de Nómina.»
Es una separación deliberada de funciones: quien prepara los insumos del mes no es quien dispara el cálculo. Planifique el cierre contando con que hace falta el administrador.
Misma instancia y commit, rol Operador de nómina. El mensaje nombra el grupo exacto que sí puede ejecutarla, de modo que el operador sabe a quién pedírselo.
La lista Preliquidaciones técnicas sigue siendo de consulta y revisión: sus botones (revisar excepción, rechazar) actúan sobre una preliquidación ya existente, no crean ninguna.
El semáforo de consistencia¶
Cada preliquidación calcula un estado de Consistencia:
| Estado | Significado | ¿Se puede usar aguas abajo? |
|---|---|---|
| Coherente | Las trazas consumidas concuerdan | Sí: habilita recibo, liquidación y cierre |
| Incoherente | La validación técnica encontró hallazgos | No |
Cuando resulta incoherente, se abre un flujo de revisión humana:
| Estado de revisión | Qué significa |
|---|---|
| No requiere revisión | La preliquidación es coherente |
| Requiere revisión | Hay hallazgos pendientes de decisión humana |
| Excepción revisada (documentada; sigue bloqueada) | Alguien revisó y dejó constancia motivada |
| Rechazada | Alguien revisó y la rechazó |
Una preliquidación incoherente queda bloqueada para siempre
Ninguna decisión humana la desbloquea. La «excepción revisada» solo documenta; el rechazo bloquea. Y no existe remediación en sitio: la preliquidación es inmutable, no se elimina y solo puede haber una por empleado/compañía/período, así que tampoco puedes corregir el dato y volver a ejecutarla para ese mismo período.
La remediación real (supersesión o re-preliquidación) está pendiente de una historia futura. Si llegas a este punto, el camino es registrar la decisión motivada y escalar; no intentes forzar el cálculo.
Los hallazgos permanecen visibles durante la revisión: una excepción revisada no los borra.
Del recibo al comprobante¶
«Productivo» es el nombre de la pantalla, no un estado de producción
La aplicación llama Recibos productivos a los recibos con neto pagable real, para distinguirlos de la preliquidación técnica. El adjetivo describe el tipo de dato, no significa que la nómina se haya pagado, contabilizado, transmitido ni aceptado por un tercero.
El recibo productivo tiene dos estados:
| Estado | Significado |
|---|---|
| Generado | Recibo creado con sus líneas y totales |
| Finalizado | Cerrado; el cambio de estado queda auditado |
Solo el servicio interno cambia el estado; el resto del registro es inmutable. Una vez finalizado, puedes emitir el Comprobante de pago BPS: ver Entregar el comprobante de pago.
Resultado esperado¶
Revisar la historia salarial y los controles previos¶
Contraste de código en BPSPayrollE 067ec7a21cf049451cd349ae473e872883f98e77; no cálculo nuevo demostrado.
- Estructura de nómina: si la compañía activa Exigir estructura de nómina para preliquidar, RR. HH. debe asignar la estructura a la versión del período. Un tipo de estructura sin estructura predeterminada no basta.
FALTA_PLANTILLA_NOMINAse recupera preparando el contrato, no desactivando el control. - Vigencia salarial: la traza conserva segmentos con fechas/días/salario y salarios de inicio/cierre; no equivale a una base mensual prorrateada.
SIN_VIGENCIA_SALARIAL_AL_INICIOimpide retropropagar un salario que comenzó después. RR. HH. revisa las versiones respaldadas; no retrofecha una versión para completar el ejemplo. - Incapacidad y asistencia: además del tiempo valorizado, se cruza la entrada de asistencia nativa en fecha local.
SOLAPE_INCAPACIDAD_ASISTENCIAexige revisar novedad/asistencia con su responsable. No elimina automáticamente ninguna fuente. - FSP: el origen vigente calcula tasa base, Solidaridad, Subsistencia y escalón desde catálogos fuenteados. Comprobar total y componentes, no usar solo la porción base. Una traza histórica con reparto/escalón pendiente no se recalcula silenciosamente al actualizar.
PENDIENTE_FUENTE_FSPrequiere fuente, vigencia y un único escalón aplicable; no inferirlo de una nómina anterior.
Estos controles tienen recuperación propia y no quedan suspendidos por H-8. Capturas pendientes: estructura/versión, segmentos, origen de tiempo y componentes FSP con resultado/negativo/recuperación del caso. Fuentes: gates, salario por vigencia, FSP.
Salida que debe comprobarse¶
- Una preliquidación por empleado y mes, con Consistencia = Coherente.
- Un recibo productivo con devengos, deducciones, retención, aportes del empleador y neto pagable.
Cómo comprobarlo independientemente¶
- Abre la preliquidación y revisa Consumible aguas abajo. Si está en falso, nada posterior procederá.
- Contrasta el subtotal a favor del trabajador con las líneas de origen. No es el neto: el neto solo existe en el recibo.
- Revisa que cada línea declare su concepto BPS y su origen.
Errores y recuperación¶
| Lo que ves | Causa probable | Qué revisar | Cómo recuperarte | Escalar a |
|---|---|---|---|---|
| «No hay traza de … persistida para el empleado en el periodo» | El cálculo previo no se ejecutó | Aportes, FSP, ARL o parafiscales del período | Ejecuta el cálculo que falta y vuelve a preliquidar | Operador de nómina |
| «Hay mas de una traza de … para el empleado en el periodo (ambigua)» | Duplicado en un cálculo previo | Las trazas del concepto indicado | Depura el duplicado antes de preliquidar | Operador de nómina |
| «La preliquidacion tecnica es MENSUAL: el rango debe ser un mes calendario completo» | Se pidió una quincena o un rango parcial | Fechas desde/hasta | Usa el mes completo. La quincena no está disponible | Operador de nómina |
| «El periodo es invalido (hasta < desde)» | Fechas invertidas | Fechas del período | Corrige el orden | Operador de nómina |
| «Ya existe una preliquidacion para el empleado/compania/periodo» | Ya se preliquidó ese mes | La preliquidación existente | Trabaja sobre la existente; no se duplica | Operador de nómina |
| Consistencia = Incoherente | Las trazas no concuerdan | La lista de hallazgos de la preliquidación | Registra la decisión humana motivada. No se desbloquea: escala | Supervisor operativo |
| El empleado no aparece en el universo | No es apto | Empleados no aptos y sus motivos | Completa los datos del empleado y repite | Operador de nómina |
Cobertura funcional y límites¶
La aplicación estructura cálculos y controles internos. Los resultados requieren revisión humana conforme a la política de la compañía y, cuando corresponda, a la fuente normativa y contable aplicable. Calcular un recibo no declara pago, aceptación externa ni contabilidad definitiva.