Impostare le finestre di annullamento

Come aggiungere finestre di annullamento

Le finestre di annullamento definiscono quando i pulsanti Annulla e Modifica sono attivi. Ciò significa che le funzioni di annullamento e modifica non saranno utilizzabili nelle email di conferma dell'utente e scompariranno da tutte le altre piattaforme, inclusa la finestra modale di conferma.

Le finestre di annullamento possono essere attivate in due modi: a livello di servizio e a livello di slot. Le procedure per specificare le finestre a questi livelli sono discusse di seguito.

Se sono impostate sia una finestra di annullamento a livello di servizio sia una a livello di slot, verrà applicata la finestra a livello di slot. Se non sono impostati, la finestra di annullamento viene impostata per impostazione predefinita sull'inizio della fascia oraria (ovvero l'utente può annullare la prenotazione all'ultimo minuto).

Definizione del livello di servizio

Le finestre di annullamento a livello di servizio possono essere attivate specificando rules.min_advance_online_canceling nel feed Service. 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 può essere annullata solo fino alle 24 ore prima dell'orario di inizio, questo campo viene impostato su 86400 (quindi una prenotazione per le 15:00 può essere annullata solo fino alle 15:00 del giorno precedente). 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_online_canceling": 86400
      }
    }
  ]
}

Definizione a livello di slot

A livello di slot di disponibilità, il campo si chiama scheduling_rule_overrides.last_online_cancellable_sec. Questo campo indica l'ultima ora (timestamp EPOCH) in cui è possibile annullare l'apposito slot. Questo vale per ogni singolo slot in cui è stato specificato.

JSON

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

Avviso: l'implementazione del periodo di annullamento nei feed non ti esime dall'implementare e gestire BookingFailure OUTSIDE_CANCELLATION_WINDOW. Potrebbero verificarsi casi limite (ad esempio una scheda del browser bloccata) in cui un messaggio UpdateBooking potrebbe essere inviato al di fuori del periodo di annullamento specificato. Alla ricezione di un messaggio UpdateBooking, il sistema deve confermare che la modifica avviene entro il periodo di annullamento specificato e, in caso contrario, rispondere con UpdateBookingResponse.booking_failure = OUTSIDE_CANCELLATION_WINDOW.