
Comparatif documenté · 4 périmètres
Activités : niveaux Viator, GetYourGuide et standard OCTO
Une réservation intégrée peut exister dans un modèle affilié. À l’inverse, un standard ouvert ne donne aucun catalogue commercial : niveau d’accès, lieu de transaction et responsabilité doivent être lus séparément.
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 |
|---|---|---|---|
Droits techniques selon le niveau partenaire | Basic et Full Affiliate renvoient la transaction vers viator.com. Full + Booking permet la transaction sur le site partenaire, après autorisation ; dans ce montage affilié, Viator reste merchant of record. Viator : niveaux Affiliate et Full + Booking ↗Consulté le | Périmètre Affiliate décrit sur cette page ; ne pas le confondre avec une offre Merchant ou la certification d’un compte. | Quel niveau est accordé et qui assure transaction, service client et remboursement ? |
Programme affilié avec plusieurs parcours | La page Levels of API access présente Basic et Full avec transaction sur viator.com, puis Full + Booking avec transaction sur le site partenaire ; dans ce dernier montage affilié, Viator reste merchant of record. Viator : niveaux de l’Affiliate API ↗Consulté le | Full et Full + Booking demandent une approbation et une certification. Ce modèle ne doit pas être assimilé au contrat Merchant API. | Qui prend en charge la transaction et le service client dans le programme choisi, et quelles preuves de certification devons-nous fournir ? |
Basic, Reading ou Masterbill | Basic fournit des informations synthétiques ; Reading ajoute options et disponibilités. Masterbill permet de réserver avec facturation mensuelle et place le partenaire dans le rôle de merchant of record, selon le montage décrit. GetYourGuide : Basic, Reading et Masterbill ↗Consulté le | API partenaire de distribution ; ces niveaux ne décrivent pas les opérations de la Supplier API. | Quel niveau, contrat et rôle commercial votre responsable partenaire confirme-t-il ? |
Spécification d’échange ouverte | OCTO distingue endpoints du socle et capacités optionnelles, notamment contenu, prix et prises en charge. La création d’une réservation peut retenir la disponibilité en ON_HOLD avant confirmation ou expiration. OCTO : socle et capacités optionnelles ↗Consulté le | Spécification d’échange : capacités réellement implémentées et activation commerciale du partenaire à vérifier. | Quelles capacités sont actives et quelle preuve établit la confirmation de la réservation ? |
Lire trois questions au lieu d’une étiquette commerciale
Déterminez d’abord qui confirme la place, puis où le voyageur effectue la transaction et enfin quel acteur porte le paiement et le service prévu au contrat. Ces questions peuvent recevoir des réponses différentes. Une expérience intégrée dans votre interface peut utiliser un dispositif de paiement du partenaire. Votre équipe doit expliquer ce montage au voyageur et savoir retrouver la référence correcte lorsqu’il demande une annulation.
Le niveau d’accès est une donnée du projet à consigner avec la date et la version des documents. Ne reprenez pas une ancienne page de présentation lorsqu’une documentation technique plus récente distingue des niveaux supplémentaires. En cas de différence entre sources, demandez une réponse écrite du partenaire et conservez la limite dans la grille. Un accès accordé à une autre entreprise ne prouve pas votre éligibilité.
Ne pas confondre standard et accès au marché
Une spécification commune réduit les différences de structure entre échanges. Elle n’efface pas les particularités des produits : langue, point de rendez-vous, tranche d’âge, départ confirmé ou seuil minimal. Demandez les identifiants du produit et de son option, les créneaux vendables et le contenu à présenter. Le test doit être réalisé sur la connexion réellement proposée, sans attribuer à tous les fournisseurs les capacités d’un exemple.
L’opérateur qui relie son logiciel à un canal de vente et le distributeur qui importe un catalogue regardent des flux de sens différent. L’un publie ou met à jour ses places ; l’autre demande une disponibilité et transmet une commande. Écrivez ce sens dans le schéma du projet. La présence d’un portail intégrateur ne signifie pas qu’un distributeur peut obtenir l’ensemble des activités de la plateforme.
Tester le jour de l’activité, pas seulement le panier
Prenez une visite avec horaire local, option de langue et participants de catégories différentes. Contrôlez le point de rendez-vous, les consignes, le total et le document remis. Vérifiez que le titre contient la référence reconnue par l’opérateur. Un e-mail de paiement ou un résumé de commande n’est pas forcément le billet que le voyageur doit présenter à l’entrée.
Ajoutez un créneau fermé par l’opérateur et un participant dont la demande d’annulation arrive après l’échéance. Le bon fonctionnement combine état de la réservation, invalidation du billet, information du voyageur et mouvement financier. Évaluez la charge d’orientation du support dans l’affiliation autant que la charge de gestion dans une vente intégrée. Un parcours plus autonome peut aussi demander davantage de suivi.
Retrouver les billets lorsque le canal de vente change
Scénario de préparation : la connexion est remplacée avant l’exécution de visites déjà vendues. Vérifiez comment retrouver les titres, modifier les dates et informer les accueils. Une capacité technique comparable ne garantit pas la reprise des identifiants de l’ancien système.
Conservez réservations ouvertes, documents clients et fonctions d’après-vente autorisées. Demandez le comportement des anciens billets après modification et attribuez les contrôles restant à faire sur place avant de clôturer le pilote.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
L’autonomie souhaitée du parcours détermine le niveau d’intégration à demander. Une redirection peut suffire à un média ; un vendeur qui confirme les activités doit maîtriser capacité, documents et changements. Le nom du standard ne remplace pas le périmètre des opérations activées.
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.
Média ou guide de destination
Cas fictif : un guide présente dix activités et envoie le visiteur vers le vendeur choisi. Son objectif est une recommandation traçable, sans créer ni modifier les réservations.
Avant de retenir ce périmètre : Contrôler l’offre de destination, le vendeur, la continuité du lien et le contact après vente. Une intégration plus large n’apporte de valeur que si le média doit réellement assumer de nouvelles opérations.
Distributeur qui confirme les ventes
Cas fictif : votre site prend les participants et confirme une activité datée. Un départ est instantanément confirmable, un autre exige une réponse de l’exploitant selon les règles fournies.
Avant de retenir ce périmètre : Faire apparaître les deux parcours et leurs messages distincts. Retrouver référence, état, conditions et circuit d’annulation ; le mot « réservation » ne doit pas transformer la seconde demande en confirmation obtenue.
Opérateur avec plusieurs revendeurs
Cas fictif : une activité de douze places est vendue en direct et par deux partenaires. L’exploitant veut conserver la même capacité de référence et une liste d’accueil cohérente.
Avant de retenir ce périmètre : Comparer les affectations et les réponses finales par canal, puis le retrait d’une vente. Le besoin porte sur la capacité et l’exploitation communes, au-delà du nombre de connexions annoncé.
Arbitrer les contraintes et le coût de fonctionnement
Un parcours intégré évite certaines ruptures de navigation mais ajoute gestion des états et responsabilité de support. Une affiliation délègue la réservation mais peut limiter la maîtrise du suivi. Comparez les flux réellement nécessaires à votre modèle au lieu de demander toutes les fonctions d’une plateforme par principe. Pour une activité fictive vendue sur trois canaux, comparez la suppression d’un créneau dans chaque catalogue, l’information des personnes déjà inscrites et le traitement des sommes encaissées. La connexion la plus complète pour publier peut rester insuffisante pour annuler un départ. Notez les opérations automatiques et celles confiées à l’exploitant, puis faites reprendre le cas par la personne chargée de l’accueil. Le nombre de produits reçus n’évalue pas cette continuité.
Points à clarifier avant la décision
- Un état de demande en attente est présenté au voyageur comme une prestation déjà confirmée.
- Les canaux ne peuvent pas être rapprochés d’une capacité et d’une liste de participants de référence.
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 |
|---|---|---|
| Dernières places sur deux canaux | Cas fictif : capacité 4, un canal demande 3 places, l’autre 2 sur le même départ. Rejouer maintien, expiration et confirmation. | Aucune capacité confirmée supérieure à 4 ; refus ou alternative expliqué, stock libéré après expiration selon la règle convenue. |
| Commande intégrée | Identifier séparément vendeur de la transaction et interface utilisée | Montage contractuel, référence, paiement et contact de service |
| Annulation du créneau | Fermer le départ fictif après émission de 3 billets. Suivre les revendeurs et les participants concernés. | État des billets, responsable de notification et statut du remboursement distincts. |
| Créneau supprimé | Suivre annulation, billet, notification et remboursement | État final concordant chez distributeur, canal et opérateur |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
Affiliation signifie-t-elle toujours redirection ?
Non. Certains programmes proposent un parcours affilié avec réservation intégrée. Vérifiez le niveau accordé et le rôle du prestataire de transaction dans le montage choisi.
Une compatibilité OCTO permet-elle de vendre toutes les activités ?
Le standard décrit des échanges. Le contrat, les produits connectés et les capacités implémentées déterminent ce que vous pouvez réellement distribuer.
Comment choisir entre catalogue et vente intégrée ?
Commencez par les droits accessibles et la capacité de votre équipe à suivre les exceptions. Comparez ensuite l’expérience voyageur et le coût complet de chaque parcours.
Comment comparer deux niveaux d’API sans favoriser le plus riche ?
Comparez les opérations nécessaires à votre rôle : orienter, vendre ou exploiter. Faites démontrer leur résultat et leur reprise avec les droits du compte prévu. Une fonction supplémentaire peut créer davantage de maintenance ou de support ; elle mérite d’être retenue lorsqu’elle sert une tâche réelle et possède un responsable.
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.
OCTO Pickups : le lieu de collecte n’est pas le point de rencontre par défaut
La capacité Pickups décrit une collecte à un point prédéfini ou à un lieu proposé par le client dans une zone prise en charge. Le transport peut être gratuit ou payant selon l’offre.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Activation | Le revendeur doit déclarer pickups dans Octo-Capabilities lorsque le fournisseur prend cette capacité en charge. | Ne pas attendre ces champs d’une implémentation OCTO limitée au socle. |
| Option produit | Les informations peuvent indiquer si la collecte est disponible, obligatoire et quels lieux ou zones sont pris en charge. | Vérifier l’option choisie, plutôt que généraliser la collecte à tout le catalogue. |
| Fenêtre horaire | Les réponses de disponibilité et de réservation peuvent inclure la fenêtre de prise en charge. | Afficher le lieu confirmé et la fenêtre correspondante dans les consignes voyageur. |
La capacité optionnelle ne garantit ni un service de transfert chez chaque opérateur ni l’éligibilité de n’importe quelle adresse.
OCTO — capacité optionnelle Pickups · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Viator : suivre une confirmation différée jusqu’à son résultat
Le mode de confirmation détermine ce que le client peut considérer comme réservé.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Trois modes | confirmationType distingue INSTANT, MANUAL et INSTANT_THEN_MANUAL. | Identifier le mode du produit avant de choisir le message de confirmation. |
| Attente limitée | Une demande manuelle non traitée est rejetée après 72 heures ou à l’atteinte de sa limite de réservation, si celle-ci arrive avant. | Ne pas présenter 72 heures comme un délai toujours disponible. |
| Paiement et billet | Le parcours manuel prévoit la facturation après confirmation et le voucher seulement une fois la réservation confirmée. | Distinguer préautorisation, paiement et document disponible, prestation par prestation. |
Périmètre transactionnel Merchant ou Affiliate Full + Booking autorisé ; ne pas confondre cette Partner API avec la Supplier API.
Viator Partner API — Booking confirmation types · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Hotelbeds Activities : transmettre le bon document après confirmation
Le document remis au voyageur doit reprendre la réservation confirmée et les consignes d’utilisation du billet.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Source finale | Le guide demande de reprendre les informations du voucher depuis la réponse de réservation. | Ne pas reconstruire le document à partir d’un ancien résultat de recherche. |
| PDF fourni | Pour les produits en intégration directe qui retournent un PDF dans vouchers après confirmation, Hotelbeds demande de transmettre ce PDF sans régénérer un autre voucher. | Identifier le circuit applicable au produit. |
| Consignes | Les commentaires de type CONTRACT_REMARKS donnent notamment les modalités pour obtenir les billets. | Conserver ces consignes ; une référence de réservation seule peut être insuffisante. |
| Deux identités | Le guide distingue providerInformation, pour les coordonnées du prestataire, de supplier, pour les mentions « bookable and payable ». | Distinguer coordonnées opérationnelles et intermédiaire commercial. |
Exigences du circuit Activities documenté. Un voucher ne dispense pas de lire ses conditions d’échange ou d’accès.
Hotelbeds — Activities certification, voucher information · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
GetYourGuide Supplier : une modification peut conserver la référence GYG
Une demande de changement d’effectif ou d’horaire crée un nouveau cycle de réservation dans le parcours documenté.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Même référence GYG | GetYourGuide crée une nouvelle réserve puis une réservation avec la même référence GYG, mais des données modifiées. | Ne pas ignorer la demande comme un doublon uniquement parce que la référence GYG est déjà connue. |
| Nouveau résultat | L’intégrateur doit détecter les données modifiées et retourner une nouvelle réservation. | Conserver la référence fournisseur et les détails de chaque version. |
| Ancienne réservation | Après réussite de la nouvelle réservation, GetYourGuide demande l’annulation avec l’ancienne référence de réservation fournisseur. | Appliquer l’annulation à la bonne version. |
Parcours Supplier API lorsque le client demande une modification à GetYourGuide ; distinct des droits de l’API partenaire de distribution.
GetYourGuide Integrator Portal — Booking Change · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Compléter la décision avec les guides et les catégories
- Activités : affiliation, API de contenu ou réservation marchande
- Distribution des activités : billetterie et connectivité
- Vouchers et billets d’activités : de la réservation au contrôle d’accès
- Capacités et créneaux de visite : vendre des places disponibles
- Activités et billetterie
- Réseaux et accompagnement