Connexion du système fournisseur
GetYourGuide Supplier API : relier réserve, confirmation et reprise
La réserve d’une capacité et la confirmation finale doivent rester reliées quand une réponse tarde. Préparez un registre qui permette à l’intégrateur et à l’exploitant de retrouver le même engagement.
Références consultées aux dates indiquées dans chaque source · Mis à jour le · Méthode éditoriale de Performance Voyage
Quel rôle dans votre organisation ?
Utilisez ce dossier pour préparer la connexion d’un système fournisseur à GetYourGuide. La décision porte sur la conservation des références et le comportement après une répétition, pas sur l’ouverture d’un accès marchand ou sur les conditions commerciales du partenaire.
GetYourGuide API figure dans la famille Activités et billetterie. Les prix, pays couverts, niveaux de service et droits du compte ne sont pas certifiés par ce dossier. Faites-les préciser dans une proposition datée.
Source officielle de l’entrée ↗ · Retrouver la fiche du répertoire
Ce que les sources documentent
GetYourGuide : Supplier API endpoints
Dans le parcours Supplier API, reserve constitue une étape précédant book. La documentation décrit une référence de réservation et une expiration, puis la confirmation de la réserve ; elle demande aussi de traiter les répétitions sans créer une autre réservation pour la même demande.
Endpoints à implémenter côté fournisseur ou intégrateur. Ce parcours ne décrit pas une API de catalogue pour revendeurs ; les fonctions et règles doivent être confirmées pour la connexion concernée.
Consultée le
Consulter la source 1 ↗La suite propose nos contrôles de sélection : elle ne décrit pas des tests exécutés sur un compte fournisseur. Une documentation peut évoluer ; relisez la version applicable avant de développer ou de signer.
Quatre ensembles de données à rapprocher
| Ensemble | À collecter | Contrôle proposé |
|---|---|---|
| Réserve | Référence et échéance reçues. | Identifier la capacité tenue. |
| Confirmation | Lien avec la réserve et résultat. | Retrouver le même engagement. |
| Répétition | Demande initiale et retour répété. | Contrôler le nombre de dossiers créés. |
| Expiration | Heure observée et état source. | Éviter de promettre une capacité libérée. |
Conservez identifiant, source, date et résultat dans le registre de comparaison. Travaillez avec des données anonymisées et les accès de test autorisés.
Un scénario à faire rejouer pendant le pilote
Rejouez une confirmation avec réponse absente, une répétition et une expiration dans des données fictives. Faites expliquer chaque cas par une personne qui n’a pas assisté à l’essai technique.
Une demande répétée reste rattachée au dossier initial ; la capacité et le statut annoncé se rapprochent sans double engagement.
Préparez les mêmes exemples pour les autres acteurs de la catégorie Activités et billetterie. Comparez les responsabilités et les preuves sur votre tâche, avec la grille d’évaluation et le coût complet.
Définir les responsabilités et les conditions de fonctionnement
Attribuer les contrôles de ce parcours avant de commencer le pilote.
Connexion
Intervenants à associer : Intégrateur
Documenter les références et les répétitions.
Capacité
Intervenants à associer : Exploitant
Rapprocher les unités réellement retenues.
Accueil
Intervenants à associer : Support opérationnel
Répondre à partir du statut retrouvé.
Comparer le coût du parcours réellement exploité
Ajoutez à la connexion les essais de répétition, les cas expirés et la formation de l’accueil. Mesurez le temps de résolution lorsque les deux équipes observent des états différents.
Préparer la continuité des dossiers ouverts
Transmettez réserves ouvertes, confirmations retrouvées et références en attente de rapprochement. Le relais conserve les échéances observées et le responsable de la prochaine décision.
Trois étapes pour préparer le parcours
Dessiner les deux engagements
Repérez l’objet créé lors de la réserve, son échéance et ce qui change à la confirmation. L’équipe d’accueil doit savoir quel état permet de préparer la prestation. Écrivez aussi le message à donner lorsqu’un client présente une référence dont le statut reste à retrouver. Une preuve de réserve ne remplace pas le contrôle de confirmation attendu.
Simuler une réponse perdue
Scénario fictif : la confirmation a été appliquée mais la réponse n’arrive pas à l’appelant. Faites répéter la même demande dans le cadre de test autorisé. Comparez les références, le nombre de dossiers et la capacité consommée. Conservez le résultat observé sans créer un second cas qui cacherait le comportement de reprise.
Transmettre le résultat à l’accueil
Préparez trois exemples : réserve encore ouverte, confirmation retrouvée et réserve expirée. Pour chacun, donnez au support la référence, l’heure d’observation et l’interlocuteur habilité à décider. Une réponse client doit s’appuyer sur l’état du dossier concerné et annoncer la prochaine vérification lorsque la preuve manque.
Erreurs à éviter dans la comparaison
- Présenter Supplier API comme un catalogue ouvert aux revendeurs.
- Assimiler une réserve à une confirmation définitive.
- Compter une unité groupe comme une personne sans relire le produit.
Marquez un point non démontré comme « à confirmer ». Il reste distinct d’un échec observé et d’une fonction annoncée. Une décision fiable peut retenir un périmètre plus restreint si les responsabilités et la reprise sont maîtrisées.
Conserver les résultats du pilote
Utiliser la fiche de contrôle de ce parcours et le registre de recette associé. Garder les résultats observés distincts des points à confirmer et attribuer les suites aux intervenants concernés.
Questions fréquentes
Ce dossier concerne-t-il une API de revente ?
Il concerne les endpoints Supplier API implémentés côté fournisseur ou intégrateur. Les accès de distribution demandent un examen distinct.
Une absence de réponse impose-t-elle une nouvelle réservation ?
Retrouvez d’abord la demande initiale et son état. La recette doit prouver le comportement des répétitions.
Quelle durée d’expiration appliquer ?
Utilisez la donnée et la règle applicables au parcours concerné. Ce dossier ne fixe pas de durée universelle.
Quelles preuves transmettre à la fin du pilote ?
Transmettez réserves ouvertes, confirmations retrouvées et références en attente de rapprochement. Le relais conserve les échéances observées et le responsable de la prochaine décision.