Ostrovok: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Подключение к Ostrovok.ru)
 
(не показано 11 промежуточных версий 7 участников)
Строка 1: Строка 1:
−
'''Ostrovok''' — [[Файл:Ostrovok.png|right|400px|ContentInn.jpg]] это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.
+
[[Категория:Поставщики наземных услуг]]
 +
'''Ostrovok.ru''' — [[Файл:Ostrovok.png|right|400px|ContentInn.jpg]] это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.
  
−
== Подключение к Ostrovok==
+
== Подключение к Ostrovok.ru ==
−
Для подключения модуля [[Отели]] системы {{NameSystem}}, работающего с системой Ostrovok, клиенту необходимо обратиться в [https://partner.ostrovok.ru/affiliate/ Ostrovok.ru] за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel], предоставив данные реквизиты (key_id, key).  
+
# Обратитесь в [https://partner.ostrovok.ru/affiliate/ Ostrovok.ru] за реквизитами подключения:   
 +
#* ID ключа,   
 +
#* Тип ключа,   
 +
#* API ключ,   
 +
#* список Endpoint URI с лимитами запросов.  
 +
# Приложите полученные реквизиты к заявке на подключение модуля '''Отели''' в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel].  
  
−
{{Attention| Подключение и настройка реквизитов подключения к поставщику для модуля «Отели 2.0» производится администратором системы {{NameSystem}}.}}
+
{{Attention| Подключение и настройка реквизитов подключения к данному поставщику для компонента «Отели 2.0» производится администратором системы {{NameSystem}}.}}
  
−
== Особенности работы с Ostrovok==
+
{{Attention| Если в настройках реквизита задана '''Электронная почта пользователя для бронирования отеля''' , то заданный адрес будет передаваться поставщику при подтверждении бронирования, вместо почты, указанной на этапе бронирования.}}
  
−
Поставщик Ostrovok имеет следующие особенности:
+
== Особенности работы с Ostrovok.ru==
 +
 
 +
Поставщик Ostrovok.ru имеет следующие особенности:
  
 
* Поддерживается поиск только одной комнаты в запросе
 
* Поддерживается поиск только одной комнаты в запросе
Строка 16: Строка 24:
 
* При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
 
* При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
 
* При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
 
* При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
 +
* Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде
 +
* {{Attention|В связи с особенностью поставщика, характеризующейся довольно обширной выдачей , особенно для крупных городов (например, Москва, Санкт-Петербург, Париж, Лондон и другие), время выполнения поисковых запросов может длиться до двух минут.}}
  
 
При работе в тестовой среде накладываются дополнительные ограничения
 
При работе в тестовой среде накладываются дополнительные ограничения
Строка 22: Строка 32:
 
* Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
 
* Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
 
* Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять '''все''' тестовые бронирования.
 
* Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять '''все''' тестовые бронирования.
 +
 +
* {{Attention|для корректного отображения места расположения отеля на карте настоятельно рекомендуется получить и внести API ключ для доступа к сервису Google Maps в разделе настроек '''Управление сайтом → Домены и протоколы''', настройка «API GOOGLE MAP ключ»; а также "Ключ для Google Maps API" в разделе '''Настройка системы → Интеграция → Nemo1.0(JSON API)'''.}}
  
 
== Возможные ошибки ==
 
== Возможные ошибки ==
Строка 48: Строка 60:
 
| Phone number is required for booking      || Для бронирования необходим номер телефона клиента
 
| Phone number is required for booking      || Для бронирования необходим номер телефона клиента
 
|-
 
|-
−
| Guest name is not valid                    || Имя или фамилия гостя некорректны. Имя должно состоять из латинских букв и может содерждать пробелы, точки и тире
+
| Guest name is not valid                    || Имя или фамилия гостя некорректны. Имя должно состоять из латинских и кириллических символов, может содержать пробелы, точки и тире
 
|-
 
|-
 
| cannot_reserve_via_api                    || Вы не можете бронировать через API. Обратитесь в техническую поддержку
 
| cannot_reserve_via_api                    || Вы не можете бронировать через API. Обратитесь в техническую поддержку
Строка 58: Строка 70:
 
| invalid_email                              || Недействительный email. Необходимо использовать настоящий адрес
 
| invalid_email                              || Недействительный email. Необходимо использовать настоящий адрес
 
|-
 
|-
−
| luhn_algorithm_error                      || Карта не прошла проверку по алгоритму Луна
+
| luhn_algorithm_error                      || Карта не прошла проверку по алгоритму Луна (алгоритм валидации номера карты по контрольной сумме)
 
|-
 
|-
 
| rate_expired / rate_not_found              || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск
 
| rate_expired / rate_not_found              || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск
−
|-
+
<!--|-
 
| validation / validation_invalid_params    || Входные данные в теле запроса не удовлетворяют требованиям
 
| validation / validation_invalid_params    || Входные данные в теле запроса не удовлетворяют требованиям
 
|-
 
|-
 
| unexpected_error_status_unknown            || Внутренняя ошибка поставщика. Статус бронирования в таком случае не определен. Необходимо выполнить запрос GetBook
 
| unexpected_error_status_unknown            || Внутренняя ошибка поставщика. Статус бронирования в таком случае не определен. Необходимо выполнить запрос GetBook
 
|-
 
|-
−
| order_not_found (в процессе подтверждения) || Бронирование не было создано у поставщика, необходимо повторить запрос ConfirmBook
+
| order_not_found (в процессе подтверждения) || Бронирование не было создано у поставщика, необходимо повторить запрос ConfirmBook-->
 
|}
 
|}
  
−
Другие непредвиденные ошибки (например, сетевые), также будут отражены в ответе. Статус бронирования в таком случае сменится на Waiting, необходимо выполнить запрос GetBook.
+
<!--Другие непредвиденные ошибки (например, сетевые), также будут отражены в ответе. Статус бронирования в таком случае сменится на Waiting, необходимо выполнить запрос GetBook.-->
  
 
Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
 
Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
Строка 102: Строка 114:
 
|}
 
|}
  
−
== Поддержка валют в Ostrovok==
+
== Поддержка валют в Ostrovok.ru==
  
−
Ostrovok поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)
+
Ostrovok.ru поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
 
=== Полный список ===
 
=== Полный список ===
Строка 122: Строка 134:
 
* [[Бронирование]]
 
* [[Бронирование]]
 
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]
 
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]
−
 
−
== Полезные ссылки ==
 

Текущая версия на 12:04, 18 декабря 2023

Ostrovok.ru —

ContentInn.jpg

это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.

Подключение к Ostrovok.ru

  1. Обратитесь в Ostrovok.ru за реквизитами подключения:
    • ID ключа,
    • Тип ключа,
    • API ключ,
    • список Endpoint URI с лимитами запросов.
  2. Приложите полученные реквизиты к заявке на подключение модуля Отели в проектном трекере 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 (австралийский доллар)

Полный список

AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BYR, BZD, CAD, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SLL, SOS, SRD, STD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW

См. также

Источник — https://support.nemo.travel/index.php?title=Ostrovok&oldid=17832