Manual de Usuario - Sistema MOB

Versión revisada: 10 de septiembre de 2026 Alcance: operación, consulta y administración de la aplicación de Distribución de Mano de Obra MOB.

MOB permite configurar la operación, programar órdenes de servicio (OS), registrar actividades de campo con evidencias, auditar novedades del personal, consultar jornadas laborales derivadas, analizar tiempos y costos y administrar el acceso de los usuarios. Las opciones visibles dependen de los permisos asignados a cada cuenta.

1. Flujo general de trabajo

El orden recomendado para poner en marcha la aplicación es:

1. Crear los catálogos en Parámetros.
2. Revisar la configuración de costos en Variables Globales.
3. Registrar el personal en Recursos y, si aplica, los activos en Equipos.
4. Crear las OS en Programación.
5. Consultar la agenda en Calendario & Gantt o Mi Calendario.
6. Registrar el trabajo desde Reportar Actividad.
7. Verificar y complementar la ejecución en Ver Reportes.
8. Registrar licencias no remuneradas y vacaciones en Ingresar Novedades.
9. Consultar jornadas laborales derivadas en los Dashboards, analizar tiempos y costos en Informes (con agrupación por O.S. y filtros por columna) y auditar costos o conciliar horas por quincena en Distribución MOB (con vistas de Costos MOB y Consolidado de horas).

MOB no utiliza perfiles rígidos. Un usuario puede combinar permisos operativos, administrativos y financieros. Si una opción no aparece o responde con acceso denegado, el administrador debe revisar la matriz de permisos.

2. Acceso e interfaz

2.1 Iniciar y cerrar sesión

1. Abra la dirección entregada por el administrador.
2. Ingrese el usuario y la contraseña.
3. Seleccione Ingresar.
4. Para terminar, use Cerrar sesión en la parte inferior del menú lateral.

Las sesiones del servidor se reinician cuando se reinicia la API; en ese caso será necesario autenticarse nuevamente. Una contraseña nueva debe tener al menos ocho caracteres.

2.2 Navegación

• El menú lateral muestra únicamente los módulos autorizados, organizados en cinco secciones temáticas:
• Principal: Dashboard (resumen general de operación y panel de jornada laboral derivada).
• Gestión: Parámetros, Variables Globales, Recursos y Equipos.
• Operaciones: Programación, Calendario & Gantt, Reportar Actividad, Ingresar Novedades, Mi Calendario y Ver Reportes.
• Informes: Dashboard Ejecutivo, Informes y Distribución MOB.
• Sistema: Usuarios, Permisos y Registro Accesos.
• En escritorio, use el botón de hamburguesa del encabezado lateral para contraer el menú a una franja de iconos o expandirlo nuevamente. La aplicación recuerda esta preferencia; al pasar sobre un icono contraído se muestra el nombre del módulo.
• En una pantalla pequeña, abra y cierre el menú con el control de navegación superior.
• El selector de tema permite cambiar entre apariencia clara y oscura.
• Los avisos dentro de cada pantalla informan errores, confirmaciones y estados de sincronización.
• El nombre mostrado como Administrador en el menú indica que la cuenta tiene el permiso permisos; no es un perfil independiente.

3. Configuración inicial

3.1 Parámetros

Este módulo mantiene las combinaciones que se ofrecen al programar y reportar: tarea, cliente, centro de costos, subcentro y local o punto.

Para crear una relación:

1. Seleccione primero la Tarea: MANTENIMIENTOS, CORRECTIVOS, PROYECTOS o VISITAS.
2. Elija el par Cliente / Centro de Costos existente o cree un cliente con su número de centro.
3. Seleccione un subcentro existente, cree uno nuevo o reutilice uno para asociarlo a otra tarea.
4. Registre el local, tienda o punto correspondiente.
5. Guarde y confirme que la relación quede activa.

La aplicación impide combinaciones duplicadas o incompatibles. Un registro inactivo deja de ofrecerse en los formularios nuevos, pero continúa formando parte del histórico.

3.2 Variables Globales

Aquí se configuran los valores usados para clasificar horas y estimar costos:

• salario mínimo, horas por día y días por mes;
• auxilio de transporte y valor por pasaje;
• salud, pensión, ARL, caja de compensación, SENA e ICBF;
• cesantías, intereses, prima y días de vacaciones;
• recargo nocturno, extra diurna, extra nocturna y descanso obligatorio/festivo;
• hora de inicio de la franja nocturna.

