Центр поддержки системы бронирования - Вклад участника [ru]

Ostrovok

2018-07-16T14:36:18Z

Палашевский Денис: /* При аннуляции */

'''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>
== См. также ==

* [[Отели]]
* [[Бронирование]]
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

== Полезные ссылки ==

Ostrovok

2018-07-16T14:31:18Z

Палашевский Денис: Расписал особенности и ошибки

'''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 код
|}
=== При аннуляции ===

== Поддержка валют в 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>
== См. также ==

* [[Отели]]
* [[Бронирование]]
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

== Полезные ссылки ==