
Comparatif documenté · 4 périmètres
Activités : ressources, créneaux, API opérateur et distribution
Ventrata, bookingkit, TourCMS et Civitatis montrent pourquoi capacité, horaires et distribution doivent être évalués séparément. Une activité visible chez un distributeur ne décrit pas toutes les ressources nécessaires à son exécution.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
Capacité des activités et ressources | La disponibilité combine capacité, groupes de ressources, horaires et réservations. Une même ressource peut servir plusieurs produits ; lorsqu’une limite de poids et une capacité sont configurées, la première limite atteinte contraint la disponibilité. Ventrata : disponibilité et ressources partagées ↗Consulté le | Gestion des ressources décrite ; ni quota revendeur ni activation d’une connexion OCTO ne sont démontrés par cette page. | Comment deux produits concurrents consomment-ils la même ressource sur un intervalle commun ? |
API opérateur et marketplace | L’opération Show Supplier de TourCMS est réservée aux comptes opérateurs ; les partenaires marketplace sont orientés vers Show Channel. TourCMS : API opérateur et marketplace ↗Consulté le | Des objets proches par leur nom ne sont pas accessibles avec le même rôle ni le même espace d’identifiants. | Quel type de compte utilisons-nous et quel objet représente l’opérateur connecté ? |
Calendrier des expériences | bookingkit distingue les rendez-vous ponctuels et récurrents et documente leurs dates et heures dans la définition d’une expérience. bookingkit : Calendrier des expériences ↗Consulté le | Une récurrence ne garantit pas qu’une exception, fermeture ou contrainte de ressource a été prise en compte. | Comment une occurrence particulière est-elle fermée sans supprimer le calendrier entier ? |
Distribution d’activités pour professionnels | Civitatis Pro présente plusieurs modèles de collaboration pour agences, affiliés, hébergements, OTA et plateformes. Civitatis : Distribution d’activités pour professionnels ↗Consulté le | Le profil commercial choisi détermine le parcours ; le catalogue seul ne fixe pas les responsabilités de vente. | Quel modèle gère la réservation, l’encaissement, l’annulation et l’aide le jour de l’activité ? |
Calculer la capacité au niveau de la ressource
La documentation Ventrata relie la disponibilité aux ressources, horaires et réservations. Une activité peut dépendre d’un guide, d’un véhicule ou d’un équipement partagé avec une autre activité. Compter uniquement les billets du produit masque alors le vrai goulot d’étranglement.
Décrivez les ressources consommées par départ et la façon dont les catégories de participants réduisent la capacité. Testez deux produits qui sollicitent le même guide au même moment. La dernière place doit être cohérente dans les différents canaux.
Définir les créneaux avant de les publier
bookingkit documente des rendez-vous ponctuels et récurrents. Une récurrence définit des dates possibles ; elle ne prouve pas que tous les jours sont ouverts sans exception ni que toutes les ressources sont disponibles.
Relisez fuseau, jours exclus, fermeture saisonnière et délai de réservation. Faites modifier une seule occurrence sans déplacer toute la série. Une confirmation déjà émise doit garder un horaire compréhensible pour le participant.
Vérifier le rôle API et le modèle partenaire
TourCMS distingue l’opération Show Supplier accessible à l’opérateur de l’opération Show Channel destinée au contexte marketplace. Civitatis présente plusieurs parcours professionnels, dont agences, affiliation et hébergements. Le nom de la plateforme ne suffit donc pas à définir vos droits.
Avant de promettre émission ou annulation, testez le rôle attribué au compte et le canal proposé. Un distributeur peut exposer une activité sans donner au partenaire le contrôle des capacités ni des ressources de l’opérateur. Nommez le contact qui traite un départ supprimé.
Retrouver la capacité tenue après un changement de canal
Scénario de préparation : un canal est remplacé alors que guides, véhicules et salles sont partagés entre activités. Rapprochez chaque réservation de la ressource et du créneau qui la consomment. Un stock remis à zéro peut créer une survente involontaire.
Préparez le solde de capacité, les options et les réservations confirmées avant bascule. La preuve de sortie montre que les anciens engagements restent pris en compte dans les disponibilités publiées et que les annulations libèrent la bonne ressource.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le système doit représenter la contrainte qui limite réellement la prestation. Pour une visite, elle peut venir des guides ; pour une location, du matériel ; pour une attraction, d’un créneau. Un nombre de places commun ne suffit pas à décrire toutes ces situations.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Visites avec guides partagés
Cas fictif : une visite se termine à 11 h et une autre débute à 11 h 15. Elles utilisent le même guide, et le trajet entre rendez-vous est donné à 25 minutes.
Avant de retenir ce périmètre : Le cas laisse un déficit de dix minutes avant même toute autre marge. Comparer l’affectation et les alternatives de planning ; des capacités de participants disponibles ne résolvent pas ce conflit de ressource.
Entrées sur créneaux
Cas fictif : un billet prévoit un accès à 10 h pour deux personnes. L’accueil doit distinguer une première entrée admise d’une nouvelle lecture du même titre.
Avant de retenir ce périmètre : Retrouver créneau, participants, droit d’accès et événements de contrôle. Le compteur de scans ne doit pas devenir un compteur de visiteurs uniques sans définition et rapprochement adaptés.
Développement des revendeurs
Cas fictif : l’opérateur ouvre un nouveau canal pour un produit déjà vendu en direct. Le stock et les rendez-vous doivent rester cohérents avant d’étendre la connexion à toute la gamme.
Avant de retenir ce périmètre : Faire circuler création, modification et annulation sur ce produit avec sa source de capacité. Définir la portée du pilote ; une connexion réussie ne démontre pas la couverture des ressources et options exclues.
Arbitrer les contraintes et le coût de fonctionnement
Ajouter un canal de vente sans fiabiliser les ressources peut augmenter les conflits. À l’inverse, un planning solide mais difficile à publier freine la commercialisation. Le choix peut être progressif : d’abord l’objet de capacité, puis les documents et les canaux nécessaires, avec une recette à chaque étape. Dans un planning fictif, deux départs de huit personnes commencent à 10 h, mais un seul guide peut accompagner un groupe à cet horaire. Les seize places affichées ne constituent donc pas une capacité exploitable dans ce scénario. Comparez la réservation de la ressource, sa durée d’indisponibilité et les conséquences d’un changement d’heure. Une seconde vente ne peut être retenue que si une ressource supplémentaire est effectivement affectée selon les règles de l’opérateur.
Points à clarifier avant la décision
- Le planning accepte deux affectations incompatibles avec le trajet ou la disponibilité donnée pour la ressource.
- L’ajout d’un canal ne conserve pas la référence de capacité et les consignes nécessaires à l’exploitation.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Le même guide sur deux départs | Cas fictif : 2 départs de 8 places à 10 h, un seul guide disponible. Chercher les deux via deux canaux. | Le test contrôle la ressource partagée, au-delà des 16 places théoriques ; règle de conflit démontrée. |
| Exception dans une série récurrente | Modifier seulement la date concernée. | Récurrence, exception et confirmations existantes. |
| Véhicule immobilisé | Retirer en test un véhicule de 8 places après 5 ventes et demander le traitement du départ. | Capacité recalculée, clients concernés identifiés et responsabilité de remplacement ou remboursement attribuée. |
| Départ supprimé après vente | Informer les participants et traiter le dossier. | Références vendues, notification et responsable de reprise. |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
La capacité d’un produit est-elle toujours son nombre de billets ?
Elle peut dépendre de ressources partagées. Modélisez guide, véhicule, salle ou matériel avant de diffuser le stock.
Un créneau récurrent reste-t-il ouvert pendant une fermeture ?
La récurrence et ses exceptions doivent être configurées et testées. Vérifiez les jours exclus et l’effet sur les réservations déjà confirmées.
Une API opérateur est-elle accessible à tous les distributeurs ?
Les opérations dépendent du rôle et des droits du compte. TourCMS documente notamment une distinction entre accès opérateur et contexte marketplace.
Quel scénario choisir pour départager deux solutions ?
Choisissez une situation qui sollicite la ressource limitante et les relais réels. Un guide disponible trop tard ou un véhicule partagé révèle un problème qu’un simple total de places masque. Faites suivre le changement jusqu’au planning, aux documents et à l’accueil ; ajoutez les canaux seulement dans le périmètre effectivement contrôlé.
Documentation et application
Les précisions utiles des sources
OCTO : disponibilité retenue, expiration et confirmation
La retenue temporaire de capacité et la confirmation de réservation sont des étapes différentes du parcours OCTO.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| availabilityId | Un contrôle de disponibilité fournit la référence nécessaire à la création de la réservation. | Conserver produit, option et disponibilité sélectionnés dans le même contexte. |
| ON_HOLD | La création retient la capacité jusqu’à confirmation ou expiration ; la durée demandée est bornée par le fournisseur ou son prestataire OCTO. | Lire l’échéance retournée au lieu de supposer une durée universelle de retenue. |
| Confirmation | Une réservation retenue peut être confirmée tant qu’elle n’a pas expiré. | Vérifier le statut retourné avant de présenter la prestation comme confirmée. |
| Annulation | Le parcours documente POST /bookings/{uuid}/cancel, distinct d’une suppression HTTP DELETE. | Suivre le contrat de l’opération et ses conditions d’annulation. |
Le standard ne constitue pas un catalogue vendable et ne prouve pas l’activation de toutes les fonctions pour un revendeur.
OCTO — Core Bookings · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
Viator Supplier API : séparer places restantes et heure limite
Le système de réservation transmet plusieurs informations complémentaires pour décider si une option peut encore être vendue.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Date limite | BookingCutoff contient exactement un choix : DateTime avec fuseau, ProductDateTime en heure locale du produit ou NotApplicable=true. | Conserver la convention horaire avant toute comparaison. |
| Places | Capacity.Simple.Remaining décrit les places encore disponibles pour Viator. | Ne pas l’assimiler à la capacité totale du site ou de l’opérateur. |
| Participants décomptés | ConsumedBy précise les catégories d’âge qui consomment cette capacité. | Ne pas déduire automatiquement une place pour chaque bébé ; lire les catégories transmises. |
Modèle Supplier API, distinct du contrat Partner API. Une place restante ne supprime pas une heure limite de réservation.
Viator Reservation System API — BookingCutoff and Capacity · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
OCTO Pricing : distinguer prix par unité et prix par réservation
Le nombre de participants ne suffit pas à calculer le prix d’une activité privée. Le mode de tarification se lit avant la multiplication.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Unité ou réservation | pricingPer vaut UNIT ou BOOKING. En mode BOOKING, le prix s’applique une fois à la réservation plutôt qu’à chaque unité achetée. | Ne pas multiplier un prix de privatisation par le nombre de participants. |
| Prix indicatif | Le suffixe From, comme pricingFrom, indique un prix indicatif et non final. | Conserver cette nuance dans le calendrier et vérifier le prix de la sélection. |
| Vente et achat | retail est le prix de vente au client ; net est le montant de gros facturé par le fournisseur. | Distinguer prix public, coût fournisseur et marge après les autres charges. |
| Précision | Le montant entier se divise par 10 à la puissance currencyPrecision pour obtenir le montant décimal. | Exemple de lecture : 12500 avec une précision de 2 donne 125,00 dans la devise indiquée. |
Capacité optionnelle pricing, à demander dans Octo-Capabilities. Le standard ne prouve pas son activation chez chaque fournisseur.
OCTO — Pricing capability · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
FareHarbor : distinguer inscription, alerte et réservation
La liste d’attente peut envoyer plusieurs types de messages. Aucun ne doit être confondu avec une place confirmée.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Confirmation d’inscription | L’inscription en ligne déclenche toujours un courriel ; l’envoi après ajout manuel est configurable et désactivé par défaut. | Distinguez ce message de l’alerte annonçant une place disponible. |
| Alerte automatique | Une annulation ou un changement peut déclencher l’alerte après un délai configuré, si la place correspond au type de client. | Conservez le type demandé et testez le déclencheur ; l’alerte ne bloque pas la place. |
| Après l’alerte | Un client déjà averti automatiquement ne reçoit plus d’autre alerte automatique pour ce créneau. Book now peut ensuite conduire à un créneau redevenu complet. | Vérifiez la réservation obtenue avant de clore la demande. |
| Affichage de la liste | Un cutoff ou le paramètre bookable-only=yes du lien d’intégration peut masquer l’option. | Testez le lien publié sur le site, avec un créneau complet. |
Aide FareHarbor mise à jour le 29 septembre 2026. Les types conditionnels, dont enfant exigeant un adulte, ne fonctionnent pas dans Waitlist.
FareHarbor — fonctionnement de Waitlist · mise à jour par la source le 29/09/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
bookingkit : les ressources ont des limites de compte et de paramétrage
Le stock physique partagé doit être rapproché des expériences, des comptes et des règles qui le consomment réellement.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Deux comptes | L’aide indique qu’une ressource ne peut pas être reliée entre deux comptes bookingkit ; elle décrit un ajustement manuel comme solution de contournement. | Deux calendriers visibles ne prouvent donc pas une disponibilité partagée. |
| Règles temporelles | Les règles de ressources sont affectées au moment de la commande ; l’aide ne permet pas d’en réserver la configuration à une seule période de prestation. | Faites confirmer le traitement d’une capacité réduite uniquement pendant certaines vacances. |
| Données du participant | Des informations comme la taille ou le poids peuvent être recueillies en commentaire, sans être reliées aux ressources par ce module. | Ne promettez pas une allocation automatique d’équipement depuis un commentaire. |
| Durées de location | L’aide Resources indique qu’une durée portée seulement par les catégories de prix ne convient pas à ce module ; elle recommande des expériences correspondant aux durées, reliées par les ressources. | Distinguez ce cas du module de durées multiples, puis vérifiez les chevauchements sur le même matériel. |
| Durée de blocage | La durée configurée détermine le blocage de la ressource. L’aide donne 90 minutes pour une activité de 60 minutes suivie de 30 minutes de pause à inclure dans ce blocage. | Distinguer durée de l’activité présentée au client et occupation réelle de la ressource, avec la préparation ou la remise en état prévue. |
| Commande manuelle | L’aide précise qu’une commande manuelle peut dépasser la capacité de ressource ; un avertissement est affiché. | Ne pas considérer le module comme une garantie absolue contre la survente ; contrôler les exceptions manuelles et les ressources résultantes. |
60 minutes d’activité peuvent occuper la ressource pendant 90 minutes
Exemple fictif de durée, inspiré du principe décrit par bookingkit. La pause de remise en état est supposée nécessaire et occupe la même ressource.
- Activité : 10 h–11 h
Le participant effectue une activité de 60 minutes. Cette durée décrit la prestation.
- Remise en état : 11 h–11 h 30
La même ressource reste occupée pendant 30 minutes supplémentaires, sans nouvelle activité client.
- Blocage : 10 h–11 h 30
60 + 30 = 90 minutes à prendre en compte pour ce besoin. La présentation client et le réglage de disponibilité doivent rester cohérents.
Aide bookingkit mise à jour le 15 septembre 2026. Le module et l’offre souscrite doivent être confirmés dans le compte ; ces fonctions d’exploitation ne démontrent pas un droit API supplémentaire.
bookingkit — fonctionnement de la gestion des ressources · mise à jour par la source le 15/09/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
bookingkit : une durée supplémentaire demande aussi son créneau réservable
Le module de durées multiples permet de proposer plusieurs durées dans une même expérience. Décrire deux durées dans un prix ne suffit pas à créer les disponibilités correspondantes.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Module de durées multiples | L’aide demande d’activer More than one experience duration avant d’ajouter les durées dans Duration of event. | Vérifiez le module réellement actif et la durée enregistrée dans l’expérience. |
| Créneaux par durée | Chaque durée ajoutée demande un nouveau rendez-vous afin d’être réservable en ligne. | Rejouez le choix de chaque durée à la date voulue. |
| Stock limité | Lorsque les durées utilisent un quota, l’aide demande de relier l’expérience à Resource Management en conservant ses différentes durées dans une même expérience. | Vérifiez les chevauchements sur le matériel ou l’espace réellement partagé. |
| Sans quota | Si l’expérience peut vendre un nombre illimité de billets, le recours à Resource Management n’est pas nécessaire dans ce cas décrit. | Ne supprimez pas le contrôle du stock d’une activité limitée en reprenant cette exception. |
Vérifier chaque durée dans le parcours client
Quatre étapes de recette proposées pour une expérience à plusieurs durées.
- Définir les durées
Retrouver les durées dans le module adapté.
- Créer les rendez-vous
Associer des disponibilités à chacune des durées.
- Contrôler la ressource
Vérifier les chevauchements lorsque le stock est limité.
- Rejouer le choix
Choisir date, durée et heure puis relire le récapitulatif.
Deux variantes à vérifier avant la mise en vente
Durées et configurations fictives.
La durée de deux heures est décrite mais n’a pas de rendez-vous
Une expérience fictive annonce une heure et deux heures. Seule la durée d’une heure dispose d’un rendez-vous.
Durées annoncées : 1 h et 2 h
Rendez-vous 1 h : créé
Rendez-vous 2 h : absentLecture du cas. Créez et vérifiez le rendez-vous de deux heures avant d’annoncer cette variante comme réservable. Le texte de présentation ne crée pas une disponibilité.
L’exception sans quota est appliquée à un matériel limité
Une location fictive utilise dix équipements partagés entre deux durées. La gestion des ressources est écartée au motif que certaines expériences n’en ont pas besoin.
Équipements disponibles : 10
Durées proposées : 2
Quota réel : limitéLecture du cas. L’exception sans quota ne décrit pas ce matériel limité. Faites valider le lien de ressource et les chevauchements pour les deux durées.
Aide bookingkit mise à jour le 29 décembre 2023, consultée le 23 octobre 2026. Ce module est distinct d’une durée indiquée uniquement dans une catégorie de prix. Faites confirmer son fonctionnement dans l’offre et l’interface du compte utilisé.
bookingkit — Flexible duration of experience · mise à jour par la source le 29/12/2023 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
Checkfront Classic Items : relier les quantités choisies au stock réellement consommé
Pour préparer les quantités d’une activité ou d’un équipement, identifiez ce que chaque paramètre compte. Vérifiez ensuite son effet sur le stock et sa visibilité dans le parcours de réservation.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Consommation du stock | Les paramètres ayant Controls Inventory consomment la même base d’inventaire de l’article. | Séparez le décompte des personnes et celui des équipements lorsque le montage demande des ressources différentes. |
| Valeur masquée | Avec Hidden to All, le paramètre n’apparaît ni au client ni à l’équipe pendant la réservation, mais sa valeur par défaut reste appliquée. | Relisez les valeurs configurées en plus des champs visibles. |
| Bornes par réservation | Min per Booking et Max per Booking se règlent par article, sans être des paramètres globaux. | Vérifiez les bornes de chaque article qui utilise le paramètre. |
| Visibilité partagée | La visibilité est un réglage global qui affecte les articles partageant le paramètre. | Recensez les articles concernés avant de modifier cet affichage. |
Vérifier une quantité avant de mettre l’offre en vente
Quatre étapes proposées sur un article fictif.
- Nommer l’unité
Décrire ce que compte la valeur : personne, équipement ou autre unité.
- Lire le paramètre
Retrouver valeur par défaut, visibilité et limites de quantité.
- Observer le stock
Comparer le stock avant et après la réservation de test.
- Relire les articles liés
Vérifier les autres offres utilisant le même paramètre partagé.
Deux quantités à contrôler derrière l’affichage
Stocks et paramètres fictifs ; aucune réservation réelle n’est effectuée.
Deux adultes et un enfant doivent consommer la même base de six places
Un article fictif dispose de six places. Les paramètres Adult et Child utilisent tous deux Controls Inventory ; la demande comporte deux adultes et un enfant.
Base disponible : 6 places
Adult : 2
Child : 1
Consommation attendue dans ce cas : 3 places
Reste attendu : 3 placesLecture du cas. Comparez ce reste au résultat de la réservation de test. Si le décompte diffère, faites relire les paramètres et la base utilisée avant de publier l’offre.
Un paramètre masqué est supposé sans effet
Une recette fictive ne vérifie que les champs visibles. Un paramètre Hidden to All conserve pourtant une valeur par défaut de un.
Visibilité : Hidden to All
Valeur par défaut : 1
Vérification effectuée : champs visibles seulementLecture du cas. Complétez la lecture avec le paramètre masqué et son rôle dans la configuration. Retrouvez son effet sur le décompte prévu et sur les autres articles concernés.
Aide Checkfront consultée le 23 octobre 2026. Ces repères concernent Classic Items ; vérifiez la version et les dépendances réellement configurées dans le compte utilisé.
Checkfront — Configuring inventory and parameters for items using the Item Builder · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.