Conexión y claves
Credenciales del panel: variables ADMIN_USER y ADMIN_PASSWORD en el .env del servidor.
Roles y permisos
Los accesos de cada persona se gestionan por usuario en el módulo Usuarios. Allí el super administrador crea cada cuenta y marca a qué módulos puede entrar.
Mantenimiento del sistema
Operaciones sensibles para entornos de prueba. Requiere super administrador.
Plantillas WhatsApp (app móvil)
Mensajes prellenados que el inspector envía manualmente por WhatsApp (opción A).
Use variables entre llaves, por ejemplo {{nombre_cliente}} o {{minutos}}.
Crear usuario del panel
Cree una cuenta para cada funcionario (supervisor, verificador de informes, verificador de fotos, etc.) y marque solo los módulos que necesita.
Usuarios existentes
| Usuario | Nombre | Rol | Módulos | Estado | |
|---|---|---|---|---|---|
| Cargando… | |||||
Bienvenido. Use el menú lateral para cada módulo. Los números de abajo son accesos directos a colas y alertas del día.
Resumen del día
Solicitudes de visita (inspectores)
Las visitas creadas por inspectores requieren aprobación antes de ejecutarse.
Desbloqueos de jornada
Inspectores solicitan autorización para visitas fuera de horario (Mañana/Tarde). Apruebe el desbloqueo remoto o comparta el PIN con el supervisor.
Actividad del día (inspectores y recientes de hoy)
Por inspector
| Inspector | Asig. | Curso | Fin. | N.E. | Pend. | Rech. |
|---|
Últimas actualizaciones
| Cliente | Inspector | Estado | Val. |
|---|
Cola de validación de informe
Informe FR-003 + condiciones de servicio FR-002| ID visita | Nº informe | Cliente | Cuenta | Inspector | Validador | Documentos | Estado informe |
|---|
¿Cómo funciona esta validación?
El inspector envía el informe al cliente de forma instantánea. Aquí un funcionario revisa el informe FR-003 y las condiciones de servicio FR-002 y los aprueba o rechaza. El rechazo llega al inspector como devolución. Es independiente de la validación de registros fotográficos.
Cola de validación
| ID visita | Nº informe | Cliente | Cuenta | Inspector | Validador | Fotos | Alertas | Prioridad IA | Estado |
|---|
¿Necesita ayuda con validación?
Revise formularios, fotos e informes PDF. Apruebe o rechace con observaciones para el inspector.
Reglas inspector → validador
Las visitas nuevas se asignan solas al validador del inspectorConfigure qué validador recibe las visitas de cada inspector. Al sincronizar una visita finalizada, si aún no tiene validador asignado, se aplica la regla automáticamente.
| Inspector | Código | Validador fotográfico | Validador de informe |
|---|
¿Cómo funciona?
Ejemplo: 10 inspectores y 3 validadores. Asigne inspector A → validador 1, inspector B → validador 2, etc. Cuando el inspector finalice y sincronice, la visita aparecerá en Mis asignaciones del validador configurado. La asignación manual visita por visita sigue disponible y tiene prioridad si ya existe.
Por número de informe
Resultados
| ID | Nº informe | Cliente | Cuenta | Fecha | Jornada | Inspector | Estado | Validación |
|---|
¿Necesita ayuda con consultas?
Por dirección: busca en dirección, barrio o municipio.
Por ID de visita: formato V-00000012 (asignado al agendar).
Agenda futura: visitas agendadas con fecha de jornada desde hoy en adelante.
Agendar visita individual
¿Necesita ayuda para agendar?
Complete los datos en orden. La visita se crea sin inspector; asígnela después en Rutas automáticas (varias visitas) o en Asignar inspector (una a una).
Busque la dirección, revise el pin en el mapa y confirme la ubicación antes de agendar.
¿Necesita ayuda con carga masiva?
Pasos: 1) Suba Excel/CSV · 2) Vista previa · 3) En filas manual/inválidas elija municipio y localidad · 4) Importar · 5) Rutas automáticas.
Las filas con coordenadas inválidas (p. ej. 0,0 fuera de Colombia) deben corregirse con municipio/localidad antes de importar o en «Pendientes manual» al simular rutas.
Cargue un archivo Excel (.xlsx) o CSV. Cada fila debe incluir fecha. Las direcciones se guardan en MAYÚSCULAS.
Asignación automática de rutas
Demanda del día por ubicación
Por municipio
| Municipio | Total | Sin asignar | Localidades |
|---|---|---|---|
| Seleccione fecha y pulse Actualizar conteos | |||
Por localidad
| Municipio | Localidad | Total | Sin asignar |
|---|---|---|---|
| Seleccione fecha y pulse Actualizar conteos | |||
Inspectores habilitados para rutas
| Ruta # | Código | Nombre | Activo | Habilitado ruta |
|---|
¿Necesita ayuda con rutas automáticas?
- Elija fecha del día y pulse Simular asignación.
- Compare las 2 opciones (por localidades y menor distancia) en la tabla.
- Revise mapa y tarjetas → Aplicar propuesta.
Las visitas muestran cuenta, localidad y dirección (sin nombre de cliente). Arrastre con ⠿ entre rutas.
La simulación agrupa visitas en Ruta 1, Ruta 2…; elija el inspector en cada tarjeta antes de aplicar.
Aprendizaje: cada vez que aplica una propuesta (o asigna manualmente), el sistema guarda cuenta/localidad/inspector. Con historial, simula mejor y preselecciona inspectores (borde verde).
Por defecto solo entran visitas sin inspector. Reinicie el servidor Node tras actualizar el backend.
Asignación y despacho
Visitas agendadas
| ID visita | Nº informe | Cliente | Cuenta | Dirección | Localidad | Fecha | Inspector | Estado | Validación |
|---|
¿Necesita ayuda con asignación?
Filtre visitas y asigne inspector. Marque varias filas (solo estado asignada) y use Asignar seleccionadas, o abra una fila para editar de a una.
Carga masiva / rutas automáticas: importe muchas visitas y repártalas; aquí puede asignar un mismo inspector a un lote filtrado (ej. sin inspector hoy).
Nuevo inspector
Listado
| Código | Nombre | Cédula | Estado | Ruta auto | Timer herm. |
|---|
¿Necesita ayuda con inspectores?
Cree inspectores con código y contraseña para la app móvil. Inactivo impide el login; Ruta auto controla si recibe visitas en la asignación automática. Timer herm. exige los 12 minutos entre foto inicial y final de hermeticidad (el inspector debe volver a iniciar sesión para aplicar el cambio).
Comparta el código y la contraseña inicial con el inspector. Puede resetear la contraseña desde «Resetear a 1234» o escribiendo una nueva al guardar. Eliminar quita el acceso; las visitas asignadas quedan sin inspector (el historial no se borra).
Cola de digitación
Solo visitas con fotos e informe aprobados| ID visita | Nº informe | Cliente | Cuenta | Inspector | Digitador | Estado |
|---|
Mi bandeja de digitación
| ID visita | Nº informe | Cliente | Cuenta | Municipio | Estado |
|---|
Reglas inspector → digitador
Las visitas aprobadas se asignan solas al digitador del inspectorCuando fotos e informe están aprobados, la visita entra a digitación y se asigna automáticamente al digitador configurado para ese inspector.
| Inspector | Código | Digitador |
|---|
¿Cómo funciona?
Repita el mismo criterio que en validación: asigne cada inspector a un digitador. Las visitas nuevas en cola aparecerán en la bandeja del digitador correspondiente. La asignación manual visita por visita sigue disponible.
¿Cómo funciona la digitación?
Cuando el informe y las fotos están aprobados, la visita entra a esta cola. Un supervisor asigna un digitador; el digitador usa la ficha para copiar los datos a la plataforma de la distribuidora y marca la visita como digitada.
Cree cuentas de digitador en Usuarios y active el permiso Digitación.
Transmisión a SICERCO
Visitas digitadas listas para notificar a SICERCO. Descargue el Excel con el formato de la Superintendencia y el ZIP de PDFs nombrados como {número}.pdf. Seleccione filas para exportar solo esas visitas.
| ID | Nº informe | Cliente | Cuenta | Inspector | Fecha | Estado |
|---|
¿Cómo transmitir a SICERCO?
Cuando la visita está digitada, aparece aquí. Seleccione las visitas, descargue el Excel plantilla SICERCO y el ZIP de PDFs (cada archivo como 108530.pdf), súbalos a SICERCO y marque como transmitida.
Equipos de inspección
| Código | Tipo | Marca | S/N | Inspector | Vence | Estado |
|---|
Nuevo equipo
¿Para qué sirve este módulo?
Registre los equipos usados en inspección (detectores, manómetros, flexómetro, etc.) con su trazabilidad metrológica: certificado, calibración, vencimiento y archivo del certificado. Asigne equipos a inspectores para control operativo.
Funcionarios
| Documento | Nombre | Cargo | Área | Ingreso |
|---|
Nuevo funcionario
¿Para qué sirve este módulo?
Registre la hoja de vida y datos de contacto, contratación, seguridad social, estudios, experiencia y documentos adjuntos (PDF, imágenes u Office) de cada funcionario. Puede vincular un registro con un inspector de la app móvil.
Ubicaciones de visitas
| ID | Cliente | Dirección | Inspector | Estado | Fecha | Mapa agendado | Punto ejecución | Mapa ejecución | Distancia | Fachada |
|---|
¿Necesita ayuda con seguimiento?
Compare la ubicación agendada con el GPS capturado al iniciar la inspección en campo. La distancia indica metros entre ambos puntos.