Guía · Conector SYSOWEB · Atenciones
Las atenciones de SYSOWEB llegan solas al dashboard
Cuando está habilitado y validado, el robot del servidor lee SYSOWEB (AVAIN) cada hora y carga lo nuevo sin que nadie instale nada. Como respaldo manual, la extensión de Chrome «Conector SYSOWEB · Atenciones» trae las atenciones usando tu sesión abierta en Chrome. Los dos solo leen: nunca crean, modifican ni borran nada en SYSOWEB, y la extensión nunca guarda tu contraseña. El nombre del trabajador y los textos clínicos se quitan antes de salir de tu navegador; el DNI y el profesional viajan cifrados (TLS) al servidor del dashboard solo para convertirse en huellas irreversibles que detectan duplicados, y no se guardan.
Sincronización automática: el robot del servidor
Cuando está habilitado y validado, el robot del servidor entra a SYSOWEB cada hora con un usuario propio de solo lectura y carga lo nuevo en el dashboard. Relee los últimos 7 días de cada módulo (los duplicados se descartan solos) y, la primera vez, trae el historial del año en curso. Su estado está en Datos → «Sincronización automática»: «Al día · última corrida hace 12 min», la próxima corrida y, por módulo, hasta qué fecha hay datos.
Recorre las mismas pantallas que la extensión, con la misma lista blanca (Buscar, Exportar, ajustar columnas en la sesión e Imprimir; jamás «Guardar») y el mismo tratamiento de datos. Si SYSOWEB pide un captcha, rechaza la contraseña o cambia sus pantallas, se detiene sin reintentar y la tarjeta dice qué hacer; por ejemplo: «SYSOWEB pidió un captcha: entrá una vez a mano con el usuario del robot y tocá Reanudar». El robot nunca resuelve ni evade un captcha.
La extensión de esta guía es el respaldo manual. Solo la necesita quien sincroniza (superadmins y cuentas con el rol sincronizar), para cuando el robot está detenido o apagado; en Datos está dentro del bloque plegado «Respaldo manual: extensión de Chrome». Quien solo mira el tablero y el reporte no instala nada.
Extensión de respaldo: tres pasos, una sola vez por equipo
Instalar la extensión
Desde la ficha de Chrome Web Store o cargando la carpeta descomprimida. El dashboard la detecta sin recargar.
Vincular con el dashboard
Automático: con tu sesión iniciada en el dashboard, la página le pasa a la extensión un token de una hora.
Iniciar sesión en SYSOWEB
En una pestaña nueva, con tu usuario y el captcha. Al volver, la extensión trae sola el historial del año en curso.
Al terminar, el bloque «Respaldo manual: extensión de Chrome» de la pantalla Datos muestra «Conectado · última sincronización hace X min» y, por módulo, hasta qué fecha hay datos. Requisitos: Google Chrome 120 o posterior (o Edge). No hace falta reiniciar.
1 · Instalación
Desde Chrome Web Store (publicación no listada)
- Abrí el enlace que figura en el dashboard (Datos → «Instalar desde Chrome Web Store»).
- «Agregar a Chrome» → «Agregar extensión». Listo: el dashboard la detecta solo.
Carga descomprimida (mientras no esté publicada)
- En el dashboard, Datos → «Descargar extensión (.zip)» (archivo
conector-sysoweb-atenciones-vX.Y.Z.zip). Descomprimilo en una carpeta que no vayas a borrar (por ejemploDocumentos/conector-atenciones). - En Chrome abrí
chrome://extensionsy activá Modo de desarrollador (arriba a la derecha). - Cargar descomprimida → elegí la carpeta donde descomprimiste el zip (la que tiene
manifest.json). - Volvé al dashboard: el paso 1 del asistente se marca como hecho sin recargar.
2 · Vincular con el dashboard
Es automático: con la extensión instalada y tu sesión iniciada en el dashboard, la página le pasa a la extensión un token de acceso de una hora (nunca tu contraseña). En Datos vas a ver «Vinculada como <tu correo>».
Si el token vence, el dashboard lo renueva solo cada vez que lo abrís. Mientras el dashboard esté cerrado y el token vencido, la extensión espera; si hace falta, el botón «Reintentar el vínculo» de Datos pide uno nuevo.
3 · Iniciar sesión en SYSOWEB
- Datos → «Iniciar sesión en SYSOWEB» (se abre
pae.avainsistemas.comen una pestaña nueva). También desde el popup de la extensión. - Ingresá con tu usuario y resolvé el captcha. La extensión nunca automatiza este paso.
- Al terminar, la extensión detecta la sesión y arranca la primera sincronización: el historial del año en curso, mes a mes, con barra de progreso (en el dashboard y en el popup).
La extensión mantiene viva la sesión de SYSOWEB mientras Chrome esté abierto (una lectura liviana cada 10 minutos), pero solo mientras haya actividad: pasadas 4 horas sin abrir el dashboard, sincronizar a mano ni usar SYSOWEB, el keep-alive se pausa (el popup lo indica) y la sesión vence como lo decide AVAIN; así, en un equipo compartido de consultorio la sesión no queda viva indefinidamente. Cuando AVAIN la cierra, Datos muestra «Sesión de SYSOWEB vencida» y basta con iniciar sesión de nuevo: lo pendiente continúa solo.
Cómo sincroniza
- Detención y pausa: si SYSOWEB responde 403/429 o muestra un captcha, se conserva lo pendiente y se detienen las peticiones. Revisá la causa y usá «Reanudar tras revisar la causa» en el popup; abrir el dashboard o reiniciar Chrome no levanta la detención. Si el dashboard pide una pausa de cuota, el popup indica hasta cuándo; durante ese plazo no envía ni consulta SYSOWEB.
- Cuándo: al abrir el dashboard, cada 30 minutos mientras Chrome esté abierto, y cuando apretás «Sincronizar ahora» (dashboard o popup).
- Qué: los módulos marcados en el popup (Asistencias médicas, Prácticas de enfermería, Prestaciones, Ausentismos, Accidentes de trabajo, Exámenes). Por cada módulo y por cada mes: Buscar → Exportar → ajusta las columnas de la exportación en la sesión (agrega las analíticas, quita las personales; jamás «Guardar») → descarga el CSV en memoria → lo convierte al modelo del dashboard → lo envía en lotes de 500 filas.
- Qué llega al tablero: de Asistencias médicas, las atenciones espontáneas y las atenciones por rol de llamados de emergencia (rol de llamados accidentológicos y no accidentológicos); de Prácticas de enfermería, las prácticas (incluidos el CAVAS y la vacuna antigripal registrados como práctica); de Prestaciones, los controles de alcohol en vías aéreas superiores (CAVAS), los controles toxicológicos en orina, la vacunación y los estudios; además el ausentismo laboral (solo personal de la operadora), los accidentes e incidentes con su clasificación OSHA+ y los exámenes con su aptitud.
- Rango: desde la última fecha sincronizada de cada módulo menos 7 días (así entran los registros cargados con atraso) hasta hoy. Los duplicados los descarta el servidor: volver a sincronizar un rango es seguro.
- Historial: Datos → «Cargar historial desde…» (o popup → «Cargar historial»). Va mes a mes y es reanudable: si cerrás Chrome o vence la sesión, sigue en la próxima corrida desde donde quedó.
- Varios usuarios: cada persona sincroniza con su propia sesión y su propia extensión. Dos usuarios sincronizando el mismo rango no duplican registros (el código de registro de SYSOWEB es la clave). Datos muestra, por módulo, hasta qué fecha hay datos y quién los sincronizó.
El popup de la extensión
Hacé clic en el ícono azul de la extensión (si no lo ves, fijalo desde el ícono de rompecabezas de Chrome).
- Frase de estado («Conectado · última sincronización hace 3 min», «Sesión de SYSOWEB vencida…», «Sincronizando Asistencias · sep 2026 (2/10)…»).
- Dashboard: vinculado y con qué correo. SYSOWEB: sesión activa o vencida, con botón para iniciar sesión.
- «Sincronizar ahora» (o «Reanudar (n meses pendientes)»), con barra de progreso y «Cancelar». Ante rechazo de SYSOWEB o CAPTCHA cambia a «Reanudar tras revisar la causa»; una pausa de cuota muestra el plazo y deshabilita el botón.
- Módulos: cuáles se sincronizan y, por cada uno, hasta qué fecha hay datos y cuántas filas nuevas trajo la última corrida.
- Rango: «Desde la última» (recomendado), «Mes actual» o «Fechas». Historial: mes de inicio + «Cargar historial».
- Avisos: últimos errores, con hora. Nunca muestra filas ni datos de personas.
Problemas frecuentes
- Datos dice «Instalar la extensión» aunque la instalaste
- Verificá en
chrome://extensionsque esté activada y que no haya errores. Si la cargaste descomprimida y moviste o borraste la carpeta, volvé a cargarla. Recargá el dashboard. - «Vínculo vencido» o «Vinculando…» que no termina
- Abrí (o recargá) el dashboard con tu sesión iniciada: el vínculo se renueva solo. Si sigue igual, Datos → «Reintentar el vínculo».
- «Sesión de SYSOWEB vencida»
- Iniciá sesión en SYSOWEB en la pestaña que abre el botón. La sincronización sigue sola al terminar. Si la pestaña de SYSOWEB muestra tu sesión abierta pero el estado sigue en «vencida», dejá esa pestaña abierta y apretá «Sincronizar ahora»: la extensión usa la pestaña como vía alternativa.
- Un módulo aparece «con error: no aparece en el menú Informes»
- Tu usuario de SYSOWEB no tiene ese informe habilitado («Límites de Accesos»). Desmarcalo en el popup o pedí el acceso. Los demás módulos siguen.
- «no se pudieron quitar columnas personales»
- La exportación no permitió quitar una columna con nombre o texto libre; por seguridad ese módulo no se exporta. Avisá al administrador del dashboard (puede ser un cambio en SYSOWEB).
- «Detenido» por 403/429 o captcha
- Revisá la causa con quien administra SYSOWEB. Después usá «Reanudar tras revisar la causa» en el popup; conserva la operación pendiente.
- Pausa de cuota del dashboard
- Esperá hasta el plazo indicado. La extensión conserva el pendiente. En subida manual, Importar se habilita al vencer el plazo: pulsalo de nuevo sin cambiar el archivo ni recargar.
- La sincronización tarda
- El tiempo depende del volumen y de SYSOWEB. Los lotes al dashboard se separan al menos 1,1 s, incluidos reintentos. Podés seguir usando Chrome; no cierres la sesión de SYSOWEB.
- Rechazadas > 0 en un módulo
- Filas que el modelo no pudo clasificar (por ejemplo sin fecha o sin lugar de consulta reconocido). Se ven en Datos → cobertura por módulo e importaciones. No bloquean el resto.
- «Tu cuenta no tiene el rol de sincronización»
- Un superadmin puede habilitarte en Administración → Acceso → «Pueden sincronizar». Mientras tanto ves los datos pero no podés sincronizar ni subir archivos.
- Quiero que no sincronice más en este equipo
chrome://extensions→ desactivar o quitar la extensión. Al cerrar Chrome el token de vínculo se borra solo.
Privacidad y seguridad
- Permisos:
storageyalarms; acceso únicamente apae.avainsistemas.comyatenciones-pae.web.app. Sin código remoto, sin librerías externas, sineval. - Lista blanca de acciones en SYSOWEB: Buscar, Exportar, Agregar/Quitar columnas del selector e Imprimir (exportar). Cualquier otra acción (Guardar, Modificar, Borrar, Agregar un registro) está bloqueada por código y por pruebas automáticas.
- Lo que guarda la extensión: fechas, conteos, avisos, tareas pendientes con identificador de operación y marcas de detención/pausa (en
chrome.storage.local) y el token de vínculo de una hora (en memoria de sesión, se borra al cerrar Chrome). Nunca filas, nombres, DNI ni contraseñas. - Lo que viaja al servidor del dashboard: solo campos analíticos (fecha, lugar, categoría, códigos) y, aparte, el DNI y el nombre del profesional normalizado, que el servidor convierte en huellas irreversibles (HMAC con una clave que solo tiene el servidor) y descarta: no se guardan ni vuelven al navegador.
- El robot del servidor: la contraseña de su usuario de SYSOWEB está solo en el almacén de secretos del servidor (nunca en el navegador, en la base de datos ni en los registros); sus cookies de sesión duran lo que dura cada corrida; aplica el mismo tratamiento de datos que la extensión y registra solo conteos, fechas y códigos.
Para quien administra el dashboard
- Robot del servidor: activarlo, verificarlo, apagarlo y qué hacer ante cada detención está en el runbook de despliegue (sección «Robot SYSOWEB»). «Ejecutar ahora» y «Reanudar» son de superadmin; la tarjeta la ven también las cuentas con el rol sincronizar.
- Roles (Administración → Acceso): ver para todas las cuentas permitidas; sincronizar por defecto para todas, restringible con la lista «Pueden sincronizar»; administrar para superadmins. La vista Datos solo aparece para sincronizar y superadmins.
- Empaquetar:
npm run extension(onode tools/empaquetar-extension.mjs) →extension/dist/conector-sysoweb-atenciones-vX.Y.Z.zip; con--devgenera ademásextension/dist/desarrollo/(manifest conhttp://127.0.0.1:5050/*para la pila local) y el zip-dev. - Publicar una versión nueva: subir
versionenextension/manifest.jsonyVERSION_EXTENSIONenpublic/js/vistas/datos.js(si no coinciden, el enlace de descarga da 404) →npm run extension(deja el zip enextension/dist/y lo publica enpublic/descargas/, borrando las versiones anteriores; elpredeployde Hosting lo repite) → deploy de Hosting → subir el mismo paquete a la ficha no listada de Chrome Web Store. - Pruebas:
node --test tests/extension.test.mjs(SYSOWEB y API simulados con datos sintéticos). - Protocolo con la página (
extension/contenido-dashboard.js): la página detecta<html data-conector-atenciones="x.y.z">y escuchawindow.postMessagecontipo: 'atenciones:estado' | 'atenciones:conector' | 'atenciones:pedir-vinculo'; le envíaatenciones:vincular(token y correo),atenciones:sincronizar,atenciones:historial,atenciones:pedir-estado,atenciones:cancelaryatenciones:desvincular, siempre contargetOrigin = location.origin.
Pan American Energy · Brisa Salud y Bienestar · Salud Ocupacional · Uso interno · Sin datos personales