Ingestion du catalogue d’activités
Viator : reprendre un catalogue sans confondre contenu et disponibilité
Un catalogue peut être à jour sur les descriptions et en retard sur les créneaux. Préparez deux suivis distincts pour savoir ce qui a réellement été importé avant de montrer une activité comme réservable.
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 ?
Ce dossier aide une équipe de distribution à examiner sa reprise après interruption. L’enjeu est de retrouver les produits parcourus et les disponibilités observées, puis de savoir quels éléments peuvent être publiés ou doivent attendre une nouvelle lecture.
Viator Partner 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
Viator : managing product and availability data
Viator distingue l’ingestion des produits et des disponibilités de leur interrogation en temps réel. Les parcours paginés documentés utilisent un curseur de continuation, notamment nextCursor.
Documentation de distribution Viator ; les endpoints et droits utilisables dépendent du niveau d’accès accordé au partenaire. Aucune fréquence de synchronisation universelle déduite.
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é |
|---|---|---|
| Produit | Identifiant et version de contenu. | Retrouver la description réellement diffusée. |
| Disponibilité | Produit, créneau et heure de lecture. | Séparer le stock du contenu éditorial. |
| Curseur | Continuation reçue et traitement achevé. | Reprendre après le dernier résultat prouvé. |
| Publication | État public et règle de retrait. | Examiner les produits devenus inactifs. |
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
Faites interrompre un import fictif entre récupération et enregistrement. Reprenez avec le point documenté, puis modifiez une activité et sa disponibilité séparément. Comparez le journal technique, les éléments publiés et le message proposé au client.
Le produit, le curseur et la disponibilité se retrouvent séparément ; aucune réussite globale n’est annoncée tant qu’un flux requis reste incomplet.
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.
Ingestion
Intervenants à associer : Équipe données
Conserver les points de reprise par flux.
Diffusion
Intervenants à associer : Responsable catalogue
Décider du maintien ou du retrait public.
Explication
Intervenants à associer : Support commercial
Retrouver l’observation utilisée lors de la demande.
Comparer le coût du parcours réellement exploité
Comparez le coût des lectures, du stockage des points de reprise et de la revue des écarts. Ajoutez le temps consacré aux produits dont le contenu est disponible mais le stock reste indéterminé.
Préparer la continuité des dossiers ouverts
À une interruption prolongée, transmettez les périmètres terminés, les éléments suspendus et les observations nécessaires à la prochaine lecture. Une autre équipe doit pouvoir reprendre sans reconstituer le catalogue à partir de captures.
Trois étapes pour préparer le parcours
Séparer les deux journaux
Donnez à chaque ingestion un périmètre, une heure de début et un dernier résultat exploitable. Un produit traduit et illustré peut rester visible comme information alors que sa disponibilité demande une actualisation. Faites expliciter cette différence dans le statut interne et dans le message affiché au voyageur. Une date globale de catalogue masquerait le flux réellement en retard.
Arrêter au dernier point prouvé
Scénario fictif : la troisième page échoue après deux pages enregistrées. Retrouvez le curseur reçu et la preuve de traitement de la deuxième page avant de reprendre. Une réponse récupérée mais non appliquée doit garder un état distinct. Comparez les identifiants importés à un jeu attendu, avec un produit modifié et un produit retiré pendant l’essai.
Contrôler avant la remise en vente
À la fin de la reprise, examinez un produit conservé, un produit devenu inactif et un créneau modifié. Vérifiez le lien entre la carte publique et la dernière disponibilité pertinente. Le support doit pouvoir expliquer pourquoi un contenu demeure consultable sans annoncer un stock certain. Décidez qui peut lever une suspension de publication.
Erreurs à éviter dans la comparaison
- Utiliser la fraîcheur des descriptions comme preuve de stock.
- Effacer le point de reprise avant de vérifier son application.
- Laisser un produit retiré sans décision de publication.
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
Le contenu importé prouve-t-il une disponibilité actuelle ?
Non. Rapprochez le produit de son flux de disponibilité et de la lecture requise pour le parcours de vente.
Quel point garder après une interruption ?
Le point documenté accompagné de la dernière application prouvée. Une réponse reçue et un traitement achevé sont deux observations différentes.
Faut-il retirer toute activité dont le stock est incertain ?
Définissez les usages autorisés : information, demande ou vente. La présentation doit indiquer ce qui reste à confirmer.
Quelles preuves transmettre à la fin du pilote ?
À une interruption prolongée, transmettez les périmètres terminés, les éléments suspendus et les observations nécessaires à la prochaine lecture. Une autre équipe doit pouvoir reprendre sans reconstituer le catalogue à partir de captures.