Visitas técnicas
Gestiona instalaciones, retiros, mantenimientos y atención de campo con actas digitales firmadas y trazabilidad GPS.
El módulo de Visitas Técnicas es donde el administrador agenda, controla y supervisa el trabajo de campo de los técnicos. Cada visita representa un servicio físico que se realizará en sitio del cliente (instalación, mantenimiento, retiro, inspección).
Cómo acceder
- Menú lateral → Operaciones → Visitas técnicas
KPIs del módulo
En la parte superior ves cuatro indicadores con información en tiempo real:
- Hoy — visitas del día: completadas y pendientes
- Esta semana — visitas programadas en la semana actual
- En progreso — técnicos actualmente en campo trabajando una visita
- Completadas (mes) — terminadas este mes con comparativo vs el mes anterior
Pestañas por estado
El listado se organiza en pestañas según el estado de cada visita:
- Todas — vista completa
- Programadas — agendadas, aún no iniciadas
- En progreso — el técnico abrió el acta y está trabajando
- Completadas — finalizadas con firma del cliente
- Canceladas — no se ejecutaron
Tipos de visita
El sistema soporta los siguientes tipos de visita técnica:
| Tipo | Cuándo se usa |
|---|---|
| Mantenimiento Correctivo | Reparar una falla reportada (típicamente generado desde un ticket) |
| Mantenimiento Preventivo | Servicio rutinario para prevenir fallas (limpieza, ajustes, recambio de filtros) |
| Inspección | Revisión general del estado de la máquina sin intervenir |
| Instalación | Colocar una máquina nueva en sitio del cliente (genera Acta de Instalación) |
| Retiro de máquina | Sacar la máquina del sitio del cliente (genera Acta de Retiro con firma del cliente) |
Filtros disponibles
- Buscar número, cliente — búsqueda libre por VIS-YYYY-XXXX o nombre de cliente
- Fecha — filtra por fecha específica
- Todos los tipos — filtra por tipo de visita
- Todos los técnicos — filtra por técnico asignado
Programar una visita técnica
El administrador programa las visitas desde el panel web. Pulsa "+ Nueva visita" y completa el modal:
Campos del formulario
- Cliente (obligatorio) — selector con todos los clientes
- Tipo de visita (obligatorio) — uno de los 5 tipos descritos arriba
- Técnico asignado — selector de técnicos disponibles (puede quedar "Sin asignar" para definir después)
- Máquina — opcional, máquina específica del cliente (puede dejarse "Sin máquina específica" para visitas generales de inspección)
- Ticket relacionado — opcional, si la visita nace de un ticket de soporte
- Fecha (obligatorio) — día programado
- Hora — hora estimada de llegada
- Duración estimada (min) — default 120 minutos, ajustable
- Dirección / Ubicación — dirección completa donde se hará la visita
- Referencia exacta — detalles para encontrar el sitio (ejemplo: "Piso 3, Sala de máquinas, área de cafetería")
- Observaciones / Instrucciones — notas internas para el técnico (acceso, contacto en sitio, herramientas necesarias)
Pulsa "Programar Visita" y la visita queda en estado Programada en el listado.
Ciclo de vida de una visita
Cada visita pasa por tres estados principales:
| Estado | Quién lo cambia | Cuándo |
|---|---|---|
| Programada | Admin | Al crear la visita |
| En progreso | App móvil (automático) | Cuando el técnico abre el acta en sitio |
| Completada | App móvil (automático) | Cuando el técnico cierra el acta firmada por el cliente |
La ejecución del trabajo de campo se hace exclusivamente desde la app móvil VendingPro Mobile en el celular del técnico. El navegador web es solo para administradores (programar, supervisar, reportar). Esta separación garantiza captura de fotos, GPS y firmas reales en sitio.
Qué hace el administrador durante la ejecución
Mientras el técnico trabaja en campo, el administrador puede desde el panel web:
- Monitorear el estado en tiempo real — ver cuántas visitas están en progreso y quiénes son los técnicos en campo
- Ver el detalle de cada visita — entrar al detalle individual desde el listado
- Reasignar técnico si surge un imprevisto y la visita aún no está en progreso
- Cancelar una visita si el cliente la suspende
- Reprogramar a otra fecha
Detalle de una visita
Al hacer clic en el número de la visita (VIS-YYYY-XXXX) entras al detalle. Verás:
- Toda la información del agendamiento
- Estado actual y línea de tiempo
- Datos del técnico asignado
- Una vez completada: el acta digital generada con fotos, checklist, firma del cliente
- PDF descargable del acta
- Historial completo de cambios
Actas digitales generadas
Dependiendo del tipo de visita, al completarla se genera un acta digital diferente:
| Tipo de visita | Acta generada |
|---|---|
| Instalación | Acta de Instalación (espacio, accesorios entregados, prueba de funcionamiento, capacitación al cliente) |
| Mantenimiento Preventivo | Acta de Servicio Técnico (checklist de componentes revisados/limpiados) |
| Mantenimiento Correctivo | Acta de Servicio Técnico (descripción de la falla, solución aplicada, repuestos) |
| Inspección | Acta de Inspección (informe de estado, observaciones) |
| Retiro de Máquina | Acta de Retiro (marca/modelo, número de serie, contador final, condiciones, motivo, accesorios retirados, persona autorizada del cliente) |
Todas las actas se generan en PDF al cerrarse la visita, se envían por correo al cliente automáticamente y quedan archivadas en el sistema.
Exportar
El botón "Exportar" descarga el listado actual (con los filtros aplicados) en Excel. Útil para reportes a gerencia o conciliación con facturación de servicios técnicos.
Quién puede crear visitas
Las visitas técnicas son creadas exclusivamente desde el panel admin por usuarios con rol Super Admin, Gerente u Operaciones. El rol Contabilidad solo puede ver e imprimir actas para conciliación. Los técnicos solo ejecutan las visitas asignadas desde su app móvil.