Carnet de correspondance des champs et ordinateur

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.

Références, limites et vérifications par périmètre
Périmètre et rôleDocumenté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.

Situations, contrôle et preuve attendue
SituationContrôlePreuve utile
Dernières places sur deux canauxCas 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éeIdentifier séparément vendeur de la transaction et interface utiliséeMontage contractuel, référence, paiement et contact de service
Annulation du créneauFermer 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.

OCTO : disponibilité retenue, expiration et confirmation
Point documentéCe que la source préciseConséquence pour votre contrôle
availabilityIdUn 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_HOLDLa 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.
ConfirmationUne 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.
AnnulationLe 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.

OCTO Pickups : le lieu de collecte n’est pas le point de rencontre par défaut
Point documentéCe que la source préciseConséquence pour votre contrôle
ActivationLe 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 produitLes 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 horaireLes 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é.

Viator : suivre une confirmation différée jusqu’à son résultat
Point documentéCe que la source préciseConséquence pour votre contrôle
Trois modesconfirmationType distingue INSTANT, MANUAL et INSTANT_THEN_MANUAL.Identifier le mode du produit avant de choisir le message de confirmation.
Attente limitéeUne 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 billetLe 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.

Hotelbeds Activities : transmettre le bon document après confirmation
Point documentéCe que la source préciseConséquence pour votre contrôle
Source finaleLe 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 fourniPour 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.
ConsignesLes 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ésLe 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é.

GetYourGuide Supplier : une modification peut conserver la référence GYG
Point documentéCe que la source préciseConséquence pour votre contrôle
Même référence GYGGetYourGuide 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ésultatL’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éservationAprè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.

Examiner le dossier et son périmètre.

Compléter la décision avec les guides et les catégories

Tous les comparatifs · Méthode et limites des sources

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.