Ostrovok
Ostrovok.ru —
это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.
Содержание
Подключение к Ostrovok.ru
- Обратитесь в Ostrovok.ru за реквизитами подключения:
- ID ключа,
- Тип ключа,
- API ключ,
- список Endpoint URI с лимитами запросов.
- Приложите полученные реквизиты к заявке на подключение модуля Отели в проектном трекере helpdesk.nemo.travel.
Внимание! Подключение и настройка реквизитов подключения к данному поставщику для компонента «Отели 2.0» производится администратором системы Nemo.Travel.
Внимание! Если в настройках реквизита задана Электронная почта пользователя для бронирования отеля , то заданный адрес будет передаваться поставщику при подтверждении бронирования, вместо почты, указанной на этапе бронирования.
Особенности работы с Ostrovok.ru
Поставщик Ostrovok.ru имеет следующие особенности:
- Поддерживается поиск только одной комнаты в запросе
- В комнате может быть не более 6 взрослых, но не менее одного, и не более 4 детей
- Возраст ребенка не должен превышать 17 лет
- Возраст детей при поиске указывать обязательно
- При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
- При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
- Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде
- Внимание! В связи с особенностью поставщика, характеризующейся довольно обширной выдачей , особенно для крупных городов (например, Москва, Санкт-Петербург, Париж, Лондон и другие), время выполнения поисковых запросов может длиться до двух минут.
При работе в тестовой среде накладываются дополнительные ограничения
- Фамилии всех гостей должны быть Ostrovok
- Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
- Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять все тестовые бронирования.
- Внимание! для корректного отображения места расположения отеля на карте настоятельно рекомендуется получить и внести API ключ для доступа к сервису Google Maps в разделе настроек Управление сайтом → Домены и протоколы, настройка «API GOOGLE MAP ключ»; а также "Ключ для Google Maps API" в разделе Настройка системы → Интеграция → Nemo1.0(JSON API).
Возможные ошибки
При поиске
| Ошибка | Описание |
|---|---|
| Search for multiple rooms is not supported by Ostrovok | Попытка поиска по нескольким комнатам. Не поддерживается поставщиком |
| Check out date must be within 30 days after check in | Дата выезда должна быть не позднее 30 дней от даты заезда |
| In a room must be at least 1 adult | В комнате должен присутствовать как минимум один взрослый |
| Maximum number of adults in room is 6 | В комнате должно быть не более 6 взрослых |
| Maximum number of children in room is 4 | В комнате должно быть не более 4 детей |
| Only guests 17 years old or younger are considered to be children | Возраст ребенка не может превышать 17 лет |
При бронировании
| Ошибка | Описание |
|---|---|
| Email is required for booking | Для бронирования необходим адрес электронной почты клиента |
| Phone number is required for booking | Для бронирования необходим номер телефона клиента |
| Guest name is not valid | Имя или фамилия гостя некорректны. Имя должно состоять из латинских и кириллических символов, может содержать пробелы, точки и тире |
| cannot_reserve_via_api | Вы не можете бронировать через API. Обратитесь в техническую поддержку |
| credit_card_required | Для бронирования нужны данные кредитной карты |
| insufficient_b2b_balance | Недостаточно средств на балансе b2b бронирований |
| invalid_email | Недействительный email. Необходимо использовать настоящий адрес |
| luhn_algorithm_error | Карта не прошла проверку по алгоритму Луна (алгоритм валидации номера карты по контрольной сумме) |
| rate_expired / rate_not_found | Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск |
Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
| Ошибка | Описание |
|---|---|
| not_allowed | Попытка(и) бронирования заблокирована(ы). При возникновении данной ошибки, следует обратиться в службу поддержки, уточнив, что возникает ошибка при попытке бронирования |
| soldout | Тариф более недоступен на момент попытки бронирования, т.к. был распродан |
| provider | Техническая ошибка у источника тарифа |
| bank | Банк отменил транзакцию |
| block / charge | Ошибка авторизации карты |
| amount_exceed_balance | Недостаточно средств |
| 3ds | Невалидный 3ds код |
При аннуляции
| Ошибка | Описание |
|---|---|
| cancellation_unavailable_status | Некорректный статус бронирования. Можно отменить только бронирования со статусом Booked, New или Confirmed |
| cancellation_error_policy | Нарушение политики отмены |
| cancellation_error_provider | Ошибка провайдера. Свяжитесь со службой технической поддержки |
| cancellation_error_unknown | Внутренняя ошибка поставщика |
Поддержка валют в Ostrovok.ru
Ostrovok.ru поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)
