Primer recorrido¶
Entrada vigente — 2026-09-13
En BPSPayrollE 067ec7a2, build Development 37956195, la aplicación abre Implantación F1 y ofrece una entrada directa Empleados. La navegación observada ya no coincide íntegramente con el árbol histórico de agosto que se conserva abajo. Para el recorrido vigente y sus bloqueos, siga Mi primera nómina — Paso a paso. El operador necesita RR. HH. para acceder a empleados, y H-8 mantiene pendiente la producción de retención del mes y el recibo.
Ficha de verificación
Guía V1.1 · Verificada el 2026-08-11 · Código 4b0f549d (dev-fase3 de xdiegob/PayrollBPS) · Entorno Odoo.sh xdiegob-payrollbps Development, build 36201289 Test: Success · Estructura de menús leída del código y confirmada contra el árbol vivo del build · Estado externo: no aplica.
Qué vas a lograr¶
Reconocer cómo está organizada la aplicación y en qué orden se recorre, sin ejecutar todavía una nómina real.
Para qué sirve¶
Nómina BPS agrupa sus opciones por proceso, no por módulo técnico. Saber leer esa estructura evita el error más común del primer día: entrar por PILA o DSNE antes de tener empleados y cálculo.
Qué no hace¶
Este recorrido no configura DIAN, MiPlanilla ni un banco, y no genera ningún archivo. Esos terceros exigen procesos propios.
Antes de empezar¶
| Necesita | Por qué |
|---|---|
| Un rol BPS asignado | Sin él la aplicación no aparece en el lanzador. Ver Roles y seguridad. |
| Compañía colombiana seleccionada | Moneda, identificación, calendarios y datos fiscales se separan por compañía. |
| Datos sintéticos o una base UAT autorizada | La base de desarrollo Odoo.sh es efímera y no es un archivo de nómina. |
Ruta exacta¶
Lanzador de Odoo → Nómina BPS.
Cómo está organizada la aplicación¶
Bajo la raíz Nómina BPS hay trece contenedores por proceso. Este es el árbol real del commit verificado, en su orden de secuencia:
| # | Contenedor | Qué contiene | Se recorre… |
|---|---|---|---|
| 1 | Empleados y contratos | Empleados no aptos | Al preparar personas |
| 2 | Tiempos y novedades | Tiempos BPS, Registro de horas, Valorización de horas, Periodos quincenales, Novedades BPS, Novedades, Incapacidades, Banderas de riesgo, Reglas de bandera | Durante el mes |
| 3 | Liquidación y recibos | Conceptos, Pre-entradas de trabajo, Preliquidaciones técnicas, Recibos productivos, Liquidaciones definitivas | Al cerrar el mes |
| 4 | Prestaciones | Prestaciones BPS | Después del cálculo |
| 5 | Retención | Retención BPS | Después del cálculo |
| 6 | PILA | IBC, aportes, FSP, ARL, parafiscales, exoneración, tipo de cotizante, planillas, layouts, catálogos, archivos y validación de operador | Salida mensual |
| 7 | DSNE | DSNE y Firmante | Salida mensual |
| 8 | Contabilidad | Contable BPS y Pago y banco BPS | Salida mensual |
| 9 | Reportes y cierre | Control/tablero, Conciliación, Cierre de liquidación | Al cerrar |
| 10 | Riesgo jurídico | Expedientes, acuerdos, litigios, riesgos de contratación, tercerización | Gobierno |
| 11 | Auditoría | Log de overrides, Snapshots de recibos, Log de alertas, Auditoría de base parafiscal, Auditar base parafiscal, Dependencias externas | Rol auditor |
| 12 | Implantación | Checklist F1, Iniciar implantación | Puesta en marcha |
| 13 | Configuración | Configuración, Catálogos, Actualización normativa | Administración |
Árbol histórico
El árbol anterior corresponde al SHA de agosto. La entrada Empleados observada en septiembre informa los permisos faltantes antes de abrir la ficha; no debe confundirse con la antigua lista exclusiva de no aptos. Ver Crear un empleado y contrato.
Recorrido de cinco minutos¶
- Abre Nómina BPS desde el lanzador. Si no aparece, ve a Roles y seguridad.
- Comprueba la compañía activa, arriba a la derecha.
- Recorre los contenedores 1 a 3 en ese orden: son el ciclo mensual central.
- Abre Empleados y contratos → Empleados no aptos: es el diagnóstico que explica por qué alguien no liquidará.
- Abre Reportes y cierre para conocer los semáforos y el estado Pre-UAT.
- Antes de generar cualquier archivo externo, lee la sección Límites de la guía correspondiente.
Resultado esperado¶
Puedes explicar qué proceso estás trabajando, qué compañía está activa, qué evidencia quedará y quién debe continuar si aparece un gate.
Cómo comprobarlo¶
Si una pantalla no muestra datos, no asumas que es un error. Comprueba en este orden: compañía activa, rol, filtros de la vista y período.
Errores y recuperación¶
| Lo que ves | Causa probable | Qué revisar | Cómo recuperarte | Escalar a |
|---|---|---|---|---|
| No aparece Nómina BPS | Sin rol BPS | Tu usuario en Ajustes → Usuarios | Solicita el rol funcional que te corresponda | Administrador de Nómina |
| Falta un contenedor concreto | Ese contenedor exige un rol que no tienes | Tabla de roles en Roles y seguridad | Pide el rol específico | Administrador de Nómina |
| Ves datos de otra empresa | Compañía activa equivocada | Selector de compañía | Cambia de compañía y reabre el registro | Administrador de Nómina |
| La base se reinició | Entorno Development temporal (24–48 h) | Naturaleza del entorno | Usa la evidencia persistida fuera de la base; reconstruye datos sintéticos | Implantador |
Límites y acciones externas¶
La aplicación prepara y conserva evidencia local. No sustituye los portales de DIAN, MiPlanilla ni de un banco, y no ejecuta pagos.
Guías relacionadas¶
- Roles y seguridad · Preparar la compañía
- Siguiente paso: Crear un empleado y contrato