Accueil de participants à une activité fictive

Activités et billetterie

Participants : vérifier les âges et les unités vendues

Une réservation de visite associe des personnes, des catégories de vente et des places. Ces trois objets ne sont pas toujours équivalents. Les tranches d’âge, règles d’accompagnement et unités vendues appartiennent au produit et à l’option sélectionnés ; une interface ne doit pas leur substituer ses propres définitions d’adulte ou d’enfant.

Retrouver les catégories du produit sélectionné

La référence technique Viator précise que les limites d’âge sont définies par produit, sans tranches par défaut à utiliser universellement. Elle décrit notamment ageBand, startAge et endAge. Gardez ces valeurs avec l’option et la date de consultation au lieu de reprendre les âges d’un exemple de documentation ou d’une autre activité.

Le vocabulaire public doit aider le voyageur à choisir. Affichez la tranche effectivement proposée à côté du libellé adulte, enfant ou jeune. Si une borne ou sa convention reste ambiguë, obtenez une précision avant d’accepter la réservation. Le seul âge minimum d’admission ne permet pas de déterminer toutes les catégories tarifaires.

Séparer participant, billet et unité de prix

Une offre peut être vendue par personne, par groupe ou selon une unité décrite par le fournisseur. OCTO organise le produit autour d’options et d’unités. Vérifiez ce que représente une unité dans l’offre concrète avant de multiplier un tarif par le nombre de voyageurs : une quantité commerciale ne donne pas toujours le nombre de places occupées.

Exemple pédagogique : quatre personnes réservent une visite privée vendue comme un groupe. Le dossier doit conserver quatre participants et une unité commerciale, si cette règle est celle du produit. Cet exemple n’est pas un tarif de fournisseur. Il sert à tester que panier, confirmation et liste opérationnelle décrivent chacun le bon objet.

Tester accompagnement et taille du groupe

Viator décrit des exigences de réservation telles que des minima ou maxima de voyageurs et, selon le produit, la présence requise d’un adulte. L’interface doit reprendre les exigences retournées et signaler les incompatibilités. Ne transformez pas une règle documentée pour une activité en règle de tout le catalogue.

Préparez des tests aux bornes et avec les combinaisons concernées : uniquement des enfants, nombre inférieur au minimum, catégorie non disponible ou groupe au-delà du maximum. Une gratuité n’établit pas à elle seule qu’une personne ne consomme aucune place ; vérifiez le comportement de capacité propre au service.

Conserver les catégories de la recherche à la confirmation

La composition retenue doit suivre recherche, vérification du prix, panier et confirmation. Retrouvez produit, option, départ et quantités par catégorie dans les références autorisées. Si le client modifie un âge ou une quantité, demandez une nouvelle vérification lorsque cela change prix, admissibilité ou places disponibles.

Le contrôle relit aussi la preuve reçue par le voyageur. Un total cohérent peut masquer une mauvaise catégorie ou une option différente. Comparez la confirmation avec la composition réellement demandée et la prestation choisie. Pour le suivi, gardez le résultat du contrôle et une référence de dossier plutôt qu’un ensemble de données personnelles inutiles.

Préparer les changements sans reclasser silencieusement

Un changement de participants peut demander annulation, remplacement ou nouvelle réservation selon les opérations disponibles. Vérifiez qui valide le changement et à quel moment l’ancienne capacité est libérée. N’envoyez pas simplement une nouvelle liste à l’opérateur en supposant qu’elle modifie aussi le dossier commercial.

Utilisez la fiche de contrôle des catégories et le registre des unités et participants. Le dossier transmis associe règles constatées, option, composition finale et point encore à confirmer. La liste opérationnelle et le montant facturé restent rapprochables.

Approfondir le parcours : Activités privées : unité tarifaire, participants et exclusivité confirmée

Les catégories de participants complètent le contrôle de l’unité tarifaire. Un nombre de personnes et un nombre de groupes n’ont pas le même sens. Rapprochez les bornes applicables et la composition fictive avant de conclure à la capacité ou à l’exclusivité du produit.

Activités privées : unité tarifaire, participants et exclusivité confirmée · Rapprocher les preuves du parcours

Approfondir le parcours : Entrée partielle d’un groupe : unités utilisées et personnes restantes

Le nombre de personnes doit être rapproché des unités et documents remis. Une unité familiale ou de groupe n’est pas nécessairement un billet par personne. Cette distinction devient décisive quand les participants arrivent en plusieurs fois.

Entrée partielle d’un groupe : unités utilisées et personnes restantes · Rapprocher les preuves du parcours

Approfondir le parcours : Billets d’activité : unité enfant et accompagnant requis

La catégorie d’âge décrit une éligibilité, mais peut aussi dépendre d’une unité accompagnante. Retrouvez les identifiants requis dans l’option avant de valider la composition. Une relation technique ne permet pas d’inventer un ratio d’encadrement du groupe.

Billets d’activité : unité enfant et accompagnant requis · Rapprocher les preuves du parcours

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.

Viator Supplier API : séparer places restantes et heure limite
Point documentéCe que la source préciseConséquence pour votre contrôle
Date limiteBookingCutoff contient exactement un choix : DateTime avec fuseau, ProductDateTime en heure locale du produit ou NotApplicable=true.Conserver la convention horaire avant toute comparaison.
PlacesCapacity.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ésConsumedBy 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.

Viator : les âges et les limites de participants se vérifient pour chaque activité

Une catégorie adulte ou enfant utilisée pour l’hôtel ou le vol ne suffit pas à classer les voyageurs d’une activité. Chaque produit définit ses tranches d’âge et ses règles de composition du groupe.