Los registros nuevos guardan la tarifa dominical/festiva y la regla de vacaciones que les corresponde. Desde el 1 de julio de 2026 usan 90% y excluyen el auxilio de transporte de vacaciones; los reportes y programaciones que ya existían conservan su política anterior. Los demás cambios se aplican al recalcular informes, dashboards y Distribución MOB, incluso para periodos anteriores. Antes de modificar valores, descargue un respaldo y obtenga aprobación de nómina o contabilidad. Consulte el Manual de Normatividad Laboral.

3.3 Recursos

Use Recursos para registrar o actualizar a cada persona:

• cédula, nombre, ciudad y área;
• estado activo o inactivo y fecha de retiro;
• fecha de ingreso;
• salario y fecha desde la cual rige;
• auxilio de transporte y celular;
• vinculación directa o por temporal y costo de administración.

Cada cambio salarial crea una vigencia. En Vigencias salariales puede corregir la fecha efectiva de cualquier salario guardado; el monto no cambia y queda auditada la fecha anterior y la nueva. MOB usa ese salario como base desde la fecha seleccionada, inclusive, y conserva la vigencia anterior para programaciones o reportes previos. No se admiten fechas duplicadas ni anteriores al ingreso. Para un recurso marcado Por temporal, la administración se calcula automáticamente como 10% de Total 1; para un recurso directo se usa el valor fijo configurado.

Inactivar un recurso evita nuevas asignaciones sin borrar su información histórica.

3.4 Equipos

En Equipos se administra el inventario que puede asociarse a una actividad. Registre el código interno y los datos descriptivos solicitados. Los equipos inactivos dejan de ofrecerse para registros nuevos.

4. Programación de actividades

El módulo Programación requiere permiso de consulta ver_programa. Para crear o modificar información también se necesita agregar_programa.

4.1 Crear una OS

1. Seleccione Agregar Programación. El número de OS se genera automáticamente.
2. Defina la fecha base y el Tipo de Trabajo.
3. Para una actividad operativa, seleccione tarea, cliente, centro, subcentro y local.
4. Agregue uno o varios recursos. Cada línea puede tener su propia fecha y horario.
5. Revise las horas y el costo estimado.
6. Guarde la programación.

Los tipos Mantenimiento Correctivo, Mantenimiento Preventivo, Revisión, Visita, Proyecto y Garantía requieren la información operativa. Las novedades No distribuido, Incapacidad y Vacaciones no requieren cliente, local o tarea, pero sí una observación que explique el motivo. Para No distribuido, MOB asigna automáticamente el centro 1000 y el subcentro 1, y presenta de forma estándar el cliente NO DISTRIBUIDO -1000, la tarea NO DISTRIBUIDO y el local NO DISTRIBUIDO (1); estos campos se muestran bloqueados para evitar una clasificación contable incorrecta.

4.2 Validaciones

• La hora final debe producir una duración mayor que cero y menor que 24 horas.
• Una misma OS no puede repetir el mismo recurso.
• Un recurso no puede tener horarios superpuestos con otra programación, incluso si un turno cruza la medianoche.
• La suma diaria del recurso no puede superar 24 horas.
• MOB advierte cuando la programación proyectada supera 44 horas semanales hasta el 15 de julio de 2026 o 42 horas desde el 16 de julio. La advertencia muestra el total y exige confirmación, pero permite guardar por necesidad operativa.
• Una fecha nueva no puede ser anterior al día actual.
• Los campos operativos o la observación administrativa deben estar completos, según el tipo de trabajo.

Estas validaciones evitan inconsistencias operativas. La advertencia semanal no reemplaza las autorizaciones de trabajo suplementario ni las excepciones legales aplicables.

4.3 Consultar y administrar

