Qué se opera desde la interfaz y qué no¶
Operabilidad recontrastada — septiembre de 2026¶
Corte 067ec7a21cf049451cd349ae473e872883f98e77, BPSPayrollE/dev-fase3, 2026-09-13. PARCIAL: las siguientes entradas están definidas en las vistas fusionadas; salvo la apertura del asistente NIE, no son ejecuciones positivas de este encargo.
| Operación | Ruta/acción actual | Rol y condición |
|---|---|---|
| Calcular bases y aportes previos | Liquidación y recibos → Calcular IBC y aportes del período → Calcular | Administrador BPS; no es la lista de consulta PILA |
| Preliquidar | Liquidación y recibos → Preliquidar período → Confirmar operación | Administrador BPS; el servicio exige también Responsable RR. HH. |
| Generar recibo | Preliquidación coherente → Generar recibo productivo | Administrador; H-8 permanece como precondición pendiente del caso |
| Finalizar / obtener comprobante | Recibo → Finalizar / Descargar comprobante | Finalizar: administrador; descarga según permisos de operador/admin/RR. HH. definidos en la vista |
| Reapertura técnica | Contabilidad → Contable BPS → Reapertura técnica → Solicitar reapertura técnica | Grupo específico de reapertura; ver el menú como administrador no prueba poder solicitar |
| Gate jurídico | Riesgo jurídico → Abrir gate de terminación; ficha → Registrar soporte / Aprobar gate | Jurídico; auditor consulta según permiso |
| Cierre de versión contractual | Liquidación definitiva cerrada → Cerrar versión de contrato | Administrador; no genera por sí solo la liquidación definitiva |
| NIE local | DSNE → Consolidar documento NIE | Asistente abierto con operador; no consolidado |
| Preparación DIAN | Configuración DSNE → Evaluar habilitación DIAN local | Administrador; evaluación local pendiente de ejecutar |
| Expediente / transmisión DIAN | Candidato → Preparar expediente DIAN; expediente → Enviar / Consultar | Preparar es local; envío y consulta son externos y reservados al PO |
No extrapolar permisos por ver un botón en el código. Solicitar la sesión autorizada que corresponde; no elevar al operador. H-8 no se resuelve con el calendario Proc. 2 ni con un registro precargado.
Fuentes del SHA: bps_nomina_app/views/bps_nomina_app_menus.xml, bps_nomina_ibc/views/ibc_periodo_wizard_views.xml, bps_nomina_liquidacion/views/preliquidacion_views.xml, bps_nomina_contable/views/contable_views.xml, bps_nomina_riesgo/views/gate_terminacion_views.xml. Cobertura y pruebas pendientes.
Inventario histórico de agosto — no usar como disponibilidad actual¶
La afirmación histórica de «cuatro operaciones sin interfaz» queda superada, al menos para preliquidación y reapertura. Se conserva abajo con su SHA para trazabilidad; no aplica al corte vigente ni demuestra inexistencia actual de otras acciones.
Qué vas a lograr¶
Saber, antes de sentarte a trabajar, si la operación que necesitas se hace con un botón, con un asistente o si hoy no tiene puerta en la interfaz. Así dejas de buscar un botón que no existe y sabes a quién escalar.
Para qué sirve¶
Nómina BPS expone trece contenedores y 176 opciones de menú. Esa densidad hace que dos operaciones parecidas se vean igual de disponibles aunque una sea ejecutable y la otra no. Esta página separa las tres situaciones:
| Situación | Qué significa para ti |
|---|---|
| Tiene botón | Lo ejecutas tú desde el formulario o la lista. |
| Tiene asistente | Lo ejecutas tú, pero desde una opción de menú que abre un diálogo, no desde el registro. |
| No tiene entrada | Hoy no se puede disparar desde la interfaz. Verlo en una lista no es poder ejecutarlo. |
Qué no hace¶
No es una lista de permisos. Que exista un botón no significa que tu rol pueda pulsarlo: eso lo decide el grupo asignado, y se explica en Roles y seguridad. Tampoco es un listado completo de las 176 opciones; cubre las operaciones del ciclo mensual donde la ausencia de entrada sorprende y hace perder tiempo.
Antes de empezar¶
Necesitas un rol BPS. Sin ninguno de los tres grupos que abren la aplicación, no verás siquiera el icono en el lanzador.
Las operaciones del ciclo mensual¶
Cuatro operaciones del ciclo no se pueden disparar desde la interfaz
En el código verificado no existe ningún botón, asistente, acción de servidor ni tarea programada que las ejecute. No es que estén escondidas: no tienen puerta.
| Operación | Entrada en la interfaz | Dónde está | Modelo |
|---|---|---|---|
| Registrar tiempo y novedades | Sí, creación abierta | Tiempos y novedades | bps.registro.hora, bps.novedad |
| Generar la preliquidación | No | Solo lista de consulta en Liquidación y recibos | bps.preliquidacion |
| Revisar excepción de una preliquidación | Sí, botón | Formulario de la preliquidación | bps.preliquidacion |
| Rechazar una preliquidación | Sí, botón | Formulario de la preliquidación | bps.preliquidacion |
| Finalizar el recibo | Sí, botón Finalizar | Formulario del recibo | bps.recibo |
| Generar el asiento productivo | Sí, botón | Formulario de contabilización | bps.recibo |
| Consolidar la planilla PILA | Sí, asistente | Consolidar planilla del período | bps.pila.planilla |
| Consolidar el documento de nómina electrónica | Sí, asistente | Consolidar documento NIE | bps.dsne.documento |
| Crear el lote bancario local | Sí, asistente | Crear lote bancario local | bps.banco.lote |
| Preflight de pago | Sí, asistente | Preflight de pago (local) | — |
| Generar el checklist de cierre interno | Sí, asistente | Checklist / bitácora de cierre | bps.cierre.checklist |
| Generar el cierre técnico del período | No | Solo lista de consulta en Cierre técnico | bps.cierre.periodo |
| Solicitar la reapertura técnica | No | Solo lista de consulta en Reapertura técnica | bps.reapertura.periodo |
| Ejecutar la liquidación definitiva | No | Lista sin acción de liquidar | bps.liquidacion.definitiva |
| Crear o aprobar el gate de terminación | No existe interfaz | Sin vista, sin acción y sin menú en todo el producto | bps.gate.terminacion |
La trampa de los dos cierres¶
Hay dos cosas distintas llamadas «cierre», en módulos distintos, y solo una se opera desde la interfaz. Confundirlas es el error más fácil de cometer en el cierre de mes.
| Checklist de cierre interno | Cierre técnico del período | |
|---|---|---|
| Modelo | bps.cierre.checklist |
bps.cierre.periodo |
| Cómo se genera | Asistente Checklist / bitácora de cierre, eligiendo compañía, período y tipo | No tiene entrada en la interfaz |
| Qué obtienes | Checklist de cierre o bitácora de auditoría | Instantánea inmutable del período |
| Se puede repetir | El asistente lo vuelve a generar | Es inmutable y rechaza el duplicado |
Si alguien te pide «el cierre» y no aclara cuál, pregunta antes de ejecutar: el checklist se puede rehacer, el cierre técnico no.
Qué hacer si la operación no tiene botón¶
No improvises y no busques atajos por URL. Una operación sin puerta en la interfaz no es un error de tu instalación ni un permiso que te falte.
- Confirma en la tabla de arriba que efectivamente no tiene entrada.
- Escala al responsable técnico de la implantación con el nombre de la operación y el período afectado.
- Deja constancia de por qué la necesitabas y en qué momento del ciclo.
- Si es un cierre o una liquidación definitiva, no repitas el intento: varios de estos artefactos son inmutables y un duplicado queda bloqueado.
Por qué esto no se arregla ejecutando el servicio por tu cuenta
El cierre técnico y la liquidación definitiva producen instantáneas inmutables. Generarlas fuera de su momento del ciclo deja un registro que ya no describe el período y que no se puede regenerar. Es preferible un pendiente declarado que una evidencia falsa.
Cómo comprobarlo por tu cuenta¶
Abre la lista correspondiente. Si el botón Nuevo no aparece y el formulario no ofrece acciones, la operación no se dispara desde ahí. Las listas de preliquidaciones, cierre técnico y reapertura se abren en modo de solo consulta a propósito: los artefactos nacen de servicios, no de formularios.
Ficha de verificación¶
| Dato | Valor |
|---|---|
| Versión de la guía | V1.1 |
| Fecha de verificación | 2026-08-10 |
| Código observado | 4b0f549dd72d6d61dd1eb181d165dbe48459480f |
| Rama | dev-fase3 de xdiegob/PayrollBPS |
| Entorno | Odoo.sh xdiegob-payrollbps, Development, build 36201289, Test: Success |
| Rol usado | Sesión administradora sin grupos BPS (consulta de metadatos, no recorrido funcional) |
| Datos | Base de demostración. Sin datos personales reales |
| Estado externo | No aplica |
Cómo se verificó. Se recorrieron todas las vistas de formulario y lista registradas en el build buscando botones que invocaran cada operación, y además las acciones de servidor y las tareas programadas. Las cuatro operaciones marcadas «No» no aparecen en ninguna de esas tres superficies.
Lo que esta verificación no demuestra. No se ejecutó ninguna de las operaciones con un rol real: la sesión no tenía grupos BPS ni la base tenía nómina sembrada. Que un botón exista no prueba aquí que funcione, solo que está presente y a qué método llama.