Definir um tempo mínimo de reserva com antecedência

Como definir um tempo mínimo de reserva avançado

Há muitos casos em que um comerciante quer que serviços ou slots específicos sejam reservados com um tempo mínimo de antecedência. Isso pode ser definido no nível de serviço e/ou no de disponibilidade. Se estiver definida nos dois, a configuração no nível de disponibilidade será usada.

Definição de nível de serviço

No nível de serviço, o campo é chamado de rules.min_advance_booking. Esse campo precisa ser definido como o número de segundos antes do horário de início da reserva em que ela precisa ser feita. Por exemplo, se a reserva sempre precisar ser feita uma hora antes do horário de início, esse campo será definido como 3.600. Assim, uma reserva para as 15h pode ser feita até as 14h. Isso se aplica a todos os slots para esse serviço, a menos que seja modificado pela definição no nível do slot.

JSON

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

Definição de nível de slot

No nível do slot de disponibilidade, o campo é chamado scheduling_rule_overrides.last_bookable_sec. Este campo é a última vez (carimbo de data/hora de EPOCH) que o espaço específico pode ser reservado. Isso se aplicaria a cada espaço individual em que isso foi especificado.

JSON

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

Aviso: implementar um limite de agendamento antecipado nos feeds não impede que você tenha que verificar se a reserva está dentro da janela permitida e processar BookingFailure SLOT_UNAVAILABLE. Pode haver casos extremos (como uma guia do navegador de barraca) em que um CreateBooking pode ser enviado para fora da janela de reserva. Ao receber uma CreateBooking, seu sistema precisa confirmar que o agendamento ocorre dentro da janela de reserva permitida e, se não estiver, responder com CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE.