Caso de uso: Guía de Resolución: Errores de Conexión con Dispositivos Locales (CORS y Error 502)
Al intentar realizar operaciones con hardware local (cerraduras electrónicas, impresoras de tickets, escáneres) desde el entorno Cloud de Astro HMS, el navegador puede bloquear la comunicación mostrando errores de tipo CORS Policy o 502 Bad Gateway en la consola de desarrollador.
Este problema impide que el sistema SaaS envíe comandos de grabación o lectura al dispositivo físico situado en la red local del hotel.
2. Causas Principales
La interrupción de la comunicación suele deberse a tres factores fundamentales:
- Servicio Local Inactivo: El software "Driver" o "Agente" que gestiona el hardware en el PC local no está ejecutándose.
- Puerto Incorrecto o Cerrado: La petición se envía a un puerto que no es el configurado en el dispositivo, o el Firewall de Windows está bloqueando dicha entrada.
- Conflicto de Protocolos (Mixed Content): El PMS funciona bajo https:// (seguro), mientras que el dispositivo local suele responder bajo http:// (no seguro). Los navegadores modernos bloquean estas peticiones por seguridad.
3. Matriz de Errores en Consola
| Error | Significado Técnico | Causa Probable |
| CORS Policy | El navegador bloquea la respuesta por falta de permisos de origen. | El driver local no tiene configuradas las cabeceras Access-Control-Allow-Origin. |
| 502 Bad Gateway | El servidor intermedio (puerta de enlace) recibió una respuesta inválida. | El servicio local está caído o el puerto no responde correctamente. |
| ERR_CONNECTION_REFUSED | No se pudo establecer conexión con la IP de destino. | El puerto está cerrado o la IP ha cambiado (DHCP). |
4. Pasos para la Solución
Paso A: Verificación del Servicio Local
Antes de revisar el PMS, asegúrese de que el software de comunicación (ej. Driver Tesa, Agente de Impresión) esté activo:
- Vaya al PC donde está conectado físicamente el hardware.
- Verifique en la barra de tareas que el icono del software esté en color verde o estado "Running".
- Acción Recomendada: Reinicie el servicio o la aplicación de hardware local.
Paso B: Comprobación de IP y Puerto
El PMS debe conocer exactamente a dónde enviar la señal.
- Obtenga la IP local del PC (Ej: 192.168.60.6).
- Identifique el puerto de escucha (comúnmente 8069, 443 o el especificado por el fabricante).
- Prueba de Conectividad: Abra una pestaña en el navegador y escriba la dirección manual: http://[IP_LOCAL]:[PUERTO]. Si no carga una página de estado o un mensaje del fabricante, el puerto está cerrado.
Paso C: Configuración del Firewall
Si el servicio está activo pero la conexión falla desde otros PCs:
- Acceda a Panel de Control > Firewall de Windows > Configuración Avanzada.
- Cree una Regla de Entrada para permitir el tráfico en el puerto específico (TCP).
- Asegúrese de que el perfil de red esté configurado como Red Privada.
5. Solución de Problemas Avanzada
Si los errores de CORS persisten a pesar de que el puerto está abierto:
- Uso de HTTPS: Si el PMS es https, el driver local debe estar configurado con un certificado SSL o utilizar un proxy que permita la comunicación segura.
- Excepciones en el Navegador: En casos críticos de despliegue, puede ser necesario habilitar excepciones de "Contenido No Seguro" para el dominio del PMS en la configuración de privacidad de Chrome/Edge.
Nota de Soporte: Si tras seguir estos pasos el error 502 persiste, verifique que la dirección IP del terminal no haya cambiado debido a una asignación dinámica por parte del router (DHCP). Se recomienda el uso de IPs estáticas para todos los dispositivos de hardware integrados.