• Use el filtro de periodo para ver un día, semana, mes, un rango inclusivo entre dos fechas o todos los registros.
• Use la búsqueda general y los filtros de columna para reducir la lista.
• Paginación de tabla: al pie de la tabla, un control de paginación permite seleccionar 25, 50, 100, 200 o Todos los registros por página, con botones de salto a primera página, anterior, página actual/total, siguiente y última. Esto agiliza el renderizado y evita bloqueos del navegador en periodos con cientos de órdenes de servicio.
• Exportar vista genera un Excel con el resultado filtrado; Exportar todo incluye todas las programaciones cargadas.
• Use Cerrar admin. sobre la línea exacta del recurso cuando deba cerrarse sin reporte. El motivo es obligatorio y el sistema registra fecha, usuario responsable y auditoría. Use Reabrir para devolver una línea cerrada al estado Abierto.
• Editar modifica únicamente una línea Abierta de la OS. Una línea cerrada debe reabrirse antes; si tiene un reporte activo, use Corregir OS o anule primero el reporte. Las programaciones anuladas se conservan como histórico y no se editan.
• Duplicar copia una OS completa y asigna un número nuevo.
• Copiar Rango replica programaciones de un intervalo conservando la separación entre fechas.
• Anular exige una razón y anula la OS correspondiente; los registros anulados no participan en los totales activos.
• Solo la cuenta de acceso juan ve la acción Desanular. Debe documentar un motivo de 10 a 500 caracteres; la app restaura todas las líneas anuladas de la OS a su estado anterior, conserva la anulación original y registra la desanulación en auditoría. La operación se rechaza si produciría cruces de horario, duplicados o conflictos con reportes activos o en curso.

Cuando un técnico reporta una línea programada, esa línea pasa a Cerrado. Si el reporte se anula posteriormente, la línea asociada vuelve a Abierto.

4.4 Calendarios

• Calendario & Gantt permite alternar la vista mensual y la vista cronológica de las programaciones.
• Mi Calendario muestra al técnico, mes a mes, sus órdenes de servicio abiertas y cerradas junto con los reportes completados o parciales. Las OS abiertas del día ofrecen acceso directo para reportar. En un reporte marcado Parcial · en curso, use Continuar reporte para recuperar la jornada, registrar la salida y completar el cierre. Si una foto ya sincronizada se perdió del dispositivo, el servidor la conserva; si no existe ninguna copia, la ausencia queda registrada sin bloquear el reporte.

5. Reportar una actividad

Para usar cámara, geolocalización, instalación PWA y almacenamiento confiable, abra la aplicación mediante HTTPS en producción. Autorice la cámara y, cuando sea posible, la ubicación.

5.1 Preparar el reporte

1. Abra Reportar Actividad.
2. Revise los indicadores de cámara, GPS, conexión, sincronización y almacenamiento.
3. Seleccione una OS abierta. Primero aparecen las del día actual y luego las pendientes de fechas anteriores. Los datos de esa línea se completan automáticamente.
4. Si no existe una OS, deje Sin OS / Actividad manual y complete los campos disponibles.
5. Verifique tipo de trabajo, fecha, cliente, centro, local, subcentro, tarea, equipo y observaciones antes de registrar el ingreso.

En un reporte manual pueden indicarse de cero a cuatro traslados. El costo usa el valor por pasaje configurado. Una OS seleccionada no muestra este campo.

Los tipos administrativos no solicitan los datos de cliente o tarea, pero exigen una observación. Al seleccionar No distribuido, el centro 1000 y subcentro 1 se asignan automáticamente y no se editan, mostrando de forma estándar el cliente NO DISTRIBUIDO -1000, la tarea NO DISTRIBUIDO y el local NO DISTRIBUIDO (1). En los tipos operativos, la tarea de catálogo usada internamente corresponde a:

5.2 Registrar ingreso y salida

1. Pulse Tomar Foto de Ingreso. El botón solo se habilita cuando están completos los datos obligatorios del trabajo; para una novedad administrativa debe estar escrita la observación.
2. En la cámara, capture y confirme la imagen. La aplicación registra por separado la hora del dispositivo y la ubicación disponible.
3. Durante la jornada, el formulario queda bloqueado para proteger la información de ingreso.
4. Al terminar, pulse Tomar Foto de Salida, capture y confirme la imagen.
5. Revise la duración calculada, las observaciones y las evidencias.
6. Seleccione Guardar Reporte o Enviar reporte.

No se digitan manualmente las horas de ingreso y salida. Ambas se fijan al intentar registrar el evento de asistencia. Si la fotografía falla, la hora y el GPS disponible se conservan y la interfaz permite reintentar la imagen sin cambiar la hora original. Si debe empezar de nuevo, use Reiniciar; esto elimina las horas, metadatos y fotos de asistencia del borrador actual.

Los reportes parciales creados antes de esta validación pueden mostrar Reporte abierto con datos pendientes. En ese caso, complete cliente, centro, subcentro, local y tarea en los campos habilitados. Al quedar válidos, la información se guarda y vuelve a bloquearse; entonces puede registrar la salida.

5.3 Evidencias

• La aplicación intenta obtener una foto de ingreso y una foto de salida, pero su pérdida no bloquea un reporte que conserve horas válidas.
• Se permite un máximo de tres imágenes en total: ingreso, salida y una adicional opcional.
• La imagen adicional puede tomarse con la cámara o elegirse desde la galería.
• Se aceptan JPEG, PNG y WebP de hasta 5 MB por archivo antes del procesamiento local.
• Las capturas de cámara incluyen un sello visual con fecha, hora y ubicación disponible.
• La falta de GPS no impide guardar; el reporte conserva la indicación de que la ubicación no estuvo disponible y el motivo informado por el dispositivo.
• Una foto está protegida localmente cuando su miniatura muestra Guardada. Si aparece un error, puede reintentarla; el registro de fecha, hora y GPS disponible permanece protegido.

Un reporte manual solo puede usar el día actual o el día anterior. El día anterior se admite para cerrar un turno nocturno o un registro que quedó pendiente sin conexión. Una OS que continúe abierta puede recuperar su fecha original aunque sea anterior. Si una fotografía ya sincronizada se perdió del dispositivo, el servidor la conserva al completar el reporte; si no existe ninguna copia, el reporte queda identificado con la incidencia de evidencia correspondiente.

MOB rechaza reportes duplicados o solapados para el mismo recurso. Una duración debe ser mayor que cero y menor que 24 horas.

5.4 Borradores, PWA y trabajo sin conexión

Desde esta pantalla puede aparecer Instalar aplicación si el navegador admite la instalación. El botón no se muestra cuando MOB ya está instalada o cuando el navegador no ofrece esa función.

El módulo guarda en el navegador:

• el borrador actual y sus fotografías;
• los catálogos y las OS consultados previamente;
• los reportes finalizados que aún no se han enviado.

Use Guardar Borrador para forzar una copia. El autoguardado también protege los cambios y permite Restaurar o Descartar un borrador detectado.

Si no hay conexión, un reporte completo queda en cola. Cuando vuelve la red, MOB intenta enviarlo automáticamente sin duplicarlo:

• Pendiente: espera conexión o un nuevo intento.
• Sincronizando: se está enviando.
• Al día / Sin pendientes: la cola terminó correctamente.
• Por revisar: el servidor rechazó el contenido y se necesita abrirlo, corregirlo y enviarlo de nuevo.

El modo offline requiere haber iniciado sesión y cargado previamente los catálogos y las OS en ese navegador. No cierre la sesión, no use navegación privada y no borre los datos del sitio mientras existan borradores o elementos en cola. El resto de los módulos y las evidencias ya almacenadas en el servidor requieren conexión.

5.5 Corregir o complementar un reporte

En Mis Reportes Recientes, el técnico puede abrir un registro únicamente cuando un responsable haya activado Habilitar edición desde Ver Reportes.

La edición no reemplaza la información original: los campos y observaciones iniciales permanecen de solo lectura y el técnico puede agregar Observaciones Adicionales o seguimiento.

6. Ver Reportes

Este módulo permite supervisar el histórico ejecutado:

• filtre por día, semana, mes, rango inclusivo de fechas, histórico, búsqueda general o columnas;
• utilice el control de paginación de tabla (25, 50, 100, 200 o Todos los registros) y los controles de navegación rápida (primera, anterior, siguiente, última) para consultar grandes volúmenes de reportes sin ralentizar el navegador;
• visualice los reportes de No distribuido con sus identificadores estándar: cliente NO DISTRIBUIDO -1000, tarea NO DISTRIBUIDO y descripción NO DISTRIBUIDO (1);
• abra las evidencias protegidas por autenticación;
• exporte a Excel el conjunto filtrado (o el histórico completo según la acción elegida);
• use Adición para registrar seguimiento sin alterar la observación original;
• active o desactive la edición para el técnico si tiene editar_reportes, agregar_programa o permisos;
• use Corregir OS para reemplazar una asociación equivocada por una programación abierta y documente el motivo;
• use Cerrar parcial cuando la actividad sí se ejecutó pero el técnico no pudo registrar la salida. Debe indicar la fecha y hora real de cierre y un motivo de 10 a 500 caracteres. Si el parcial tiene una OS asociada, la línea se cierra; si no tiene OS, se crea el reporte final como Sin OS y ninguna programación se crea ni se modifica;
• use Descartar parcial únicamente cuando un reporte en curso se haya iniciado por error. El motivo es obligatorio, el parcial se conserva como descartado para auditoría, no admite reenvíos posteriores y la línea de OS permanece abierta;
• anule un reporte indicando la razón si tiene permisos de gestión.

