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

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

Há muitos casos em que um comerciante gostaria que serviços ou horários específicos fossem reservados com antecedência mínima. Elas podem ser definidas no nível do serviço e/ou da disponibilidade. Se ele for definido em ambos, a configuração no nível de disponibilidade será usada.

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

No nível do serviço, o campo é chamado de rules.min_advance_booking. Esse campo precisa ser definido com o número de segundos de antecedência do horário de início da reserva que 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 3600. Assim, uma reserva para as 15h pode ser feita até as 13h. Isso se aplica a todos os espaços desse serviço (a menos que seja substituído pela definição no nível do espaço).

JSON

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

Definição no nível do slot

No nível do espaço disponível, o campo é chamado scheduling_rule_overrides.last_bookable_sec. Esse campo é o último horário (carimbo de data/hora da ÉPOCA) em que o slot específico pode ser reservado. Isso se aplica a cada slot individual em que isso foi especificado.

JSON

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

Aviso: a implementação do limite de reserva antecipada nos feeds não impede que você verifique se a reserva está dentro do período permitido e a processe BookingFailure SLOT_UNAVAILABLE. Pode haver casos extremos (como uma guia de navegador parada) em que uma CreateBooking pode ser enviada fora da janela de reserva. Ao receber uma CreateBooking, seu sistema precisa confirmar que a reserva ocorre dentro do período permitido e, se não ocorrer, responder com CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE.