Integración domótica Holiday rental (iCal), gratuita y de código abierto
Llegadas y salidas de huéspedes desde los iCal de Airbnb, Booking.com o Vrbo: precalentar, limpieza.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Las llegadas y salidas de los huéspedes de un alojamiento turístico, leídas en los calendarios de exportación iCal que cada plataforma ofrece para cada anuncio (Airbnb, Booking.com, Vrbo, Abritel, Gîtes de France, Smoobu y otros gestores de canales): sin cuenta ni API de socio. Precalentar antes de la llegada, apagar la calefacción a la salida, avisar a la limpieza un día de cambio de huéspedes.
Desarrollada sin una cuenta de anfitrión real: sus comentarios son bienvenidos. Los formatos se han comprobado en exportaciones reales publicadas.
Lo que obtiene
- Un dispositivo por alojamiento (tres como máximo), con:
- Ocupado (sí / no): una estancia está en curso, desde su hora de llegada hasta su hora de salida;
- Llegada próxima (sí / no): la próxima llegada está dentro de la antelación de las opciones (3 horas por defecto);
- Cambio de huéspedes hoy (sí / no): unos huéspedes se van y otros llegan el mismo día;
- Próxima llegada y Próxima salida: día, hora y plataforma, p. ej. «vie, 13 nov, 16:00 · Booking.com»;
- Horas antes de la llegada (redondeadas hacia arriba) y Días antes de la llegada;
- Noches restantes de la estancia en curso.
- Tres disparadores de escena: llegada de los huéspedes, salida de los huéspedes, llegada próxima.
- Una acción de escena que lee la estancia en curso o la próxima, para un mensaje.
- Un widget del panel: ocupado o libre ahora, y luego las próximas estancias.
Configuración
Para cada alojamiento, en Integraciones → Holiday rental (iCal) → Configuración:
- Nombre: el nombre del dispositivo en Gladys (puede cambiarlo después).
- Dirección iCal: la dirección de exportación (.ics) del calendario del alojamiento en una plataforma. Otra dirección iCal: el mismo alojamiento en una segunda plataforma. También puede pegar varias direcciones en un mismo campo, separadas por un espacio. Las estancias de todas las direcciones se fusionan y se eliminan los duplicados.
- Hora de llegada y Hora de salida (16:00 y 11:00 por defecto): las plataformas exportan días, no horas. Cuando un calendario indica una hora (algunos gestores de canales), se usa esa hora.
Dónde encontrar la dirección:
- Airbnb: Calendario → el anuncio → Disponibilidad → Conectar calendarios → Exportar calendario.
- Booking.com (extranet): Tarifas y disponibilidad → Sincronizar calendarios → Exportar. Booking.com escribe cada fecha reservada o cerrada como «CLOSED - Not available»: elija exportar solo las fechas reservadas cuando la extranet lo ofrezca.
- Vrbo / Abritel: Calendario → Importar y exportar → Exportar calendario.
- Gîtes de France, Clévacances, Smoobu, Lodgify, Beds24…: la página «exportación iCal» o «sincronización de calendario» del anuncio.
Opciones:
- Antelación antes de la llegada (horas, de 0 a 72): cuándo se activa «Llegada próxima» y se lanza su disparador. 0 lo desactiva.
- Fechas «Not available»: Booking.com y Smoobu exportan cada reserva como «Not available», exactamente como una fecha que usted cerró. Por defecto cuentan como estancias (si no, un anfitrión de Booking.com no vería ninguna reserva); elija «Ignorarlas» si todas sus reservas vienen de calendarios que las nombran (Airbnb «Reserved», Vrbo «Reserved - …»). Los bloqueos de Airbnb («Airbnb (Not available)») y de Vrbo («Blocked») siempre se ignoran: en Airbnb también contienen las reservas importadas de las demás plataformas, que trae su propio calendario.
- Mostrar nombres y códigos: desactivado por defecto. Activado, el nombre (Vrbo) y el código de reserva (Airbnb)
que llevan algunos calendarios aparecen en el widget y en la variable
guestde las escenas. - Actualización de los calendarios: cada 15, 30 (por defecto) o 60 minutos, o cada 3 horas. Las plataformas actualizan sus exportaciones como mucho cada pocas horas: un ritmo más rápido no ve antes una reserva por su parte.
- Idioma de los nombres: nombres de las funciones y textos de los estados, fijados al crear el dispositivo.
Abra después la pestaña Descubrimiento y añada cada alojamiento a Gladys.
Acciones
Comprobar los calendarios descarga de nuevo cada calendario y resume, por alojamiento, el número de próximas estancias y la próxima llegada, o los calendarios que no se pudieron leer.
Escenas
Disparadores (categoría «Holiday rental (iCal)» del editor de escenas), cada uno filtrable por alojamiento:
- Llegada de los huéspedes: ha llegado la hora de llegada de una estancia.
- Salida de los huéspedes: ha llegado la hora de salida: calefacción apagada, limpieza. Use una acción «Esperar» de la escena para la limpieza unas horas más tarde.
- Llegada próxima: se ha alcanzado la antelación antes de una llegada: precalentar.
Variables de los tres: alojamiento, plataforma, noches, llegada, salida, cambio el mismo día (sí / no) y huésped (vacío salvo si la opción está activada).
Los estados del dispositivo también sirven de condiciones: «Horas antes de la llegada» en 24 o menos para programar el código de una cerradura conectada la víspera, «Ocupado» en no para mantener la calefacción en antihielo, «Cambio de huéspedes hoy» en sí para avisar al equipo de limpieza por la mañana. Sin estancia conocida, «Horas antes de la llegada» vale 9999 y «Días antes de la llegada» 999, para que un umbral nunca se dispare con ellos.
Acción: Leer la próxima estancia devuelve, para un alojamiento, la estancia en curso o si no la próxima: encontrada (sí / no), alojamiento, ocupado ahora, llegada, salida, noches, días antes de la llegada, plataforma.
Panel
Añada el widget Estancias del alquiler: una línea de estado por alojamiento (ocupado hasta…, o libre y la próxima llegada), luego hasta ocho próximas estancias con sus fechas, número de noches y plataforma; la estancia en curso y las llegadas del día están señaladas. Ajustes: un alojamiento (todos si está vacío), y si se muestran las líneas ocupado / libre.
Solución de problemas
- La pantalla de configuración indica «Calendario inaccesible»: la dirección está mal copiada, o la plataforma la ha renovado. Cópiela de nuevo desde la plataforma. «Comprobar los calendarios» indica qué alojamiento falla. Las estancias ya leídas se conservan mientras tanto.
- Falta una estancia: ¿está en la exportación de la plataforma? Algunas solo exportan los próximos 12 meses, y una reserva de Booking.com necesita que las fechas «Not available» cuenten como estancias.
- Una fecha que usted bloqueó aparece como estancia: llegó a un calendario «Not available» (Booking.com importa los bloqueos de Airbnb). Exporte solo las fechas reservadas en Booking.com, o elija «Ignorarlas».
- Las horas están desfasadas una hora o más: se leen en la zona horaria de Gladys (Ajustes → Sistema). El alojamiento y Gladys deben estar en la misma zona horaria.
Límites
- Tres alojamientos como máximo, dos campos de dirección cada uno (varias direcciones pueden compartir un campo).
- Las plataformas actualizan sus exportaciones a su ritmo, a menudo cada pocas horas: una reserva hecha hace un minuto puede aparecer más tarde.
- Las llegadas anticipadas y salidas tardías acordadas con los huéspedes no están en las exportaciones: se aplican las horas configuradas.
- No se añade ninguna estancia al calendario de Gladys: la integración de calendarios ICS puede mostrar allí los mismos calendarios.
Privacidad y seguridad
Las direcciones iCal son secretas (quien las tiene lee su calendario): Gladys las guarda, solo sirven para descargar los calendarios y nunca aparecen en los registros (solo el nombre del servidor). No se escribe nada en el disco. Los nombres de los huéspedes y los códigos de reserva quedan ocultos salvo si activa la opción. Sin relación con Airbnb, Booking.com, Vrbo, Abritel ni ninguna plataforma citada aquí.
Parámetros de configuración
Estos son los parámetros que Holiday rental (iCal) te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus alojamientos | section | No | Hasta tres alojamientos, cada uno un dispositivo. Pegue la dirección de exportación iCal de su calendario en cada plataforma (Airbnb: Calendario → Disponibilidad → Conectar calendarios; Booking.com: Tarifas y disponibilidad → Sincronizar). Direcciones privadas: se quedan en Gladys. |
| Alojamiento 1 | section | No | |
| Alojamiento 1: nombre | string | No | Nombre del dispositivo en Gladys. |
| Alojamiento 1: dirección iCal | secret | No | Dirección de exportación (.ics) del calendario del alojamiento en una plataforma. Puede separar varias direcciones con un espacio. |
| Alojamiento 1: otra dirección iCal | secret | No | El mismo alojamiento en otra plataforma: las estancias se fusionan y se eliminan los duplicados. |
| Alojamiento 1: hora de llegada | select | No | |
| Alojamiento 1: hora de salida | select | No | |
| Alojamiento 2 | section | No | |
| Alojamiento 2: nombre | string | No | Nombre del dispositivo en Gladys. |
| Alojamiento 2: dirección iCal | secret | No | Dirección de exportación (.ics) del calendario del alojamiento en una plataforma. Puede separar varias direcciones con un espacio. |
| Alojamiento 2: otra dirección iCal | secret | No | El mismo alojamiento en otra plataforma: las estancias se fusionan y se eliminan los duplicados. |
| Alojamiento 2: hora de llegada | select | No | |
| Alojamiento 2: hora de salida | select | No | |
| Alojamiento 3 | section | No | |
| Alojamiento 3: nombre | string | No | Nombre del dispositivo en Gladys. |
| Alojamiento 3: dirección iCal | secret | No | Dirección de exportación (.ics) del calendario del alojamiento en una plataforma. Puede separar varias direcciones con un espacio. |
| Alojamiento 3: otra dirección iCal | secret | No | El mismo alojamiento en otra plataforma: las estancias se fusionan y se eliminan los duplicados. |
| Alojamiento 3: hora de llegada | select | No | |
| Alojamiento 3: hora de salida | select | No | |
| Opciones | section | No | |
| Antelación antes de la llegada (horas) | number | No | «Llegada próxima» se activa, y su disparador de escena se lanza, este número de horas antes de la llegada: tiempo para precalentar. 0 lo desactiva. |
| Fechas «Not available» | select | No | Booking.com y Smoobu exportan cada reserva como «Not available», igual que una fecha cerrada. Los bloqueos de Airbnb y Vrbo siempre se ignoran. |
| Mostrar nombres y códigos | boolean | No | Desactivado: los nombres y códigos de reserva de algunos calendarios quedan ocultos en el widget y las escenas (datos personales). |
| Actualización de los calendarios | select | No | |
| Idioma de los nombres | select | No | Nombres de las funciones y textos de los estados, fijados al crear el dispositivo. |
Cómo instalar Holiday rental (iCal) en Gladys
- En Gladys, abre Integraciones: Holiday rental (iCal) aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-location-saisonniere:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-location-saisonniere.
Holiday rental (iCal) requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Holiday rental (iCal) es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación