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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Полностью удалено содержимое страницы)
м
(не показано 8 промежуточных версий 6 участников)
Строка 1: Строка 1:
 +
[[Категория:Поставщики наземных услуг]]
 +
'''Ostrovok.ru''' — [[Файл:Ostrovok.png|right|400px|ContentInn.jpg]] это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.
  
 +
== Подключение к Ostrovok.ru==
 +
Для подключения компонента [[Отели]] системы {{NameSystem}}, работающего с системой Ostrovok.ru, клиенту необходимо обратиться в [https://partner.ostrovok.ru/affiliate/ Ostrovok.ru] за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel], предоставив данные реквизиты (key_id, key).
 +
 +
{{Attention| Подключение и настройка реквизитов подключения к данному поставщику для компонента «Отели 2.0» производится администратором системы {{NameSystem}}.}}
 +
 +
{{Attention| Если в настройках реквизита задана '''Электронная почта пользователя для бронирования отеля''' , то заданный адрес будет передаваться поставщику при подтверждении бронирования, вместо почты, указанной на этапе бронирования.}}
 +
 +
== Особенности работы с Ostrovok.ru==
 +
 +
Поставщик Ostrovok.ru имеет следующие особенности:
 +
 +
* Поддерживается поиск только одной комнаты в запросе
 +
* В комнате может быть не более 6 взрослых, но не менее одного, и не более 4 детей
 +
* Возраст ребенка не должен превышать 17 лет
 +
* Возраст детей при поиске указывать обязательно
 +
* При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
 +
* При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
 +
* Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде
 +
* {{Attention|В связи с особенностью поставщика, характеризующейся довольно обширной выдачей , особенно для крупных городов (например, Москва, Санкт-Петербург, Париж, Лондон и другие), время выполнения поисковых запросов может длиться до двух минут.}}
 +
 +
При работе в тестовой среде накладываются дополнительные ограничения
 +
 +
* Фамилии всех гостей должны быть Ostrovok
 +
* Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
 +
* Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять '''все''' тестовые бронирования.
 +
 +
* {{Attention|для корректного отображения места расположения отеля на карте настоятельно рекомендуется получить и внести API ключ для доступа к сервису Google Maps в разделе настроек '''Управление сайтом → Домены и протоколы''', настройка «API GOOGLE MAP ключ»; а также "Ключ для Google Maps API" в разделе '''Настройка системы → Интеграция → Nemo1.0(JSON API)'''.}}
 +
 +
== Возможные ошибки ==
 +
=== При поиске ===
 +
{| class="wikitable"
 +
! Ошибка                                                            !! Описание
 +
|-
 +
| 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 лет
 +
|}
 +
=== При бронировании ===
 +
{| class="wikitable"
 +
! Ошибка                                    !! Описание                                                                                                         
 +
|-
 +
| 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              || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск
 +
<!--|-
 +
| validation / validation_invalid_params    || Входные данные в теле запроса не удовлетворяют требованиям
 +
|-
 +
| unexpected_error_status_unknown            || Внутренняя ошибка поставщика. Статус бронирования в таком случае не определен. Необходимо выполнить запрос GetBook
 +
|-
 +
| order_not_found (в процессе подтверждения) || Бронирование не было создано у поставщика, необходимо повторить запрос ConfirmBook-->
 +
|}
 +
 +
<!--Другие непредвиденные ошибки (например, сетевые), также будут отражены в ответе. Статус бронирования в таком случае сменится на Waiting, необходимо выполнить запрос GetBook.-->
 +
 +
Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
 +
{| class="wikitable"
 +
! Ошибка                !! Описание
 +
|-
 +
| not_allowed          || Попытка(и) бронирования заблокирована(ы). При возникновении данной ошибки, следует обратиться в службу поддержки, уточнив, что возникает ошибка при попытке бронирования
 +
|-
 +
| soldout              || Тариф более недоступен на момент попытки бронирования, т.к. был распродан
 +
|-
 +
| provider              || Техническая ошибка у источника тарифа
 +
|-
 +
| bank                  || Банк отменил транзакцию
 +
|-
 +
| block / charge        || Ошибка авторизации карты
 +
|-
 +
| amount_exceed_balance || Недостаточно средств
 +
|-
 +
| 3ds                  || Невалидный 3ds код
 +
|}
 +
=== При аннуляции ===
 +
{| class="wikitable"
 +
! Ошибка                          !! Описание
 +
|-
 +
| cancellation_unavailable_status || Некорректный статус бронирования. Можно отменить только бронирования со статусом Booked, New или Confirmed
 +
|-
 +
| cancellation_error_policy      || Нарушение политики отмены
 +
|-
 +
| cancellation_error_provider    || Ошибка провайдера. Свяжитесь со службой технической поддержки
 +
|-
 +
| cancellation_error_unknown      || Внутренняя ошибка поставщика
 +
|}
 +
 +
== Поддержка валют в Ostrovok.ru==
 +
 +
Ostrovok.ru поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
 +
=== Полный список ===
 +
<div class="mw-collapsible-content">
 +
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
 +
</div>
 +
</div>
 +
== См. также ==
 +
 +
* [[Отели]]
 +
* [[Бронирование]]
 +
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

Версия 12:28, 2 октября 2020

Ostrovok.ru

ContentInn.jpg

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

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

Для подключения компонента Отели системы Nemo.Travel, работающего с системой Ostrovok.ru, клиенту необходимо обратиться в Ostrovok.ru за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере helpdesk.nemo.travel, предоставив данные реквизиты (key_id, key).

Внимание! Подключение и настройка реквизитов подключения к данному поставщику для компонента «Отели 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

См. также