Lorsque vous souhaitez gérer plusieurs réservations en une seule fois, vous pouvez utiliser les groupes de réservation.
Un groupe de réservation sert de conteneur pour plusieurs réservations, ce qui vous permet de créer, de mettre à jour ou de supprimer plusieurs réservations en une seule demande d'API, au lieu de traiter chaque réservation individuellement par le biais de demandes d'API distinctes.
Les groupes de réservation peuvent être utiles de multiples façons. Par exemple, supposons que vous gériez un centre sportif disposant de quatre courts de tennis et de trois entraîneurs de tennis. Lorsqu'un client souhaite réserver une heure avec un entraîneur de tennis, il faut réserver à la fois un entraîneur et un court de tennis pour cette heure. Dans ce scénario, un groupe de réservation peut être créé pour contenir ces deux réservations : une réservation pour le court et une réservation pour l'entraîneur, chacune étant une ressource distincte dans Hapio. Les informations relatives au client, telles que son nom et ses coordonnées, peuvent être stockées dans les métadonnées du groupe de réservation. Un autre exemple pourrait être celui d'un client d'un hôtel qui souhaite réserver une salle de conférence pour toute la journée et quatre tables pour le déjeuner au restaurant de l'hôtel. Dans cet exemple, la salle de conférence serait une ressource réservée par le biais d'une réservation pour toute la journée, et les tables du restaurant seraient quatre autres ressources réservées par le biais de quatre réservations pour une heure pendant le déjeuner.
Les réservations au sein d'un groupe de réservation suivent les mêmes règles que s'il s'agissait de réservations régulières créées individuellement. En fait, il s'agit de réservations normales, auxquelles s'ajoute l'appartenance à un groupe de réservation. Vous pouvez prendre n'importe quelle réservation régulière existante et l'ajouter à un groupe de réservation en définissant la propriété booking_group_id sur la réservation. De même, vous pouvez supprimer une réservation d'un groupe de réservation tout en la conservant en tant que réservation normale en attribuant la valeur null à cette propriété.