Перейти к основному содержимому

Бронирования

Обзор​

API бронирования позволяет создавать, получать и отменять резервы в ресторанах, подключённых к системе GuestMe.

Подтверждение номера телефона​

Номер телефона резерва обязательно должен быть валидным по формату, его можно проверить на валидность библиотекой Google libphonenumber

Некоторые рестораны могут требовать обязательное подтверждение номера телефона гостя перед созданием резерва. Эта настройка регулируется полем properties.phoneConfirmationEnabled в объекте ресторана.

{
  "properties": {
    "phoneConfirmationEnabled": true
  }
}

Значение:

  • true - ресторан требует подтверждения номера телефона перед созданием резерва.
  • false - подтверждение номера телефона не требуется.

Логика применения​

  • Если phoneConfirmationEnabled = true:

  • Все новые резервы должны содержать подтвержденный номер телефона гостя.

  • Партнёр обязан выполнить проверку телефона одним из способов:

    1. Использовать шлюз ресторана через API интеграции GuestMe для подтверждения номера.
      • Запросить код подтверждения
      • Запросить проверку кода подтверждения
    2. Использовать собственную систему подтверждения телефонов (повторная проверка через шлюз не нужна).

  • Если phoneConfirmationEnabled = false:

  • Подтверждение номера телефона не требуется.

  • Партнёр может передавать номер без дополнительной проверки.

Ограничения, связанные с датой бронирования​

  1. Запрос на бронирование может быть выполнен только в ресторан с настроенным расписанием:
    • ScheduleType.RESTAURANT - базовое расписание работы ресторана (обязательно).
    • ScheduleType.BOOKING - расписание приёма резервов (необязательно, но, если есть, проверка ведётся по нему).
  2. Время резерва должно попадать в указанные интервалы расписания.
  3. Резерв не может быть создан на прошедшее время (по локальному времени ресторана).

Если ресторан не имеет подходящего расписания или время резерва не попадает в него, бронирование будет отклонено.

Ограничения по отмене резерва​

  • Отмена резерва возможна только для резервов в статусе:
  • CREATED
  • SENT

Попытка отмены в любом другом статусе вернёт ошибку booking_incompatible_state

Ограничения по номеру телефона​

  • На один номер телефона можно создать только одну активную бронь в одном ресторане.
  • При попытке создать вторую бронь будет возвращена ошибка: guest_have_not_closed_booking

Нужна помощь? Написать в поддержку