Sincronizar Booking, Airbnb y VRBO por iCal sin duplicados

Una misma noche ocupada en Booking. Otra en Airbnb. Otra directa por WhatsApp. Y el miedo constante a la doble reserva.

Ese miedo tiene una causa concreta: cada portal lleva su propio calendario y ninguno sabe lo que ha pasado en el de al lado. Trabajar más rápido no lo arregla, porque el problema no es tu velocidad tecleando, es que la disponibilidad vive en cuatro sitios a la vez. El formato estándar que la industria usa para juntarla se llama iCal.

Qué es un iCal y por qué evita la doble reserva

iCal (formato .ics, RFC 5545) es un estándar abierto para intercambiar información de calendario¹. Cada evento se describe con campos: fecha de inicio, fecha de fin, título, descripción y un identificador único.

Aplicado al hospedaje, un iCal es una URL (tipo https://ical.booking.com/v1/export?token=...) que devuelve un archivo de texto con las reservas del alojamiento. Cualquier software que la lea puede importarlas y mantenerlas al día. Por ser un estándar abierto no depende de ningún acuerdo comercial entre portales: lo entienden Google Calendar, Outlook, Apple Calendar y casi cualquier PMS, y no hace falta API ni claves, con la URL basta.

Lo que no hace es escribir. La exportación es de solo lectura: sirve para que tu software sepa lo que se ha vendido, no para bloquear fechas en el portal de origen.

Qué datos trae un iCal y cuáles no

Un iCal de portal trae poco, y casi siempre lo mismo:

• Fecha de entrada y fecha de salida (DTSTART y DTEND, los campos que define el RFC 5545).
• Identificador único de la reserva (UID).
• Estado: confirmada o cancelada.
• A veces el nombre del huésped, parcial o completo, y el código de reserva.

No trae DNI, ni pasaporte, ni fecha de nacimiento, ni dirección. Un iCal te avisa de que hay estancia; no te da el parte. Los datos personales los sigues recogiendo al huésped, y lo que cambia es que la reserva ya existe en tu sistema y solo queda mandarle el enlace de check-in.

Tampoco todo lo que trae es una reserva. El calendario que exporta Airbnb incluye además las noches bloqueadas por tus ajustes de disponibilidad, el tiempo de preparación, el preaviso y la duración mínima de estancia². Si ves huecos ocupados sin huésped detrás, ahí está el motivo.

Dónde está la URL iCal de exportación en cada portal

RegistroViajero importa de ocho: Booking.com, Airbnb, VRBO, Expedia, Tripadvisor, Google Calendar, Holidu y Rentalia. La ruta hasta la URL cambia en cada uno, y cada portal documenta la suya en su propio centro de ayuda³²⁴⁵.

Dos comprobaciones antes de copiar. La URL es por anuncio, no por alojamiento: el mismo apartamento publicado dos veces son dos URLs, y en Booking.com hay una por tipo de habitación. Y la de exportación lleva /ical/ o acaba en .ics; si no, has copiado la de importación.

VRBO ofrece además una casilla para incluir en el feed las reservas tentativas. Si la marcas, entrarán en tu panel estancias que todavía pueden caerse.

Booking.com no habilita el iCal a todos los alojamientos

Booking exige cinco condiciones para que la opción aparezca en la extranet:

• El alojamiento está abierto y reservable.
• Tu usuario tiene permisos de Tarifas y disponibilidad.
• El alojamiento tiene 20 tipos de habitación o menos.
• Cada tipo de habitación tiene una sola unidad.
• No usas un proveedor de conectividad.

La cuarta condición deja fuera a la mayoría de los hoteles pequeños: cinco habitaciones dobles idénticas son un tipo de habitación con cinco unidades, y eso ya no cumple. La quinta explica por qué un channel manager y la sincronización por iCal son alternativas y no complementos.

Cómo conectar un iCal a RegistroViajero

En RegistroViajero los calendarios se conectan alojamiento por alojamiento:

1. Entra en Alojamientos y abre el alojamiento.
2. En la tarjeta Feeds de calendario, pulsa Añadir feed.
3. Elige la plataforma, pon una etiqueta si vas a conectar varios calendarios al mismo alojamiento y pega la URL iCal.
4. Guarda. El primer sync es inmediato y a partir de ahí se sondea cada 15 minutos, con la opción de forzar uno manual.

El selector de plataforma tiene esos ocho nombres, y la URL acepta cualquier calendario que exporte .ics. Cada evento nuevo del feed se convierte en una reserva con sus fechas y con su enlace de check-in listo para enviar al huésped. Si el portal mueve la estancia a otras fechas, la reserva se actualiza en su sitio en vez de duplicarse.

Cuánto tarda una reserva de Booking o Airbnb en aparecer

Se suman dos relojes: lo que tarda el portal en publicar el cambio en su feed y lo que tarda tu software en volver a leerlo. El retardo del feed es lo que vemos en los calendarios que sincronizamos; la frecuencia de importación es la que cada portal documenta³².

Con el sondeo de 15 minutos de RegistroViajero, el caso peor de Airbnb pone la reserva en el panel algo más de cuatro horas después de hacerse. Antes de darla por perdida, fuerza un sync manual y espera una vuelta.

Qué pasa en el iCal cuando el huésped cancela

Cuando una reserva se cancela en el portal, deja de aparecer en el feed. Eso es todo lo que el iCal comunica: una ausencia, nunca un aviso de cancelación.

Por eso una ausencia no se toma al pie de la letra. RegistroViajero deja pasar dos horas desde la última vez que vio la reserva antes de actuar, porque un portal puede servir un feed incompleto en un ciclo y volver a la normalidad en el siguiente. Cumplida esa ventana:

• Si el parte todavía no se había enviado, la reserva se archiva.
• Si el parte ya está en el Ministerio, no se archiva nada: la reserva queda marcada y recibes un aviso de anulación requerida. Retirar una comunicación la firma una persona, no un sondeo.

Algunos portales tampoco retiran la entrada al instante, y otros sirven el fichero desde una caché, así que la misma URL puede devolver la versión anterior durante un rato. Si una reserva cancelada sigue en el panel, fuerza un sync manual y vuelve a mirar en media hora.

Bloquear las mismas fechas en Booking y Airbnb a la vez

Una reserva que entra por Booking no bloquea por sí sola la disponibilidad en Airbnb. El iCal que exportas a tu software va en un solo sentido, y para cerrar el círculo hay dos caminos.

iCal cruzado. Importas el calendario de Airbnb en Booking y el de Booking en Airbnb. Funciona, pero con retardo: Booking importa los calendarios conectados cada dos horas y Airbnb cada tres, así que queda una ventana de horas con las mismas fechas abiertas en los dos sitios. Booking.com tampoco admite Google Calendar como origen, de modo que los bloqueos manuales que lleves ahí no llegan a la extranet.

Channel manager. Conexión por API, casi instantánea y más caro. Tiene un efecto colateral: un alojamiento con proveedor de conectividad deja de cumplir los requisitos de la sincronización por iCal de Booking, así que no puedes tener las dos cosas.

A volúmenes bajos el iCal cruzado suele bastar, y el riesgo se concentra en esa ventana de horas. A volúmenes altos, channel manager.

Varios portales en un mismo alojamiento: qué vigilar

• Todas las URLs, al mismo alojamiento. El apartamento entero en Booking y el mismo en Airbnb son dos feeds y un solo alojamiento en tu panel.
• Un apartamento, un alojamiento. Si el anuncio se llama “Centro 1A” en un portal y “Downtown Apartment 1A” en otro, sigue siendo el mismo alojamiento. Crear dos es lo que produce reservas duplicadas.
• Revisa la URL tras cada cambio de contraseña. Los portales regeneran el enlace en los reseteos de seguridad. RegistroViajero avisa cuando un calendario no se puede sincronizar.

Si el iCal de Booking no sincroniza: qué revisar

Síntoma típico: añades el feed, pasan horas y el panel sigue vacío. Comprueba por orden:

1. Que la URL es la de exportación y no la de importación: mira si lleva /ical/ o acaba en .ics.
2. Que el alojamiento tiene reservas confirmadas dentro del rango que el portal exporta.
3. Que la URL sigue viva. Tras un cambio de contraseña hay que volver a la extranet y crear la conexión otra vez.
4. Que tu software puede salir a internet hasta ese dominio. Fuerza un sync manual y mira el log.

Si los cuatro están bien y sigue sin entrar nada, abre incidencia con tu proveedor.

Por qué la reserva aparece con una noche de más

Algunos portales dan la fecha de fin como el día siguiente al checkout (convención “hasta pero sin incluir”) y otros como el día del propio checkout. El software debe normalizarlo. Si te sale una noche de más, el sospechoso es esa convención o la zona horaria del feed.

Por qué el iCal no trae el nombre del huésped

Muchos portales omiten el nombre por privacidad, y el que traen puede venir recortado. Los datos reales del titular llegan cuando el huésped rellena el enlace de check-in, que es donde se recogen los del anexo I del RD 933/2021⁶.

Por qué el iCal trae reservas de hace meses

La mayoría de los feeds exportan una ventana amplia, con meses hacia delante y a veces alguno hacia atrás. Es normal, y no se importa a ciegas: solo las estancias futuras o en curso crean una reserva nueva.

El iCal no sustituye al parte: los dos plazos del RD 933/2021

Conectar un calendario no cumple nada por ti. La obligación de comunicar sigue siendo tuya, y el decreto no fija un plazo, fija dos:

“Esta comunicación se realizará de manera inmediata, y en todo caso en un plazo no superior a 24 horas, respectivamente, a partir de los siguientes momentos: a) Al realizar la reserva o la formalización del contrato o, en su caso, su anulación. b) Al inicio de los servicios contratados.”

