Apariencia
10. MANUAL DEL TÉCNICO
¿Quién debe leer este capítulo? El Técnico o personal de campo que ejecuta los servicios en las instalaciones de los clientes. Este manual explica cómo usar SERVIX desde el teléfono o tableta para registrar el trabajo realizado.
10.1 Acceso desde Dispositivo Móvil
SERVIX funciona desde el navegador de su teléfono sin necesidad de instalar ninguna aplicación:
- Abra el navegador de su teléfono (Chrome recomendado).
- Ingrese la URL del sistema.
- Inicie sesión con su correo y contraseña.
- La interfaz se adapta automáticamente a la pantalla del teléfono.
Recomendación: Instale la app en su pantalla de inicio para ingresar más rápido. Use el enlace que viene en su correo de bienvenida (o pídaselo a su administrador): la app se instala con el nombre y el logo de su empresa. También puede hacerlo desde el navegador:
- En Chrome Android: Menú (⋮) → "Agregar a pantalla de inicio" (o el aviso Instalar [su empresa] que aparece dentro del sistema)
- En Safari iOS: Botón de compartir → "Agregar a pantalla de inicio"
Modo Fuera de Línea
Sus visitas se descargan solas a su celular: al abrir la app, cada 10 minutos mientras esté abierta y en cuanto vuelve la señal. Se guardan las actividades donde usted es responsable o colaborador, de 7 días atrás a 14 días adelante, más las que tenga en curso. No necesita hacer nada antes de salir a campo; basta con abrir la app una vez con señal.
Sin señal, puede trabajar normal:
- Si abre la app sin conexión, en lugar de la pantalla de "Sin conexión" ve la lista de sus visitas guardadas ("N actividad(es) disponibles sin internet", con la hora de la última descarga). Al abrir una, ve su detalle real.
- Puede registrar su llegada, iniciar, llenar el formulario, tomar fotos y completar la visita. Cada paso se guarda en el celular con la hora real en que lo hizo. El formulario se ve en las actividades confirmadas, pero se bloquea ("Inicia la actividad para llenar el formulario") hasta que inicie.
- En la visita aparece lo que está guardado por subir ("Guardado en este celular: llegada, inicio, borrador del formulario, fotos… — se sube solo cuando haya señal"; al cerrarla, "✓ Actividad completada sin señal"). Las fotos pendientes se ven con un reloj ⏳.
- Abajo a la izquierda aparece un botón ámbar con lo pendiente: "⏳ 3 cambios guardados sin señal"; con señal dice "por subir · subir ya" y al tocarlo sube en ese momento.
- Las pantallas que necesitan internet (por ejemplo, crear una cotización) le avisan que no están disponibles sin conexión.
Al volver la señal, todo se sube solo y en orden (llegada → inicio → formulario → fotos → cierre), con la hora en que lo hizo, y la app recarga la pantalla en la que estaba. Si la señal se cae a medio envío, lo que faltó se queda guardado en vez de perderse. En el sello de las fotos y en la bitácora se indica que se hizo sin conexión. Se aceptan cambios de hasta 7 días atrás.
Lo guardado se sube con su sesión. Si otra persona entra en el mismo celular, sus cambios pendientes esperan a que usted vuelva a entrar. Si su sesión venció, el botón le pide entrar de nuevo y entonces se sube; no se pierde nada.
Si algo no se pudo subir, la visita lo dice ("⚠ No se pudo subir: …"). Avísele a su supervisor.
📸 Captura pendiente
** — Dashboard del técnico en móvil
10.2 Dashboard del Técnico
Al iniciar sesión, el Técnico ve el Dashboard de Campo que muestra:
| Sección | Contenido |
|---|---|
| Mis actividades de hoy | Lista de actividades programadas para hoy |
| Próximas | Actividades de los siguientes días |
| Pendientes de completar | Actividades en proceso sin formulario completado |
10.3 Ver Mis Actividades
Ruta: Menú → Mis Actividades
Lista de Mis Actividades
Muestra únicamente las actividades asignadas al Técnico. Los filtros disponibles son:
- Estado: Pendiente / Confirmada / En proceso / Completada
- Período (fecha inicio – fecha fin)
Para cada actividad se muestra:
- Folio de la actividad
- Nombre del cliente y sitio
- Fecha y hora programada
- Estado actual
- Servicio a realizar
10.4 Proceso Completo de una Actividad (Técnico)
Este es el flujo que un Técnico debe seguir para cada actividad:
Paso 1 — Confirmación de la Actividad
Quién confirma normalmente: El cliente, mediante el enlace que recibe por correo o WhatsApp al agendarse la actividad. El Técnico no tiene un botón de "Confirmar Actividad" como paso rutinario — solo revisa los datos.
Si el cliente no ha confirmado y necesita adelantar el trabajo, y su rol tiene los permisos correspondientes:
- Abra la actividad desde su lista o desde el correo/WhatsApp de notificación.
- Revise todos los datos: cliente, sitio, servicio, instrucciones.
- Haga clic en Reenviar confirmación para reenviar el enlace al cliente (por correo o WhatsApp), o en Confirmar manualmente para saltar la confirmación del cliente y pasar la actividad directo a "Confirmada".
La disponibilidad de estos botones depende de los permisos
activities.confirmyactivities.statusde su rol.
Avisar al cliente por WhatsApp: con la actividad Pendiente o Confirmada, el botón Avisar por WhatsApp le deja mandar un Recordatorio de la visita o un Voy en camino con su nombre ("soy [su nombre] de [su empresa], voy en camino…"). Abre WhatsApp con el mensaje listo, dirigido al contacto del sitio o del cliente. Requiere el permiso
activities.notify_whatsapp.
Paso 2 — Verificación de Llegada (Código QR)
Cuándo hacerlo: Al llegar al sitio del cliente.
La verificación QR se activa cuando el administrador habilita el toggle "Verificación QR de llegada" en Configuración → Operaciones. Solo aplica a técnicos — administradores y gerentes acceden directamente sin escanear. Cuando está activa, el sistema busca el código QR en este orden: unidad → sitio → cliente. Si ninguno tiene QR asignado o activo, la verificación se omite automáticamente.
- Abra la actividad.
- Haga clic en Registrar llegada.
- Si la actividad requiere verificación QR:
- El sistema muestra la pantalla de escaneo.
- Solicite al responsable que muestre el código QR de la unidad, sitio o cliente.
- Escanee el código con la cámara de su teléfono.
- El sistema registra automáticamente la hora de llegada.
- Si no se requiere verificación QR (o no hay QR asignado):
- Haga clic en Ya llegué.
- El sistema solicita acceso a su ubicación GPS para registrar las coordenadas precisas de llegada.
- Acepte el permiso de ubicación cuando el navegador lo solicite.
- El sistema confirma la llegada una vez que obtiene una señal GPS con suficiente precisión (puede tomar unos segundos al aire libre).
- La llegada queda registrada, pero la actividad sigue en "Confirmada" — el trabajo aún no inicia formalmente.
- Haga clic en Iniciar actividad para comenzar el servicio. Ahora sí, el estado cambia a "En Proceso".
Consejo para mejor precisión GPS
Para registrar correctamente su ubicación, asegúrese de estar en un área con buena señal (evite sótanos o interiores cerrados al momento de registrar la llegada). Si el GPS tarda más de 20 segundos, el sistema usa la mejor señal disponible en ese momento.
📸 Captura pendiente
** — Pantalla de verificación QR
Paso 3 — Llenar el Formulario del Servicio
Cuándo hacerlo: Durante o después de realizar el trabajo, con la actividad en estado "En Proceso".
- Abra la actividad — el formulario aparece directamente en la misma página, en la sección "Formulario de la Actividad" (no hay pestañas separadas; toda la actividad vive en una sola pantalla con secciones).
- Complete cada campo según el trabajo realizado:
- Campos con asterisco (*) son obligatorios.
- Si su rol tiene el permiso
ai.help, use el botón Completar con IA (arriba del formulario) para que la IA sugiera contenido para todos los campos de texto del formulario a la vez.
- El formulario se guarda automáticamente cada 30 segundos (autoguardado).
- Puede salir y regresar sin perder la información.
Función de autoguardado: Verá un texto pequeño que dice "Guardado automáticamente" cuando el sistema guarda su progreso. Si cierra el navegador accidentalmente, sus datos estarán seguros.
Campo Odontograma dental: toque un diente del diagrama para abrir su editor, marque una o varias condiciones y una nota opcional, y haga clic en Guardar diente. Si toca otro diente sin guardar el anterior primero, el sistema guarda automáticamente el que estaba abierto antes de mostrarle el nuevo — no se pierde la selección en curso.
📸 Captura pendiente
** — Formulario de servicio con campos
Paso 4 — Adjuntar Evidencias
Cuándo hacerlo: Al llenar el formulario del servicio (Paso 3) — no es un paso aparte ni una pestaña separada.
Los campos del formulario habilitados para ello muestran un selector de archivo justo debajo del campo:
- Haga clic en el selector de archivo del campo correspondiente.
- Elija una o varias imágenes o documentos desde su teléfono (cámara o galería, según lo que ofrezca su navegador).
- La evidencia se guarda junto con el resto del formulario.
Además, la sección Evidencias de la actividad tiene el botón Subir fotos o PDF para fotos y documentos generales de la visita (antes y después, hallazgos, etc.).
Cómo se guardan sus fotos:
- El celular reduce la foto antes de subirla, así que sube rápido aunque la señal sea débil. Si eso falla, la foto se sube igual.
- Si su navegador lo pide, permita el acceso a su ubicación: con ella la foto queda ligada al lugar donde la tomó.
- Si su empresa lo activó, cada foto lleva un sello abajo con la fecha y hora (las pone el servidor, no su celular), su nombre, el folio, el sitio y la ubicación.
- Si su empresa pide solo fotos del momento, el botón dice Tomar foto y abre la cámara directamente; las fotos de hace más de 15 minutos se rechazan ("Solo se aceptan fotos tomadas en el momento.").
- Una foto tomada lejos del sitio o que parece de galería (archivo de más de 2 horas) no se rechaza, pero queda marcada con una alerta que ven su supervisor y el cliente en el reporte PDF.
Recomendaciones para evidencias:
- Tome fotos antes y después del trabajo.
- Incluya fotos del equipo con etiquetas o número de serie visibles.
- Documente cualquier hallazgo anormal.
📸 Captura pendiente
** — Pantalla de carga de evidencias
Materiales usados (opcional): si su rol tiene el permiso adicional
activities.materials— no todos los técnicos lo tienen por defecto, pregúntele a su administrador — en el detalle de la actividad también verá la sección "Costos de obra" y el botón Material para registrar el material real que gastó en el trabajo (ej. bultos de cemento, metros de cable) con cantidad y una nota opcional. Descuenta el inventario de inmediato y es independiente de lo cotizado al cliente — no aparece en ningún reporte que reciba el cliente. Se bloquea en cuanto la actividad queda Completada.
Gastos con foto del ticket (opcional): si su rol tiene el permiso
activities.expenses, en la actividad verá el botón Gasto: tome la foto del ticket de lo que compró para el trabajo (gasolina, ferretería, comida) y, si su empresa tiene la IA activa, se llenan solos el proveedor, la fecha, los conceptos y el total. Revise, indique quién pagó — si lo pagó usted, elija Un empleado (reembolsar) y su nombre para que le devuelvan el dinero — y guarde. También se bloquea cuando la actividad queda Completada.
Paso 5 — Bitácora y Comentarios
Cada actividad tiene, al final de la página, una sección "Bitácora y Comentarios" con el historial combinado: los comentarios del equipo y los eventos automáticos del sistema (llegada registrada, formulario completado, cambios de estado, etc.), del más reciente al más antiguo.
Si necesita comunicar algo al supervisor o dejar notas para el expediente:
- Baje hasta la sección Bitácora y Comentarios.
- Escriba su mensaje en el campo de texto.
- Haga clic en Enviar.
No existe distinción entre comentario "interno" o "visible para el cliente" — todos los comentarios son internos, visibles solo para el equipo.
Paso 6 — Completar la Actividad
Cuándo hacerlo: Al terminar completamente el trabajo, con todos los campos obligatorios del formulario llenos (incluida la firma del responsable si el servicio la pide como campo del formulario) y las evidencias adjuntas donde corresponda.
- Revise que la barra de progreso del formulario marque "Formulario completado".
- Haga clic en Completar actividad (botón al final del formulario).
- El estado cambia a "Completada".
- El supervisor y el cliente reciben una notificación automática.
¿Qué pasa si no puede completar el trabajo? Si no termina el servicio (falta de refacciones, cliente no disponible, etc.):
- Abra la sección Tickets de la actividad y haga clic en Reportar incidente.
- Esto abre el formulario normal de creación de tickets, ya vinculado a esta actividad — no hay un selector especial de "motivo".
- Describa el problema en la descripción del ticket.
- El supervisor recibe la notificación y coordina con usted la siguiente acción.
10.5 Agendar un Seguimiento
Esta función requiere el permiso
activities.create, que no forma parte del rol Técnico por defecto en ningún tenant verificado. Si no ve el botón descrito abajo, su rol no lo incluye — consulte con su administrador si lo necesita.
Si durante una actividad identifica un trabajo adicional que debe programarse:
- Abra la actividad actual.
- En la sección Seguimiento, haga clic en Agendar seguimiento.
- Complete los datos de la nueva actividad.
- La nueva actividad queda vinculada a la original (puede verse el árbol de origen en "Linaje", si tiene el permiso correspondiente — ver 10.6).
10.6 Ver el Árbol de Origen (Linaje)
Esta función requiere el permiso
lineage.view, que no forma parte del rol Técnico por defecto en ningún tenant verificado.
Cuando una actividad fue generada a partir de una cotización o de otra actividad anterior, y su rol tiene el permiso lineage.view:
- Abra la actividad.
- Haga clic en el ícono de árbol (esquina superior derecha de la ficha de la actividad, tooltip "Árbol de origen") — no es un botón de texto.
- Se muestra un diagrama visual con el historial completo:
- Cotización original → Actividad principal → Actividades de seguimiento
10.7 Mi Perfil
Ruta: Menú → Mi Perfil (o clic en su nombre en la esquina superior)
Desde su perfil puede:
Cambiar Contraseña
- Vaya a Mi Perfil → Seguridad.
- Ingrese su contraseña actual.
- Ingrese la nueva contraseña (mínimo 8 caracteres).
- Confirme la nueva contraseña.
- Haga clic en Actualizar Contraseña.
Activar Autenticación de Dos Factores (2FA)
La autenticación de dos factores agrega una capa extra de seguridad a su cuenta:
- Vaya a Mi Perfil → Doble factor.
- Descargue una aplicación autenticadora (Google Authenticator, Authy) en su teléfono, si aún no tiene una.
- Haga clic en Activar 2FA — el sistema genera el código QR y la clave manual.
- Escanee el código QR con la aplicación (o ingrese la clave manualmente).
- Ingrese el código de 6 dígitos que muestra la aplicación y haga clic en Confirmar.
No existen "códigos de respaldo" descargables — si pierde acceso a su aplicación autenticadora, un administrador debe restablecer su 2FA desde Usuarios.
Desde este momento, al iniciar sesión necesitará su contraseña + el código de la aplicación.
Activar Login Biométrico (Face ID / Huella)
Esta opción solo aparece si su empresa la tiene habilitada — si no la ve en su perfil, pregunte a su administrador.
Le permite entrar con la huella, Face ID o Windows Hello de este dispositivo, sin escribir su contraseña cada vez:
- Vaya a Mi Perfil → Seguridad.
- Busque la tarjeta "Face ID / Huella".
- Haga clic en Registrar este dispositivo.
- Confirme con la huella o el rostro cuando su sistema operativo lo pida.
Si su dispositivo o navegador no soporta esto, la tarjeta se lo indica en vez de mostrar un botón que no serviría de nada.
Puede registrar varios dispositivos (su celular y su computadora, por ejemplo) — cada uno queda como una fila independiente, con la fecha del último uso, y se puede quitar por separado con Quitar sin afectar a los demás. Nunca reemplaza su contraseña, que sigue funcionando igual como respaldo.
Ver Sesiones Activas
Si cree que alguien más accedió a su cuenta:
- Vaya a Mi Perfil → Sesiones.
- Vea la lista de dispositivos con sesión activa.
- Para cerrar una sesión sospechosa, haga clic en Revocar.
- Para cerrar todas las demás sesiones, haga clic en Cerrar todas las otras sesiones.
📸 Captura pendiente
** — Perfil del usuario con opciones de seguridad