
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.
| 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.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Bornes propres au produit | Les 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éservation | bookingRequirements 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égorie | Les 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 requis | Si 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.
- Lire les tranches
Retrouver les bornes d’âge de ce produit.
- Classer les voyageurs
Affecter chaque âge à la catégorie correspondante.
- Vérifier les quantités
Comparer les effectifs aux limites globales et par catégorie.
- 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 : CHILDLecture 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 : 3Lecture 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.
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.
| Point | Pièce à rapprocher | Suite à préparer | Votre revue |
|---|---|---|---|
| Âges | Âges à la date de prestation et catégories proposées | Faire confirmer les limites sans supposer une règle universelle. | |
| Quantités | Nombre de personnes par catégorie | Comparer les unités vendues aux personnes attendues. | |
| Document | Répartition figurant sur le bon d’activité | Corriger une catégorie divergente avant la remise du document. |
0 / 3 points marqués comme examinés.
Les marques restent dans cet onglet et ne sont ni envoyées ni enregistrées par ce module.




