
Échéances de vente · Fiche de contrôle
Vérifier le parcours : Heure limite de réservation : créneau ouvert et vente encore possible
Un départ visible dans un calendrier peut être trop proche pour rester réservable. Le distributeur doit expliquer la limite de vente sans la confondre avec la dernière admission ou l’annulation.
Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : OCTO — calendrier, disponibilité et utcCutoffAt, consultée le .
Définir ce que la fiche doit permettre de vérifier
Partir de l’occurrence sélectionnée et de sa limite source, puis comparer les instants complets. Rejouer une reprise de panier de part et d’autre de la borne ; le calendrier du jour, les places et le résultat de réservation répondent à des questions différentes.
Viator Certification : champs de cutoff et résultat de réservation ; règle et accès propres au parcours utilisé.
Mise en pratique · situation fictive
Quel résultat cette fiche doit-elle permettre de vérifier ?
Les données et conditions de cet exercice sont inventées. Rejouez le cas dans un environnement autorisé en utilisant les huit contrôles de la fiche, puis comparez votre lecture au résultat proposé.
Situation de départ
Un départ fictif à 10 h +01:00 porte utcCutoffAt à 08 h 30 UTC. Le panier commence à 09 h 28 local et reprend à 09 h 31, sans réservation confirmée retrouvée. Le calendrier de la journée affiche encore une disponibilité.
Comparer avec le résultat attendu
La limite vaut 09 h 30 dans cet affichage : la sélection était deux minutes avant, la reprise une minute après. Le calendrier du jour ne prouve pas l’ouverture du départ de 10 h. Retrouver le résultat existant et les règles du parcours, puis vérifier séparément toute alternative ; le cutoff OCTO porte sur la confirmation.
Huit champs à rapprocher de leurs preuves
Gardez la source et la date de vérification à côté des informations collectées. Sur téléphone, les contrôles se lisent en cartes.
Aucun contrôle marqué comme examiné.
Marquez seulement les points dont vous avez examiné la preuve. Ce repère de lecture reste dans cet onglet ; il ne certifie pas le dossier et disparaît au rechargement.
| Champ | À collecter | Test ou rapprochement |
|---|---|---|
| Produit | Option et départ concernés | Cibler la limite. |
| Type | Type de cutoff et valeur documentés pour le produit. | Retrouver leur sens dans le parcours courant ; ne pas convertir une autre échéance en limite de vente par défaut. |
| Début | Départ sélectionné, heure source et fuseau applicable. | Comparer le cutoff à la bonne occurrence du départ, en conservant les instants utilisés par le traitement. |
| Fuseau | Zone de l’activité | Interpréter l’instant. |
| Courant | Départ fictif 10 h +01:00 ; cutoff 08 h 30 UTC, soit 09 h 30 local ; sélection 09 h 28. | Deux minutes avant la borne ne garantissent pas une confirmation. Vérifier l’état courant et le résultat de réservation. |
| Parcours | Panier repris à 09 h 31 ; ancien calendrier toujours visible. | Relire l’occurrence et sa limite, puis préparer un autre créneau vérifié ; ne pas reprendre le cutoff du départ précédent. |
| Message | Motif de reprise | Expliquer le créneau fermé. |
| Alternative | Nouvelle sélection vérifiée | Préparer une suite utile. |
Trois erreurs qui fragilisent le dossier
- Confondre cutoff et dernière admission.
- Utiliser le fuseau du conseiller par défaut.
- Garder une ancienne disponibilité sans relecture.
Transmettre un résultat exploitable
Conserver produit, option, occurrence, disponibilité courante, cutoff source, instants comparés, état de réservation et alternative éventuellement vérifiée.
Choisir un registre de contenus, médias ou recette · Préciser les responsabilités du parcours
Questions fréquentes
Un créneau visible est-il encore vendable ?
Il faut vérifier sa limite de réservation et le résultat courant.
Peut-on choisir une durée par défaut ?
Conservez la règle documentée ou attribuez la clarification.
Quel cas limite tester ?
Le passage de l’échéance dans un parcours fictif autorisé.
Documentation et application
Les précisions utiles des sources
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.
OCTO : confirmer avant l’heure limite et garder le contexte du créneau
L’heure de début d’une activité et la dernière heure de confirmation ne répondent pas à la même question. Une lecture correcte de la disponibilité conserve aussi l’option choisie et les éventuelles pauses d’ouverture.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Confirmation avant utcCutoffAt | Le champ utcCutoffAt indique l’échéance avant laquelle la réservation doit être confirmée. | Comparez l’instant de confirmation à cette échéance. Commencer le parcours avant la limite ne démontre pas que la confirmation est arrivée à temps. |
| Début local et échéance UTC | localDateTimeStart exprime le début du produit dans son heure locale ; utcCutoffAt donne une échéance en UTC. | Comparez des instants tenant compte du décalage horaire. L’activité peut ne pas avoir commencé alors que la confirmation n’est déjà plus possible pour ce créneau. |
| Identifiant dans le périmètre de l’option | L’identifiant de disponibilité est unique au sein de l’option. | Conservez le produit et l’option avec l’identifiant. Deux options portant le même identifiant de créneau ne doivent pas être fusionnées sur ce seul champ. |
| Plusieurs périodes d’ouverture | openingHours peut contenir plusieurs périodes, y compris pour une disponibilité comportant une heure de début. | Conservez les pauses et vérifiez la période pertinente ; une première ouverture et une dernière fermeture ne prouvent pas une ouverture continue. |
Deux créneaux dont le contexte change la décision
Réponses fictives simplifiées. Les identifiants et horaires ne correspondent à aucune réservation réelle.
L’activité commence plus tard mais la limite est dépassée
Le 10 novembre 2026, une activité fictive commence à 15 h dans un fuseau à UTC+1. Sa confirmation doit intervenir avant 12 h UTC.
localDateTimeStart : 2026-11-10T15:00:00+01:00
utcCutoffAt : 2026-11-10T12:00:00Z
Confirmation tentée : 2026-11-10T12:15:00ZLecture du cas. La tentative intervient à 13 h 15 locales : l’activité n’a pas commencé, mais l’échéance de 13 h locales est dépassée. Le seul horaire de début ne permet pas de conclure que ce créneau est encore confirmable.
Le même identifiant apparaît dans deux options
Un catalogue fictif a deux options d’un produit et reçoit la même valeur d’identifiant de disponibilité dans chacune.
Produit : visite fictive
Option A, disponibilité : slot-1
Option B, disponibilité : slot-1Lecture du cas. L’unicité documentée porte sur l’option. Conservez les couples option et disponibilité, avec le produit, puis les conditions propres à chaque réponse. Ne dédupliquez pas ces deux offres sur slot-1 seul.
Périmètre : modèle Availability du cœur OCTO, consulté le 23 octobre 2026. Les réponses du fournisseur et leur fraîcheur restent à vérifier. Les heures fictives ci-dessous servent uniquement à comparer les instants ; elles ne décrivent pas une activité proposée à la vente.
OCTO — Availability, API Core · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Approfondir ce contrôle
Approfondir la méthode
Modèles et champs associés
Ces modèles sont reliés à cette fiche ou à ses guides. Choisissez le périmètre qui correspond à votre contrôle. Consultez les informations à rapprocher et les contrôles proposés.
Passer à la vérification
Des fiches de contrôle pour ce sujet
Champs à collecter, tests, erreurs fréquentes et consignes de transmission pour travailler sur un dossier concret.

Activités
Contrôler une fiche activité et son point de rendez-vous
La description d’une activité doit permettre de choisir le bon produit et de rejoindre le bon accueil. Contrôlez ensemble option, horaire, participants, inclusions et document d’accès.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler une fiche activité et son point de rendez-vous →
Activités
Contrôler un voucher ou un billet d’activité
Un document généré ne prouve pas à lui seul que la prestation est confirmée. Vérifiez la réservation et les conditions d’accès avant d’envoyer le billet.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler un voucher ou un billet d’activité →
Activités et capacité
Contrôler les ressources partagées entre activités
Deux activités peuvent consommer le même guide, véhicule ou équipement. Vérifiez que les créneaux diffusés correspondent à une prestation réellement réalisable.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler les ressources partagées entre activités →