Puestos¶
¿Qué es?¶
El módulo de Puestos administra los puntos físicos donde los empleados registran su asistencia. Un puesto es la ubicación donde el empleado debe estar durante su turno (ej. "Puerta principal Edificio X", "Recepción Torre 2"). Cada puesto está asociado a un proyecto, tiene coordenadas GPS para validar la proximidad, y puede tener auxilios de alimentación y transporte propios.
Vista principal¶
Columnas de la tabla¶
- Nombre — Nombre del puesto de trabajo. Ancho máximo 280 px, truncado.
- Proyecto — Nombre del proyecto al que pertenece. Ancho máximo 240 px, truncado.
- Tipo pago — Badge de color según el tipo de remuneración:
- fijo — Badge azul. Salario fijo por puesto.
- variable — Badge morado. Pago variable según indicadores. Ancho 120 px.
- Dirección — Dirección física del puesto. Texto pequeño (xs), ancho máximo 220 px, truncado.
Filtros¶
- Buscar por nombre o proyecto... — Campo de texto libre.
Ordenación por defecto¶
Ordenada por nombre ascendente.
Acciones disponibles¶
Botón "Nuevo puesto"¶
Visible con permiso positions: create. Abre el modal de creación.
Botón "Importar"¶
Visible con permiso positions: import. Navega a la importación masiva (#/positions-bulk).
Exportar¶
Botón de exportación. Descarga un archivo puestos. Requiere permiso positions: export.
Acciones masivas¶
Al seleccionar uno o más puestos:
- Eliminar — Requiere doble confirmación. Elimina permanentemente el puesto.
- Cerrar selección — Botón X.
Modal de creación / edición¶
Campos del formulario¶
- Nombre — Nombre del puesto (obligatorio).
- Proyecto (
cliente_contract_id) — Autocompletado de proyectos activos (obligatorio). Al enfocar sin texto, carga los primeros resultados. - Tipo de pago (
tipo_pago) — Selector:fijoovariable. - Dirección (
direccion) — Dirección física del puesto. Campo con autocompletado de Google Places (al escribir más de 3 caracteres sugiere direcciones). Al elegir una sugerencia se ubica también el punto en el mapa. Escribir o corregir la dirección a mano no borra el punto ya ubicado. - Código interno (
int_code) — Código o referencia interna de la empresa para este puesto. Texto libre. - Zona interna (
int_zone) — Identificador de zona interna. Texto libre. - Ubicación — Tarjeta con un mini mapa del punto y del radio de marcación, las coordenadas y el botón Ubicar en el mapa (o Ajustar en el mapa si ya tiene punto). Ver Ubicar el puesto en el mapa.
- Auxilio de alimentación (
auxilio_alimentacion) — Valor en COP del auxilio de alimentación específico para este puesto. Si es 0, se usa el valor por defecto de la empresa. - Auxilio de transporte (
auxilio_transporte) — Valor en COP del auxilio de transporte para este puesto. Si es 0, se usa el valor de la empresa.
Validaciones¶
- Nombre es obligatorio.
- Proyecto es obligatorio.
Ubicar el puesto en el mapa¶
En Puestos, la ubicación del puesto y su radio de marcación se eligen en un mapa. Ruta: Portal › Operaciones → Puestos → crear o editar un puesto → Ubicación → Ubicar en el mapa (o Ajustar en el mapa). Se abre la ventana «Ubicación del puesto» con tres formas de poner el punto:
- En el mapa: haz clic donde queda el puesto, o arrastra el marcador al punto exacto. El botón Satélite / Mapa cambia la vista y el botón de centrar vuelve al punto.
- Buscar una dirección o lugar: escribe (por ejemplo «Conjunto Los Almendros, Medellín») y elige una sugerencia. Si buscas una dirección, esa dirección pasa también al campo Dirección del puesto; arrastrar el marcador no cambia la dirección escrita.
- Coordenadas: pega lo que copias en Google Maps (clic derecho sobre el punto), por ejemplo
4.711020, -74.072130, o un enlace de Google Maps. Si no las reconoce, dice «No reconozco esas coordenadas».
Toca Aplicar para llevar el punto y el radio al formulario (o Cancelar para no cambiar nada) y luego Guardar el puesto.
Radio de marcación del puesto¶
En Puestos, el radio de marcación es la distancia máxima, en metros, desde el punto del puesto a la que un empleado puede marcar su asistencia. Fuera de ese radio el registro queda con la alerta de "Discrepancia de ubicación". Se ajusta en la ventana «Ubicación del puesto», en Radio de marcación, de tres formas:
- Con los valores rápidos: 50, 100, 150, 300 o 500 m.
- Con la barra deslizante o escribiendo el número (entre 10 m y 2 km).
- Estirando el borde del círculo directamente sobre el mapa.
La casilla Sin radio propio deja el puesto sin radio: la app permitirá marcar hasta a 5 km del punto, que casi nunca es lo que se quiere. En la tarjeta Ubicación del puesto se ve «Radio de marcación: …» o, si no tiene, «Sin radio propio: se puede marcar hasta a 5 km». Un puesto sin punto dice «Sin punto no se valida la distancia al marcar».
Cobertura de turnos del puesto¶
En Puestos, la cobertura es cuántas personas necesita el puesto cada día: un mínimo y un máximo de turnos de día y un mínimo y un máximo de turnos de noche. Con esa regla la Programación marca en rojo los días en que el puesto queda corto o con gente de más.
Configurarla¶
Ruta: Portal › Operaciones → Puestos → crear o editar un puesto → sección Cobertura (programación) (en el mismo formulario, encima de «Rastreo GPS»).
- Marca Exigir. Aparece la tabla con las columnas Día mín, Día máx, Noche mín y Noche máx. Por defecto arranca en 1 / 1 / 1 / 1 (un turno de día y uno de noche).
- Llena la fila Todos los días. Un máximo vacío significa sin tope.
- Si algún día de la semana o los festivos son distintos, toca Ajustar por día de la semana o festivo y llena sólo esos días (Lunes … Domingo y Festivo). Lo que dejes vacío toma el valor de «Todos los días».
- Guardar el puesto.
Atajo: si el puesto ya tuvo programación, aparece el botón Usar lo de {mes} {año} (por ejemplo «Usar lo de septiembre 2026»). Llena la regla con lo que realmente se programó ese mes: el número de turnos de día y de noche más frecuente, con las excepciones por día que se vieron.
Para quitar la regla, desmarca Exigir y guarda.
Cómo se cuenta¶
- Turno de día = horario que empieza entre las 04:00 y las 13:59. Cualquier otro inicio es turno de noche. Los descansos y las celdas vacías no cuentan.
- Cada turno cuenta sólo el día en que empieza: un turno de 18:00 a 06:00 es un turno de noche de ese día, no del siguiente.
- Se suman todas las líneas de programación del puesto en el mes, de todos los proyectos y programaciones.
- El festivo manda sobre el día de la semana: un lunes festivo usa la regla de Festivo si la hay. Los festivos son los nacionales de Colombia, ya calculados por el sistema.
- Faltar y sobrar son ambos incumplimientos: el aviso dice, por ejemplo, «falta 1 de noche» o «sobra 1 de día y falta 1 de noche».
- Las novedades no se descuentan: un vigilante con ausencia sigue contando como programado. La cobertura revisa la programación, no lo que pasó en el día.
Dónde se ve¶
- Vista mensual de la programación: la píldora Cobertura: todo cumple (verde) o Cobertura: N día(s) no cumple(n) (rojo). Al agrupar por Puesto, cada puesto con regla tiene al pie una fila Cobertura con el conteo
día·nochede cada día (por ejemplo1·1) y en rojo los días que fallan. - Modo edición (rejilla): las celdas del puesto en un día que falla se tiñen de rojo, y la barra muestra Cobertura: N días no cumplen con flechas ‹ › para saltar entre ellos. Al pasar el mouse por la celda: «Cobertura del puesto: falta 1 de noche». Con un filtro de empleado o modalidad activo la validación se apaga («Quita el filtro de empleado o modalidad para validar la cobertura»).
- Preparar mes siguiente: cada proyecto muestra «Cobertura incompleta: N día(s)» y queda en rojo (filtro Atención). Ver Preparar el mes siguiente.
La cobertura no bloquea nada: se puede guardar y crear el mes aunque haya días sin cumplir. Es un aviso para revisar.
Mensajes de error¶
- «Todos los días: los mínimos van de 0 a 50» — los valores van de 0 a 50.
- «… el máximo de día no puede ser menor que el mínimo» (o «de noche») — el máximo quedó por debajo del mínimo, o por encima de 50.
- «El puesto se guardó, pero la cobertura no: …» — el puesto quedó guardado; corrige la cobertura y vuelve a guardar.
- «Esta empresa todavía no tiene la regla de cobertura habilitada.» — falta activar la función en la base de datos de la empresa; hay que pedírselo a soporte.
Consigna del puesto¶
Cada puesto tiene su consigna: lo que el guarda debe cumplir ahí. Para abrirla, haz clic en el nombre del puesto donde aparezca como enlace (por ejemplo en la Programación o en un caso de PQRS): se abre la ficha del puesto con el botón Consigna. Todo sobre versiones, publicación y lectura de la consigna está en Consignas.
Importación masiva de puestos (positions-bulk)¶
La página #/positions-bulk permite crear múltiples puestos a la vez.
Columnas de la hoja¶
| # | Columna | Obligatorio | Notas |
|---|---|---|---|
| 1 | Nombre | Sí | Nombre del puesto |
| 2 | Proyecto | Sí | Nombre del proyecto (debe existir) |
| 3 | Tipo pago | No | fijo o variable |
| 4 | Dirección | No | Dirección física |
| 5 | Distancia máx. | No | Metros (entero) |
| 6 | Auxilio alimentación | No | Valor en COP |
| 7 | Auxilio transporte | No | Valor en COP |
Permisos¶
| Acción | Permiso requerido |
|---|---|
| Ver puestos | positions: view |
| Crear puesto | positions: create |
| Editar puesto | positions: edit |
| Eliminar | positions: delete |
| Exportar | positions: export |
| Importar | positions: import |
Páginas relacionadas¶
- Proyectos — Cada puesto pertenece a un proyecto.
- Asistencia — Los registros de asistencia indican en qué puesto se realizó la marcación.
- Turnos y horarios — Las líneas de programación asignan empleados a puestos específicos.
- Minutas — Las minutas se registran en un puesto.
- Monitor en vivo — Muestra los puestos en el mapa como círculos con etiquetas.
- Consignas — Lo que el guarda debe cumplir en cada puesto.
Preguntas frecuentes¶
¿Cuál es la diferencia entre Tipo pago "fijo" y "variable"? Es una clasificación informativa del tipo de contratación para ese puesto. Fijo indica que el empleado tiene un salario fijo sin importar la cantidad de turnos. Variable indica que la remuneración puede variar (por horas, por asistencia, etc.).
¿Por qué se genera una alerta de "Discrepancia de ubicación" en un empleado? Porque el empleado marcó su asistencia desde una posición GPS que supera el radio de marcación configurado en el puesto. Por ejemplo, si el puesto tiene 100 metros de radio y el empleado marcó a 300 metros, se genera la alerta. Ver Radio de marcación del puesto.
¿Es obligatorio poner las coordenadas GPS de un puesto? No es obligatorio, pero sin coordenadas no se puede validar la proximidad y no habrá datos de distancia ni alertas de discrepancia en los registros de asistencia.
¿Los auxilios del puesto reemplazan los de la empresa? Sí. Si un puesto tiene auxilio de alimentación o transporte configurado con un valor mayor a 0, ese valor tiene prioridad sobre el valor general de la empresa. Si están en 0, se usa el valor de la empresa.
¿Cómo ubico un puesto en el mapa? Al crear o editar el puesto, en Ubicación toca Ubicar en el mapa: haz clic en el mapa, arrastra el marcador, busca la dirección o pega las coordenadas de Google Maps, y toca Aplicar. Ver Ubicar el puesto en el mapa.
¿Cómo pego las coordenadas de Google Maps?
En Google Maps haz clic derecho sobre el punto y copia las coordenadas (o copia el enlace). Pégalas en el campo Coordenadas de la ventana «Ubicación del puesto», por ejemplo 4.711020, -74.072130.
¿Cómo cambio el radio de marcación de un puesto? En la ventana «Ubicación del puesto» usa los valores rápidos (50, 100, 150, 300, 500 m), la barra, o estira el borde del círculo en el mapa. Ver Radio de marcación del puesto.
¿Qué pasa si marco «Sin radio propio»? El puesto queda sin radio y la app permite marcar hasta a 5 km del punto. Casi nunca es lo que se quiere: pon un radio acorde al sitio.
Corregí la dirección del puesto y ¿se perdió el punto del mapa? No. Escribir en el campo Dirección ya no borra la latitud ni la longitud. El punto solo cambia si eliges una sugerencia de dirección o lo mueves en el mapa.
¿Dónde veo la consigna de un puesto? Haz clic en el nombre del puesto donde aparezca como enlace (por ejemplo en la Programación) y toca Consigna. Ver Consigna del puesto.
¿Cómo le digo al sistema cuántos vigilantes necesita un puesto? Con la cobertura: edita el puesto, marca Exigir en «Cobertura (programación)» y pon el mínimo y el máximo de turnos de día y de noche. Si el puesto ya se programó antes, Usar lo de {mes} {año} la llena sola. Ver Cobertura de turnos del puesto.
La programación me marca un día en rojo por cobertura, ¿qué significa? Ese día el puesto tiene menos turnos de los que exige su regla, o más. Pasa el mouse por la celda para ver el detalle («falta 1 de noche», «sobra 1 de día»). No impide guardar.
Un puesto de 24 horas con turnos de 12, ¿cómo se configura? Normalmente 1 de día y 1 de noche (mínimo y máximo en 1). Un turno de 06:00 a 18:00 cuenta como día y uno de 18:00 a 06:00 como noche. Si un día lo cubre un solo turno de 24 horas que empieza en la mañana, cuenta como 1 de día y 0 de noche.
¿Por qué un turno que empieza a las 14:00 cuenta como noche? La regla separa por la hora de inicio: de 04:00 a 13:59 es día y todo lo demás es noche. Un turno de tarde (14:00–22:00) cuenta como noche.
¿Las ausencias o incapacidades bajan la cobertura? No. La cobertura revisa lo programado; las novedades del día no se descuentan.