arrow_back_ios

¿Cómo funciona en detalle la integración con Google Calendar?

Google Calendar notifica a nuestro servicio sobre los cambios, y actualizamos el tiempo ocupado de inmediato en nuestro lado (pero no más de una vez por minuto). Además, nuestro servicio consulta el calendario periódicamente por su cuenta, en caso de que no llegue una notificación. Cuando se está completando un pedido, realizamos una sincronización preliminar para que no pueda ocurrir una sobreventa.

Envío de reservas a Google Calendar

Solo los pedidos con estados que bloquean tiempo se envían a Google Calendar. Cada vez que cambia cualquier dato del pedido o de la reserva, actualizamos inmediatamente el evento en Google Calendar, tanto su hora como su título. El título del evento siempre comienza con la palabra "Bukza", seguida del número de unidades entre corchetes (cuando se reservan tarifas compartidas). El resto del título se construye a partir de la plantilla que especifiques y puede contener cualquier dato del pedido. También marcamos los eventos que enviamos a Google Calendar con una propiedad interna especial, para poder distinguirlos de eventos de terceros.

Recepción de eventos desde Google Calendar

Importamos eventos de Google solo dentro de un período móvil: desde el inicio del mes actual hasta el final del próximo año. Los eventos importados no se convierten en reservas reales; solo bloquean el tiempo del recurso en Bukza. También se tienen en cuenta los eventos recurrentes de Google Calendar: cada ocurrencia de la serie bloquea el tiempo correspondiente en Bukza. Las ocurrencias de eventos recurrentes también están limitadas por el período de sincronización móvil.
Cuando recibimos datos de Google Calendar, omitimos los eventos de Bukza para evitar duplicarlos. Los cambios en eventos de terceros (no Bukza) realizados en Google Calendar también se reflejan en el calendario de Bukza durante la sincronización. Sin embargo, no debes modificar los eventos marcados con el texto Bukza en Google Calendar. Ese cambio no afecta la reserva original en nuestro sistema, y las ediciones se sobrescribirán la próxima vez que el pedido cambie.
Si quieres que un evento específico no ocupe tiempo, márcalo como "Disponible" (Free) en Google Calendar; omitimos esos eventos.

Cómo te protegemos de la sobreventa

El sistema no permitirá que se complete una reserva en Bukza si en ese mismo momento aparece un evento para el mismo horario en tu Google Calendar. Para esto, primero ocupamos el tiempo en Google Calendar con un evento vacío que no contiene detalles del pedido (no se aplica la plantilla de título): así reservamos el espacio. Luego, volvemos a obtener los datos de Google Calendar y comprobamos que el horario siga disponible:
  • Si está disponible, actualizamos el título del evento con los datos finales.
  • Si no está disponible (el espacio ya está ocupado), la reserva no se completa y el evento vacío se elimina de inmediato.
Esta verificación completa funciona cuando tanto el envío como la recepción están habilitados para el calendario. De lo contrario:
  • Si solo la recepción está habilitada, simplemente garantizamos que se han obtenido los datos más recientes de Google Calendar en el momento de completar la reserva.
  • Si solo el envío está habilitado, la reserva se completa sin demora: el evento se envía a Google Calendar justo después de finalizar la reserva, sin hacerte esperar ni interrumpir el proceso.
La protección contra sobreventa solo se ejecuta cuando un pedido pasa de un estado que no bloquea tiempo a uno que sí lo hace. Si un administrador cambia o agrega reservas en un pedido que ya bloquea tiempo, esa acción no se bloquea, incluso si hay un evento para el mismo horario en Google Calendar. Sin embargo, la no disponibilidad se resaltará en la interfaz.

Cantidad de unidades reservadas

En el título de tu propio evento, puedes agregar un número entre corchetes. Nuestro sistema interpretará esto como la cantidad de unidades reservadas para el recurso: el Total de unidades de la reserva.
Si no se especifica la cantidad de unidades reservadas, se considera reservado el recurso completo.