Del servidor vacío al 46/46 en pantalla.
Esta guía instala el ambiente de evaluación en su propio servidor y define los criterios de aceptación: la instalación está correcta cuando las 46 verificaciones de nómina y las 6 de asistencias se ejecutan en verde dentro de su infraestructura. SOLSE puede realizar este despliegue por usted (está incluido en cualquiera de las opciones de implementación) — la guía existe para que su equipo pueda auditarlo o repetirlo.
Requisitos del servidor
| Componente | Requisito |
|---|---|
| Odoo | Odoo 19 Community (fuentes oficiales o paquete), con acceso al directorio de addons. |
| PostgreSQL | 13 o superior recomendado. |
| Python | 3.10+ con las dependencias estándar de Odoo 19. |
| Localización contable | Plan contable peruano (módulo oficial l10n_pe, disponible en Community) — se instala solo como dependencia. |
| Acceso | Consola del servidor para los comandos de instalación (o dejarlo en manos de SOLSE). |
Los módulos del paquete, en su orden
| Orden | Módulo | Rol |
|---|---|---|
| 1 | solse_pe_payroll_base | Plataforma de compatibilidad: parámetros normativos con vigencias, motor de acumulados y la capa que adapta la base community de nómina. |
| 2 | solse_pe_payroll_ce | El núcleo de la localización: estructuras, los diez frentes de reglas, maestros T-Registro, mapeo contable PCGE y todas las salidas. |
| 3 | solse_pe_payroll_ce_demo | Datos de prueba: la empresa ficticia, los diez trabajadores de la matriz y el validador de 46 verificaciones. Se desinstala al pasar a producción. |
| 4 | hr_attendance | Asistencias estándar de Odoo (gratuito): marcaciones, quiosco, importación y exportación masiva. |
| 5 | solse_pe_payroll_asistencia | Integración de Asistencias: conciliación de faltas, tardanzas y jornadas incompletas contra la boleta. |
Instalación paso a paso
Copie los módulos al directorio de addons
Los cuatro paquetes SOLSE (los ZIP entregados) se descomprimen en el directorio de addons configurado en su instancia. Verifique que cada carpeta contenga directamente su __manifest__.py (sin anidamientos dobles al descomprimir).
Instale con el servicio detenido
Regla de oro del despliegue: las instalaciones y actualizaciones se ejecutan por consola con el servicio Odoo detenido, y el servicio se levanta después. Así el esquema de base de datos y el código siempre avanzan juntos.
# con el servicio Odoo detenido:
python3 odoo-bin -c su_configuracion.conf -d su_base \
-i solse_pe_payroll_base,solse_pe_payroll_ce,solse_pe_payroll_ce_demo,hr_attendance,solse_pe_payroll_asistencia \
--stop-after-init
# levantar el servicio nuevamente
La instalación deja precargados los parámetros vigentes (UIT, RMV, tasas), los maestros T-Registro, el diario de Planillas con su mapeo contable PCGE y las estructuras salariales listas.
Configure la compañía
Ajustes → Compañías: razón social, RUC y País: Perú (el país activa los automatismos de la localización). Si evaluará con la empresa ficticia de prueba, este paso ya viene resuelto por el módulo demo.
Criterio de aceptación 1 — las 46 verificaciones de nómina
Menú Nómina PE → Datos de prueba: ejecute los botones 1 (sembrar empleados), 2 (escenario con boletas de julio y gratificaciones), 3 (cese y liquidación) y 4 (validación). El resultado esperado, en su servidor:
Cualquier diferencia se reporta línea por línea con el valor obtenido y el esperado — no hay "más o menos funciona".
Criterio de aceptación 2 — la conciliación de asistencias
Desde la consola del servidor (shell de Odoo), una línea ejecuta la prueba integral de asistencias — siembra marcaciones de septiembre para tres trabajadores de la matriz y valida los descuentos:
print(env['solse.asistencia.qa'].ejecutar()) env.cr.commit()
Active la acumulación de vacaciones
El devengo de vacaciones (30 días/año) lo materializa el planificador diario de Odoo. En producción corre solo cada noche; para verlo poblado de inmediato en la evaluación, dispare una vez la acción planificada "Accrual Time Off" (Ajustes → Técnico → Acciones planificadas → Ejecutar manualmente). Los saldos aparecen en Vacaciones → Reportes → Balance.
Entregue accesos de evaluación
Cree un usuario para cada evaluador con el permiso Payroll: Responsable (y Contabilidad si revisará los asientos). Con la guía de validación y su lista de verificación imprimible, cada evaluador puede auditar por su cuenta.
Protocolo de actualización (para toda la vida del sistema)
Del ambiente de evaluación a producción
| Datos de prueba | El módulo demo se desinstala (o se despliega una base limpia sin él); sus diez trabajadores y boletas desaparecen con él. Ninguna configuración real depende del demo. |
| Carga inicial | Trabajadores y contratos se cargan masivamente desde su Excel / T-Registro (incluido en la Implementación acompañada), y el historial de asistencias por el importador nativo. |
| Planillas en paralelo | Recomendamos dos periodos calculados en simultáneo con su sistema actual, conciliando diferencias antes del corte — es parte de la Opción B de implementación. |
| Respaldo | Su política estándar de backups de PostgreSQL cubre todo: datos, configuración y parámetros viven en la base de datos. |