Viator : les âges et les limites de participants se vérifient pour chaque activité
Point documentéCe que la source préciseConséquence pour votre contrôle
Bornes propres au produitLes valeurs startAge et endAge définissent la tranche proposée par chaque produit, avec ses bornes incluses.Vérifiez l’âge numérique du voyageur contre les bornes de l’activité sélectionnée.
Limites de la réservationbookingRequirements fixe le minimum et le maximum du groupe, toutes catégories réunies.Additionnez les participants sans appliquer le maximum séparément à chaque catégorie.
Limites de chaque catégorieLes champs minTravelersPerBooking et maxTravelersPerBooking existent aussi dans chaque ageBand ; leur portée est alors cette catégorie.Contrôlez les deux niveaux même si les champs portent le même nom.
Accompagnement requisSi requiresAdultForBooking vaut true, la composition doit inclure au moins un participant ADULT ou SENIOR.Utilisez les catégories définies par ce produit, sans reprendre automatiquement celles d’un autre transport ou séjour.

Quatre contrôles avant la recherche de disponibilité

Séquence proposée pour une activité sélectionnée, avec des âges déjà connus.

  1. Lire les tranches

    Retrouver les bornes d’âge de ce produit.

  2. Classer les voyageurs

    Affecter chaque âge à la catégorie correspondante.

  3. Vérifier les quantités

    Comparer les effectifs aux limites globales et par catégorie.

  4. Contrôler le groupe

    Vérifier l’accompagnement requis, puis chercher la disponibilité du choix.

Deux groupes à reclasser avant la réservation

Produits, âges et limites fictifs.

Un voyageur de douze ans garde la catégorie enfant du vol

Dans un dossier fictif, le vol classe un voyageur de douze ans comme enfant, tandis que l’activité définit ADULT de douze à quatre-vingts ans.

Âge : 12 ans
Activité : ADULT de 12 à 80 ans
Catégorie reprise du vol : CHILD

Lecture du cas. Pour cette activité fictive, douze ans entre dans ADULT. Corrigez la composition utilisée pour vérifier le prix et la disponibilité ; le classement du vol ne définit pas celui de l’activité.

Les catégories respectent leurs limites mais le groupe est trop grand

Un produit fictif accepte au maximum six personnes au total. Le groupe comporte quatre adultes et trois enfants, chacun dans la limite de sa catégorie.

Maximum global : 6
Adultes : 4
Enfants : 3

Lecture du cas. Le total de sept dépasse la limite globale. Respecter les limites de chaque catégorie ne suffit pas ; ne présentez pas ce groupe comme réservable sur cette seule base.

Guide Viator publié le 2 septembre 2021, consulté le 23 octobre 2026. Règles à relire dans les données courantes du produit. Une composition conforme ne prouve pas la disponibilité du créneau ni la confirmation de réservation.

Viator — Implementing age bands & pax mix · publiée le 02/09/2021 · 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.

Sources et périmètre des faits documentés

La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.

  • Viator : référence technique Partner API : Tranches d’âge définies par produit, exigences de réservation et distinction GUIDE, AUDIO et WRITTEN. Les exemples de la documentation ne sont pas des règles universelles. (consultée le )
  • OCTO : produits et options : Produits, options et unités vendues ; lire les restrictions de chaque unité dans la version utilisée. (consultée le )
  • Viator Reservation System API — BookingCutoff and Capacity : Modèle Supplier API, distinct du contrat Partner API. Une place restante ne supprime pas une heure limite de réservation. (consultée le )
  • Viator — Implementing age bands & pax mix : Guide Viator publié le 2 septembre 2021, consulté le 23 octobre 2026. Règles à relire dans les données courantes du produit. Une composition conforme ne prouve pas la disponibilité du créneau ni la confirmation de réservation. (consultée le )

Questions fréquentes

Questions utiles avant de décider

Les tranches d’âge sont-elles les mêmes pour toutes les visites ?

Non. La documentation Viator précise qu’elles sont propres au produit. Il faut reprendre les limites de l’activité et de l’option choisies.

Un enfant gratuit ne consomme-t-il aucune place ?

La gratuité décrit un prix. L’occupation de capacité dépend des règles du produit et doit être vérifiée séparément.

Une visite privée se calcule-t-elle toujours par personne ?

Non. Retrouvez l’unité vendue : personne, groupe ou autre unité décrite. Gardez distincts le nombre de voyageurs et la quantité commerciale.

Peut-on reprendre automatiquement les catégories adulte et enfant d’un vol pour une activité Viator ?

Non. Les tranches d’âge et les limites de participants sont définies par produit. Rapprochez l’âge de chaque voyageur des bornes de l’activité, puis vérifiez les limites du groupe et de chaque catégorie.

Tableau de travail

Vérifier les catégories de participants

Proposition de revue éditoriale ; cocher un point ne valide ni un fournisseur ni une réservation.

Points proposés pour préparer la revue du dossier
PointPièce à rapprocherSuite à préparer
ÂgesÂges à la date de prestation et catégories proposéesFaire confirmer les limites sans supposer une règle universelle.
QuantitésNombre de personnes par catégorieComparer les unités vendues aux personnes attendues.
DocumentRépartition figurant sur le bon d’activitéCorriger une catégorie divergente avant la remise du document.

Approfondir la méthode

Modèles et champs associés

Les modèles reprennent les documents cités dans cette méthode et ses guides associés. Consultez les informations à rapprocher et les contrôles proposés.

Passer à la vérification

Des fiches de contrôle pour ce sujet

Champs à collecter, tests, erreurs fréquentes et consignes de transmission pour travailler sur un dossier concret.

Toutes les fiches de contrôle →

Étape suivante

Appliquez cette méthode à des solutions concrètes.

Explorez les catégories du répertoire puis vérifiez les capacités et conditions auprès des sources officielles.

Explorer le répertoireParler du projet