Cada momento tiene su propio reloj de 24 horas y ninguno de los dos espera a que el huésped llame al timbre: uno arranca con la reserva o con su anulación, el otro al inicio de la estancia. De ahí sale el valor real del iCal, y no es ahorrarte teclear. Es que la estancia esté en tu sistema el día en que se reserva, con margen para pedir los datos, en vez de aparecer la mañana del check-in.

Con el calendario conectado, la secuencia queda así:

1. La estancia se crea con sus fechas en cuanto el portal la publica en el feed.
2. El enlace de check-in ya existe en la reserva y solo tienes que enviárselo al huésped.
3. Cuando el huésped rellena sus datos y firma, el parte se genera y se envía al Ministerio.
4. Si la reserva desaparece del feed y el parte ya estaba enviado, recibes el aviso para anularlo.

Sin iCal, el paso 1 lo haces tú a mano, reserva por reserva, antes de poder hacer cualquiera de los otros tres.

Después de sincronizar el iCal: qué configurar

• Cómo automatizar el registro de viajeros: el flujo completo, de la reserva al envío.
• Qué exige el RD 933/2021: el marco normativo.
• Cómo obtener las credenciales SES.HOSPEDAJES: sin credenciales no hay envío.
• Sanciones por incumplimiento: qué te juegas si no cumples.
• Registro de menores: reglas específicas para niños y adolescentes.

¿Quieres verlo funcionar? Mira cómo funciona RegistroViajero: conectas tus calendarios iCal y los partes salen solos.

Los portales renombran sus menús cada pocos meses. Si una etiqueta no te cuadra, busca en el anuncio la sección de sincronización de calendarios: la URL de exportación vive ahí.