Después de descartar un parcial iniciado por error, complete un reporte correcto o cierre administrativamente la línea desde Programación. No use el descarte si todavía es posible que el técnico registre la salida y complete las evidencias.

6.1 Resolver una OS abierta por error

1. Primero confirme si el recurso alcanzó a iniciar un reporte. Si puede recuperar las fotografías y registrar la salida, debe usar Mi Calendario → Continuar reporte; al enviarlo, la línea se cierra automáticamente.
2. Si la actividad sí se ejecutó pero no puede completarse desde el dispositivo, un responsable con acceso a Ver Reportes y permiso de gestión (editar_reportes, agregar_programa o permisos) debe seleccionar Cerrar parcial, indicar la fecha y hora real de salida y explicar el motivo. El cierre debe ser posterior al ingreso, no puede estar en el futuro y debe producir menos de 24 horas.
3. Si el parcial tiene una programación asociada y abierta, MOB crea el reporte final y cierra esa línea. Si no tiene programa_id, MOB crea el reporte como Sin OS, conserva los datos y evidencias del parcial y no crea, cierra ni modifica ninguna programación. Una referencia de programación inválida se rechaza y debe corregirse; no se transforma silenciosamente en cierre sin OS.
4. Si el reporte parcial se inició por error o no debe convertirse en trabajo ejecutado, seleccione Descartar parcial, explique el motivo (entre 10 y 500 caracteres) y confirme.
5. El parcial descartado no se elimina: queda conservado como Descartado con su motivo, fecha y responsable en la auditoría. La línea de la OS permanece Abierta y el mismo envío no puede recuperarse ni enviarse posteriormente.
6. El recurso debe descartar o reiniciar el borrador que conserve en el dispositivo original. Si intenta enviarlo de nuevo, la aplicación lo rechazará por estar descartado.
7. Si la actividad no se ejecutó y existe una programación que debe cerrarse, vaya a Programación, ubique la línea exacta del recurso y use Cerrar admin. con un motivo. Se requiere ver_programa para acceder al módulo y agregar_programa para realizar el cambio.

No use Cerrar admin. para reemplazar un reporte válido: ese cierre no genera horas ejecutadas, evidencias ni costos ejecutados. Tampoco use Descartar parcial sobre un reporte final; para corregir un reporte final use Corregir OS o Anular, según corresponda.

Corregir OS toma la fecha, OS, cliente, centros de costo, local, tarea, equipo y recurso directamente de la programación seleccionada. Conserva el horario realmente reportado, las evidencias y las observaciones. La programación anterior se reabre cuando queda sin otro reporte activo y la nueva se cierra en la misma transacción.

Los reportes anulados continúan visibles y trazables, pero se excluyen de los cálculos activos. Al anular un reporte vinculado, la línea de OS vuelve a quedar abierta cuando no conserva otro reporte activo.

7. Módulo Ingresar Novedades

La opción Ingresar Novedades es un módulo dedicado accesible desde el menú de Operaciones para las cuentas con el permiso novedades y cuentas administrativas. Permite registrar ausencias y novedades de personal que impactan directamente la causación y deducciones en Distribución MOB.

7.1 Registrar una novedad

1. Seleccione un recurso operativo activo.
2. Elija el tipo de novedad: Licencia no remunerada o Vacaciones.
3. Indique el período comprendido dentro del mismo mes calendario. Si una novedad cruza el fin de mes, registre una por cada mes correspondiente.
4. Complete la duración según el tipo:

• Licencia no remunerada (LNR): elija entre jornada completa por días o jornada parcial por horas. MOB calcula el valor diario dividiendo el salario base vigente entre 30 y el valor por hora dividiendo el valor diario entre 8. En Distribución MOB, la misma proporción reduce el auxilio de transporte mensual (sin permitir valores negativos). La base neta salario base − licencia + recargos se usa para liquidar pensión, ARL, caja, SENA, ICBF, prima, cesantías, intereses y vacaciones. Las deducciones disminuyen Total 1.
• Vacaciones reconocidas: ingrese los días hábiles reconocidos por Gestión Humana (en incrementos de 0,5 días). MOB liquida el valor reconocido como salario base vigente / 30 × días de vacaciones y lo registra contra las vacaciones causadas acumuladas del año. Esta novedad no descuenta salario ni auxilio de transporte ni altera Total 1; reduce el saldo anual de vacaciones.

1. Ingrese una observación descriptiva que justifique la novedad.
2. Revise la tarjeta lateral de Resumen: muestra el recurso, tipo, período, duración, impacto monetario estimado y una lista de verificación en vivo.
3. Seleccione Guardar licencia o Guardar vacaciones.

7.2 Historial, edición y anulación de novedades

Al pie del módulo se encuentra la sección Novedades registradas:

• Consulta en tiempo real: lista ID, Recurso, Tipo (identificado con pastillas de color distintivas para vacaciones y licencias), Período, Duración, Impacto monetario y acciones disponibles. El botón Actualizar lista recarga el catálogo desde el servidor.
• Editar novedad: pulse Editar sobre una novedad activa. El formulario superior pasa a modo de edición (Novedad ID), permitiendo corregir fechas, días u horas. Use Cancelar edición para descartar los cambios o Guardar cambios para aplicar la corrección. Al guardar, MOB recalcula en cascada el impacto en Distribución MOB y conserva la trazabilidad del usuario y fecha de modificación.
• Anular novedad: pulse Anular sobre una novedad que no deba tener efecto. La novedad pasa al estado visual Anulada, se desactiva su deducción o reconocimiento en Distribución MOB y se conserva en el historial para fines de auditoría.

No se admiten períodos solapados para el mismo recurso entre dos novedades activas de vacaciones o de licencia.

8. Dashboards, informes y distribución

8.1 Dashboard y Dashboard Ejecutivo

La página inicial Dashboard resume la operación diaria y los principales indicadores de actividad. Dashboard Ejecutivo consolida métricas agregadas por período para seguimiento gerencial.

Ambas vistas integran el Panel de Jornada Laboral Derivada (Workday Tracking):

• Proporciona una lectura operacional separada de las horas ejecutadas y de los costos contables.
• Deriva la jornada técnica efectiva desde la primera entrada hasta la última salida registrada mediante reportes de campo en el día.
• Segmenta el tiempo diario en:
• Horas ejecutadas: tiempo invertido directamente en órdenes de servicio y actividades reportadas.
• Horas de traslados: trayectos calculados entre reportes sucesivos del mismo recurso.
• Horas de almuerzo: deducción de la franja de alimentación cuando aplica.
• Métricas consolidadas: Jornada neta, Horas ejecutadas, Horas de traslados, Horas de almuerzo, Meta programada (calculada con base en el límite semanal vigente de 44 h o 42 h), Diferencia (+/− frente a la meta) y porcentaje de Fotos verificadas (cobertura fotográfica de asistencia).
• Gráfico de barras apiladas: visualiza por recurso y fecha la proporción de actividad (azul), trayectos (ámbar) y almuerzo (marrón).
• Alertas operativas: detecta automáticamente solapamientos fusionados, reportes incompletos y faltantes de evidencia fotográfica.
• Exportar detalle: genera un libro Excel con dos hojas: Jornadas diarias (detalle por día, entradas, salidas, horas brutas y netas, alertas) y Resumen semanal (acumulados semanales frente a la meta programada).

8.2 Informes

Permite analizar tiempos y costos del periodo y agrupar los resultados por:

• cliente o recurso;
• centro y subcentro;
• recurso, centro y subcentro;
• orden de servicio (O.S.): presenta el desglose detallado con Cliente, Centro, Subcentro, Local, Tarea, O.S., Planeado, Ejecutado y Variación.

Filtros directos por columna: Cada tabla de informes incorpora campos de filtro de texto en los encabezados (Centro, Subcentro, Recurso, Cliente, Local, Tarea, O.S.). Al escribir en ellos, los registros se filtran al instante y los totales del pie de tabla se recalculan dinámicamente con los datos visibles. Un botón permite restablecer rápidamente todos los filtros.

La exportación a Excel incluye los filtros activos. Los valores reflejan costos gerenciales calculados con la política del registro y los parámetros globales vigentes; no constituyen una liquidación de nómina.

