Ostrovok: различия между версиями
(Полностью удалено содержимое страницы) |
|||
Строка 1: | Строка 1: | ||
+ | '''Ostrovok''' — [[Файл:Ostrovok.png|right|400px|ContentInn.jpg]] это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру. | ||
+ | == Подключение к Ostrovok== | ||
+ | Для подключения модуля [[Отели]] системы {{NameSystem}}, работающего с системой Ostrovok, клиенту необходимо обратиться в [https://partner.ostrovok.ru/affiliate/ Ostrovok.ru] за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel], предоставив данные реквизиты (key_id, key). | ||
+ | |||
+ | {{Attention| Подключение и настройка реквизитов подключения к поставщику для модуля «Отели 2.0» производится администратором системы {{NameSystem}}.}} | ||
+ | |||
+ | == Особенности работы с Ostrovok== | ||
+ | |||
+ | Поставщик Ostrovok имеет следующие особенности: | ||
+ | |||
+ | * Поддерживается поиск только одной комнаты в запросе | ||
+ | * В комнате может быть не более 6 взрослых, но не менее одного, и не более 4 детей | ||
+ | * Возраст ребенка не должен превышать 17 лет | ||
+ | * Возраст детей при поиске указывать обязательно | ||
+ | * При подтверждении бронирования поставщику передается IP-адрес конечного пользователя | ||
+ | * При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента | ||
+ | * Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде | ||
+ | |||
+ | При работе в тестовой среде накладываются дополнительные ограничения | ||
+ | |||
+ | * Фамилии всех гостей должны быть Ostrovok | ||
+ | * Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск) | ||
+ | * Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять '''все''' тестовые бронирования. | ||
+ | |||
+ | == Возможные ошибки == | ||
+ | === При поиске === | ||
+ | {| 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== | ||
+ | |||
+ | Ostrovok поддерживает большое количество валют разных стран, в число которых входит 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> | ||
+ | == См. также == | ||
+ | |||
+ | * [[Отели]] | ||
+ | * [[Бронирование]] | ||
+ | * [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]] |
Версия 16:24, 1 октября 2018
Ostrovok —
это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.
Содержание
Подключение к Ostrovok
Для подключения модуля Отели системы Nemo.Travel, работающего с системой Ostrovok, клиенту необходимо обратиться в Ostrovok.ru за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере helpdesk.nemo.travel, предоставив данные реквизиты (key_id, key).
Внимание! Подключение и настройка реквизитов подключения к поставщику для модуля «Отели 2.0» производится администратором системы Nemo.Travel.
Особенности работы с Ostrovok
Поставщик Ostrovok имеет следующие особенности:
- Поддерживается поиск только одной комнаты в запросе
- В комнате может быть не более 6 взрослых, но не менее одного, и не более 4 детей
- Возраст ребенка не должен превышать 17 лет
- Возраст детей при поиске указывать обязательно
- При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
- При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
- Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде
При работе в тестовой среде накладываются дополнительные ограничения
- Фамилии всех гостей должны быть Ostrovok
- Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
- Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять все тестовые бронирования.
Возможные ошибки
При поиске
Ошибка | Описание |
---|---|
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
Ostrovok поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)