Impostare un periodo di prenotazione anticipata minimo

Impostare un periodo di prenotazione anticipata minimo

In molti casi, un commerciante vorrebbe che determinati servizi o appuntamenti vengano prenotati con un preavviso minimo. Questi possono essere impostati a livello di servizio e/o di disponibilità. Se è impostato su entrambi, verrà utilizzata l'impostazione a livello di disponibilità.

Definizione del livello di servizio

A livello di servizio, il campo si chiama rules.min_advance_booking. Questo campo deve essere impostato sul numero di secondi prima dell'ora di inizio della prenotazione che deve essere effettuata. Ad esempio, se la prenotazione deve sempre essere effettuata un'ora prima dell'ora di inizio, questo campo viene impostato su 3600 (quindi una prenotazione per le 15:00 può essere prenotata fino alle 14:00). Questo vale per tutti gli slot per quel servizio (a meno che non venga ignorato dalla definizione a livello di slot).

JSON

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

Definizione a livello di slot

A livello di slot di disponibilità, il campo si chiama scheduling_rule_overrides.last_bookable_sec. Questo campo indica l'ultima volta (timestamp EPOCH) in cui è possibile prenotare lo slot specifico. Questo vale per ogni singolo slot in cui è stato specificato.

JSON

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

Avviso: l'implementazione del limite di prenotazione anticipata nei feed non ti esime dall'obbligo di controllare se la prenotazione rientra nel periodo di prenotazione consentito e di gestirla BookingFailure SLOT_UNAVAILABLE. Potrebbero verificarsi casi limite (ad esempio una scheda del browser bloccata) in cui un messaggio CreateBooking potrebbe essere inviato al di fuori del periodo di prenotazione. Al ricevimento di un messaggio CreateBooking, il sistema deve confermare che la prenotazione avviene entro il periodo di prenotazione consentito e, in caso contrario, rispondere con CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE.