Définir une période minimale de réservation à l'avance

Définir une période minimale de réservation à l'avance

Dans de nombreux cas, un marchand souhaite que des services ou des emplacements spécifiques soient réservés un minimum de temps à l'avance. Elles peuvent être définies au niveau du service et/ou de la disponibilité. Si les deux valeurs sont définies, le paramètre du niveau de disponibilité est utilisé.

Définition du niveau de service

Au niveau de service, le champ s'appelle rules.min_advance_booking. Ce champ doit être défini sur le nombre de secondes avant l'heure de début de la réservation. Par exemple, si la réservation doit toujours être effectuée 1 heure avant l'heure de début, ce champ doit être défini sur 3600 (une réservation pour 15h peut donc être réservée jusqu'à 14h). Cela s'applique à tous les emplacements de ce service (sauf s'ils sont remplacés par une définition au niveau des emplacements).

JSON

"service": [
  {
    "rules": {
      "min_advance_booking": 3600
    }
  }
]

Définition au niveau de l'emplacement

Au niveau du créneau de disponibilité, le champ s'appelle scheduling_rule_overrides.last_bookable_sec. Ce champ indique la dernière heure (horodatage EPOCH) à laquelle le créneau spécifique peut être réservé. Cela s'applique à chaque espace publicitaire spécifique pour lequel cette valeur est spécifiée.

JSON

"service_availability": [
  {
    "availability": {
      "scheduling_rule_overrides": {
        "last_bookable_sec": 1468081800
        }
    }
  }
]

Avertissement: L'implémentation d'une limite de réservation à l'avance dans les flux ne vous empêche pas de vérifier si la réservation est effectuée dans la période de réservation autorisée et de la gérer BookingFailure SLOT_UNAVAILABLE. Dans certains cas limites (par exemple, un onglet de navigateur de blocage) où un CreateBooking peut être envoyé en dehors de la période de réservation. À la réception du message CreateBooking, votre système doit confirmer que la réservation a lieu dans la période de réservation autorisée et, si ce n'est pas le cas, répondre avec CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE.