Instalación y acceso

Actualización 2026-09-13 — canon y límite de primera nómina

Canon actual: xdiegob/BPSPayrollE, dev-fase3, SHA 067ec7a21cf049451cd349ae473e872883f98e77; Odoo.sh xdiegob-bpspayrolle, Development 37956195, Test: Success observado. El producto exige Odoo 19 Enterprise. Instalar Nómina BPS Colombia — App y navegación resuelve las dependencias: 16 módulos funcionales más la app (17 BPS). Para cliente: base nueva sin demo. No se ejecutó una instalación limpia en esta entrega. El corte aún declara H-8, ausencia de pantalla productora de retención mensual que bloquea recibo y comprobante. Ver Mi primera nómina. La ficha y capturas de agosto que siguen son históricas.

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 · Inventario de módulos confirmado en el build vivo · Estado externo: no aplica.

Objetivo

Dejar una instancia Odoo 19 lista para explorar Nómina BPS sin mezclar instalación técnica, configuración de clientes y operación diaria.

Qué se instala

Nómina BPS son 17 módulos bps_nomina_*. La puerta de entrada es bps_nomina_app, que aporta la aplicación Nómina BPS y reorganiza los menús de los demás módulos por proceso.

Módulo	Frente
bps_nomina_app	Aplicación y navegación
bps_nomina_base	Compañía, empleados, seguridad, auditoría y parámetros
bps_nomina_conceptos	Conceptos laborales y clasificación
bps_nomina_tiempos	Jornada, horas y períodos
bps_nomina_novedades	Novedades, incapacidades y deducciones
bps_nomina_ibc	IBC, aportes y parafiscales
bps_nomina_prestaciones	Prestaciones y provisiones
bps_nomina_retencion	Retención y Formulario 220
bps_nomina_liquidacion	Preliquidación, recibos y comprobante
bps_nomina_pila	Planillas y archivos PILA
bps_nomina_dsne	Documento soporte de nómina electrónica
bps_nomina_firmante	Certificados y firma
bps_nomina_contable	Causación y cierre técnico
bps_nomina_conciliacion	Conciliación, lotes y archivos bancarios
bps_nomina_reportes	Tablero, Pre-UAT y costo laboral
bps_nomina_riesgo	Riesgo jurídico y de contratación
bps_nomina_implantacion	Checklist y puesta en marcha

Escenarios soportados por esta guía

Escenario	Uso recomendado	Advertencia
Odoo.sh Development	Demostración, construcción y pruebas de interfaz	La base es temporal; no guarde datos sensibles ni evidencia única.
Odoo.sh Staging/Production	UAT formal o operación autorizada	Requiere gobierno de accesos, respaldo y política de datos.
Odoo local	Desarrollo/reproducción técnica	No sustituye la validación en el entorno destino.

Instalación del módulo

1. Confirme que el repositorio/branch autorizado contiene los módulos BPS.
2. Actualice la lista de aplicaciones en Odoo.
3. Busque BPS en Apps y compruebe que los módulos esperados estén disponibles.
4. Instale Nómina BPS Colombia — App y navegación; Odoo resuelve sus 16 dependencias funcionales. Enterprise debe estar disponible antes de iniciar.
5. Ingrese a Nómina BPS desde el lanzador y compruebe que aparece la barra de procesos.
6. El responsable de accesos prepara previamente las cuentas autorizadas. En esta actualización se usan sesiones existentes autenticadas por el PO; el agente no crea roles/usuarios ni amplía permisos.

Captura V1.0, canon anterior, con un usuario que sí tenía rol BPS. En el código vigente el icono de la aplicación es el oficial entregado por el PO, no el genérico de esta imagen. Además, la aplicación solo aparece si el usuario tiene un rol BPS: ver el gate documentado en Roles y seguridad.

Verificación mínima de instalación

El instalador debe conservar instalación y actualización del SHA exacto, sin datos demo, estados de los 17 módulos y diagnósticos terminales. Los conteos/tiempos del carril histórico no se trasladan a otra base. La memoria transaccional del catálogo es una optimización interna: no crea un nuevo paso de usuario ni autoriza a reutilizar una vigencia de otro período. Las migraciones de F220, DANE, clasificación y conector preservan límites propios; ante fallo, escalar la primera causa, no saltar scripts ni borrar datos.

Los arneses de integridad/contraste se destinan a un runtime aislado del equipo técnico. No se ejecutan sobre la base del ejemplo para sembrar datos que sustituyan el recorrido humano. Un contraste sintético, una instalación verde y el contraste contra nómina real por concepto son evidencias diferentes; ninguna sustituye las otras. Guía fuente del corte.

Verificación	Resultado esperado	Cómo comprobarlo
Módulos instalados	Los 17 módulos bps_nomina_* en estado Instalado	Apps, buscar bps_nomina
Aplicación visible	Se puede abrir Nómina BPS desde el lanzador	Con un usuario que tenga rol BPS
Navegación	Aparecen los trece contenedores por proceso según el rol	Ver Primer recorrido
Compañía	El selector muestra la entidad de prueba autorizada	Arriba a la derecha
Moneda	La compañía colombiana opera en COP	Ficha de la compañía
Roles	Los seis roles funcionales existen bajo Nómina BPS Colombia	Ajustes → Grupos
Datos demo	Marcados como demostración, no confundibles con datos reales	Nombres claramente sintéticos

Instalar no es lo mismo que ver

Que los 17 módulos estén instalados no implica que veas la aplicación. Si el lanzador no la muestra, casi siempre es porque tu usuario no tiene ningún rol BPS, no porque falte un módulo. Comprueba primero el rol.

Configuración por cliente

La instalación técnica no habilita automáticamente a cada cliente para operar con terceros. Para cada compañía se debe configurar y probar, con sus propios responsables:

• Datos maestros, contratos, conceptos y calendario.
• Perfil/formato de operador PILA.
• Habilitación DIAN por software propio, entorno, software ID, TestSetID y custodia de certificado.
• Perfil bancario, cuenta de origen y formato aceptado por el banco.
• Roles, multiempresa y política de soportes.

No copie secretos durante instalación

Certificados P12/PFX, contraseñas, PIN, tokens y llaves privadas no van en capturas, tickets, PRs ni campos libres. Use el mecanismo de custodia aprobado por la organización.

Si algo falla

Lo que ves	Causa probable	Qué revisar	Cómo recuperarte	Escalar a
No aparece Nómina BPS en el lanzador, pero los módulos están instalados	Tu usuario no tiene rol BPS	Ajustes → Usuarios → tu usuario	Solicita un rol funcional. Ver Roles y seguridad	Administrador de Nómina
No aparece el módulo en Apps	Lista desactualizada, dependencia o rama	Lista de aplicaciones y rama desplegada	Actualiza la lista de aplicaciones con el administrador	Implantador
Ves la aplicación pero un contenedor falta	Ese contenedor exige otro rol	Tabla de roles	Pide el rol específico	Administrador de Nómina
Listas vacías	Compañía activa equivocada	Selector de compañía	Cambia a la compañía correcta	Administrador de Nómina
Error al instalar	Incidencia técnica del entorno	Log del build	Conserva el log sin secretos y escala	Soporte BPS
Datos demo inesperados	Entorno Development	Naturaleza del entorno	No los conviertas en datos reales; usa una UAT gobernada	Implantador