Ostrovok
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 | Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск |
| validation / validation_invalid_params | Входные данные в теле запроса не удовлетворяют требованиям |
| unexpected_error_status_unknown | Внутренняя ошибка поставщика. Статус бронирования в таком случае не определен. Необходимо выполнить запрос GetBook |
| order_not_found (в процессе подтверждения) | Бронирование не было создано у поставщика, необходимо повторить запрос ConfirmBook |
Другие непредвиденные ошибки (например, сетевые), также будут отражены в ответе. Статус бронирования в таком случае сменится на Waiting, необходимо выполнить запрос GetBook.
Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
| Ошибка | Описание |
|---|---|
| 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 (австралийский доллар)
Полный список
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