Ostrovok: различия между версиями
| Строка 58: | Строка 58: | ||
| invalid_email || Недействительный email. Необходимо использовать настоящий адрес | | invalid_email || Недействительный email. Необходимо использовать настоящий адрес | ||
|- | |- | ||
| − | | luhn_algorithm_error || Карта не прошла проверку по алгоритму Луна | + | | luhn_algorithm_error || Карта не прошла проверку по алгоритму Луна (алгоритм валидации номера карты по контрольной сумме) |
|- | |- | ||
| rate_expired / rate_not_found || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск | | rate_expired / rate_not_found || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск | ||
Версия 17:14, 23 июля 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 | Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск |
| 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 (австралийский доллар)