El Informe Centro/Subcentro es el informe contable del período. Toma el Gran Total mensual calculado en Distribución MOB para cada recurso y lo reparte entre sus centros y subcentros según las horas ejecutadas por ese recurso durante el mes. Por tanto, incluye los efectos de administración, celular, traslados, novedades y ajustes manuales que correspondan al recurso. El sistema concilia los redondeos a pesos enteros: el total del informe coincide con el Gran Total visible en Distribución MOB.

Las líneas sin costo ejecutado no se muestran ni se exportan. Si un recurso tiene costo mensual, pero no registra horas en ningún centro/subcentro del período, el valor se presenta en el centro 1000, subcentro 1, como costo no distribuido. Esta regla no altera reportes, programaciones, novedades ni ajustes existentes.

8.3 Distribución MOB

Seleccione mes y año para consolidar por recurso los costos de mano de obra y conciliar las horas ejecutadas.

La barra superior permite alternar entre dos vistas de trabajo:

Vista Costos MOB

Presenta la sábana de costos patronales, aportes, provisiones y totales mensuales:

• Edición mensual de celdas (`canEditAllCells`): los usuarios con permisos avanzados de distribución pueden hacer clic sobre cualquier celda de la tabla para modificar su valor directamente (administración, celular, recargos, aportes o provisiones). La celda modificada se marca con la etiqueta distintiva is-manual (Ajuste manual). Al pasar el cursor se muestra el valor original calculado por el sistema, quién realizó la última modificación y la fecha/hora. Un control permite restaurar el valor calculado original en cualquier momento.
• Ajustes de horas de recargos (`canAdjustSurcharges`): una cuenta con permiso puede ajustar horas de recargo nocturno, extra diurna, extra nocturna y dominical/festivo. Para los reportes, el valor hora se calcula con salario base / 220 hasta el 15 de julio de 2026 y con salario base / 210 desde el 16 de julio de 2026 inclusive.
• Fórmulas de causación vigentes:
• Vacaciones del mes: para recursos temporales (es_temporal = true), se liquida como (Salario base + horas extras y recargos − licencia no remunerada) × días laborados / 30 × 4,34 %. Para los demás recursos: (Salario base − licencia no remunerada) × días laborados / 30 × 4,17 %. Ambas fórmulas excluyen el auxilio de transporte y son proporcionales a los días trabajados.
• Intereses a las cesantías: se liquidan directamente como Cesantías del mes × 12 %. Este valor es el que participa en Total 1.
• Auxilio de transporte neto: se presenta en tres columnas (Aux. mensual, Desc. aux. LNR y Aux. neto) reflejando la deducción proporcional de licencias no remuneradas.
• Total 1 reúne salario base, recargos, auxilio neto, aportes y provisiones. Gran Total agrega administración (10% de Total 1 en temporales o valor fijo en directos), celular y traslados.
• Botón “Informe mano de obra”: genera un archivo Excel exhaustivo con todos los recursos del período seleccionado y el desglose de cada concepto liquidado o ajustado.

Vista Consolidado de horas

Diseñada para auditar y conciliar directamente el consolidado de nómina contra la operación:

• Tabla con desplazamiento horizontal: presenta No., Cédula, Nombres y Apellidos, Cargo, Ciudad, Días trabajados y los 8 conceptos fuente de nómina:

1. HED (Horas Extras Diurnas, factor 1,25).
2. HEN (Horas Extras Nocturnas, factor 1,75).
3. RN (Recargo Nocturno Ordinario, recargo 0,35).
4. RNF (Recargo Nocturno Festivo, factor 1,15).
5. D/F (Dominical o Festivo, factor 1,90).
6. DOM. COMP (Dominical Compensatorio, factor 0,80).
7. HEFD (Horas Extras Festivas Diurnas, factor 2,05).
8. HEFN (Horas Extras Festivas Nocturnas, factor 2,55).

• Total horas: columna de control que suma los ocho conceptos sin duplicar tramos ni componentes.
• Filtro de período: permite alternar entre Consolidado mensual, Primera quincena (días 1 al 15) y Segunda quincena (días 16 al 31).
• Botón “Exportar consolidado”: descarga un archivo Excel estructurado exactamente con las columnas y formatos del consolidado para el período seleccionado.
• Acceso a detalle: cada fila incluye el botón Quincenas para abrir directamente el modal de detalle del empleado.

Modal de Detalle Quincenal (“Quincenas”)

Al hacer clic en Quincenas en cualquiera de las dos vistas:

• Permite ingresar o editar las horas de los ocho conceptos por quincena independiente:
• Primera quincena (1 al 15): aplica la tarifa y divisor correspondiente a la primera mitad del mes (ej. divisor 220 en julio de 2026).
• Segunda quincena (16 al 31): aplica la tarifa y divisor de la segunda mitad del mes (ej. divisor 210 desde el 16 de julio de 2026).
• Incluye campos para Días trabajados (referencia sobre base de 15 días por quincena) y DOM. COMP (0.80).
• Cada concepto se liquida directamente multiplicando sus horas por el factor legal y el valor hora de la quincena. RNF, HEFD y HEFN se registran con su concepto propio y no requieren sumarse a otras columnas.
• Conserva el registro del usuario responsable, fecha y hora de la modificación en auditoría.

9. Administración

9.1 Usuarios y permisos

En Usuarios, Habilitar Acceso crea credenciales vinculadas a un recurso existente. Crear Admin crea una cuenta administrativa independiente: no se incorpora al personal, no aparece en programación, costos, distribución ni métricas operativas. Asigne los permisos necesarios antes de guardar; por seguridad, la cuenta inicia con permisos habilitado para que pueda administrar accesos. Permisos ofrece una matriz rápida, agrupada por operación, reportes/análisis y administración, para activar o retirar accesos a usuarios existentes. Cada encabezado muestra una descripción al pasar el cursor.

La matriz aplica dependencias para evitar accesos incompletos: activar agregar_programa activa también ver_programa, y activar editar_reportes activa ver_reportes. Al retirar una de estas consultas, también se retira su permiso de gestión asociado. Las claves visuales heredadas que ya existan en un usuario se conservan; la matriz nueva muestra únicamente los permisos que la API usa actualmente.

El sistema no permite retirar, desactivar o eliminar la última cuenta activa que tenga el permiso permisos, para conservar siempre una cuenta capaz de administrar usuarios, permisos y respaldos.

Permisos principales:

Por compatibilidad, asigne parametros para guardar Variables Globales, ver_programa para Calendario & Gantt y permisos para administrar Usuarios. Las claves visuales heredadas configuracion, calendario_gantt y usuarios pueden seguir almacenadas en cuentas antiguas, pero no sustituyen esos permisos ni aparecen en la matriz nueva.

9.2 Registro de accesos

Registro Accesos muestra los inicios de sesión registrados y sirve como apoyo de auditoría. Requiere registro_accesos.

9.3 Copias de seguridad

Una cuenta con permisos puede seleccionar el icono de base de datos junto a Cerrar sesión para generar y descargar un archivo .tar.gz que contiene data.json, las fotografías de server/uploads/ y un manifiesto SHA-256 para comprobar su integridad.

El servidor también genera respaldos automáticos y conserva, como máximo, 14 días o 30 archivos. Esas instantáneas automáticas son JSON y no incluyen las fotografías, por lo que no reemplazan el respaldo completo manual. El responsable de infraestructura debe generar periódicamente el respaldo completo, verificar su manifiesto y ensayar la restauración en un entorno seguro.

La pantalla de Permisos ofrece una auditoría informativa de referencias fotográficas ausentes y archivos sin referencia. El sistema no propone ni ejecuta su eliminación automática.

La restauración existe como función técnica de la API y no como pantalla de usuario. No intente sustituir archivos directamente mientras la aplicación esté recibiendo escrituras.

10. Solución de problemas

11. Lista de control operativa

Antes de una jornada:

1. Confirme que el usuario puede iniciar sesión.
2. Abra Reportar Actividad con conexión y cargue las OS.
3. Verifique cámara, espacio local, fecha y hora del dispositivo.
4. Autorice GPS cuando sea posible.

Antes de cerrar el día:

1. Confirme que cada actividad tenga ingreso, salida y estado Guardada en sus fotos.
2. Revise que la sincronización indique Al día o Sin pendientes.
3. Atienda todos los elementos Por revisar.
4. Verifique en Ver Reportes que la ejecución haya llegado al servidor.
5. Verifique en Dashboard el panel de jornadas derivadas para identificar desvíos de horario o ausencias de fotos.

Para información técnica de instalación, persistencia y despliegue, consulte el README del proyecto.

Para la operación diaria en campo, consulte el Manual para Técnicos.

Para detalles de liquidación, recargos y normatividad, consulte el Manual de Normatividad Laboral.