ПОДПИСЫВАЙТЕСЬ НА НАШ ТЕЛЕГРАМ-КАНАЛ @nemo_travel_official

Агентский API Отели: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Ответ)
(→‎Запрос)
Строка 1673: Строка 1673:
 
== Аннуляция заказа ==
 
== Аннуляция заказа ==
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
 +
<div class="mw-collapsible-content">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
Строка 1727: Строка 1729:
 
| Латинские буквы и цифры. Всего 32 символа.
 
| Латинские буквы и цифры. Всего 32 символа.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ответ ====
 
==== Ответ ====

Версия 13:08, 8 марта 2014

Nemo-logo.png

Агентский API Отелей - система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.

Динамические данные

Поиск

Сервис предназначен для получения списка отелей, удовлетворяющих условиям запроса. В условия запроса входят: идентификатор города, где будет вестись поиск; дата заезда и дата выезда; информация о количестве людей и способе их размещения в комнатах. Так же указываются дополнительные необязательные поля фильтров.

Для получения списка доступных городов, воспользуйтесь запросом на выгрузку статики (см. ССЫЛКА). Список допустимых отелей для фильтра также доступен через сервис (см. ССЫЛКА). Рекомендуется выгрузить все данные по отелям, городам и странам в локальную базу, для экономии времени и запросов.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch

развернуть

Запрос

развернуть

Ответ

Ошибки

Расширенная информация по одному отелю

Сервис получения дополнительной информации об отеле требует указания идентификатора отеля в системе Nemo и категории.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo

развернуть

Запрос

развернуть

Ответ

Ошибки

Штрафы за аннуляцию

Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.

Штрафы получаются по каждой услуге отдельным запросом. Нужно указать тип услуги, идентификатор результата поиска и выбранную категорию.

Внимание. Для отелей из Hotelbeds (Supplier=HOTELBEDS) штрафы до бронирования получить невозможно.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty

развернуть

Запрос

развернуть

Ответ

Ошибки

Бронирование

развернуть

Запрос

развернуть

Ответ

Ошибки

Подтверждение бронирования

развернуть

Запрос

развернуть

Ответ

Ошибки

Выгрузка актуальных данных по заказу(ам)

Используется для экспорта бронирований и для обновления данных в локальной клиентской базе.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Export

развернуть

Запрос

развернуть

Ответ

Ошибки

Аннуляция заказа

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking

развернуть

Запрос

Ответ

см. результаты бронирования.

Ошибки

  • You can cancel only booked order - возникает при попытке аннулировать незабронированный заказ.
  • Invalid Booking Id N - заказ с номером N отсутствует.

Статические данные

Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.

Страна

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStatic

Запрос

 1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic">
 3    <soapenv:Header/>
 4    <soapenv:Body>
 5       <ver:countries>
 6          <RequestBin>
 7             <Request>
 8                <CountryStatic>
 9                </CountryStatic>
10             </Request>
11             <Source>
12                <ClientId></ClientId>
13                <APIKey></APIKey>
14                <Language>ru</Language>
15                <Currency>RUB</Currency>
16             </Source>
17          </RequestBin>
18       </ver:countries>
19    </soapenv:Body>
20 </soapenv:Envelope>

Элемент Request

Элемент Описание Допустимые значения
CountryStatic Пустой элемент

Элемент Source

Элемент Описание Допустимые значения
ClientID Обязательный. ID клиента в системе Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Целое число.
APIKey Обязательный. APIKey - секретный ключ доступа к API Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Латинские буквы и цифры. Всего 32 символа.

Ответ

 1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic" 
 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 4    <SOAP-ENV:Body>
 5       <ns1:countriesResponse>
 6          <ResponseBin>
 7             <Response>
 8                <CountryStatic>
 9                   <Countries>
10                      <Country Id="4">
11                         <Code>AF</Code>
12                         <Continent>asia</Continent>
13                         <Data>
14                            <Info Language="RU">
15                               <Name>Афганистан</Name>
16                            </Info>
17                            <Info Language="EN">
18                               <Name>Afghanistan</Name>
19                            </Info>
20                         </Data>
21                      </Country>			
22                   </Countries>
23                </CountryStatic>
24             </Response>
25          </ResponseBin>
26       </ns1:countriesResponse>
27    </SOAP-ENV:Body>
28 </SOAP-ENV:Envelope>

Элемент CountryStatic

Элемент Описание Допустимые значения
Countries Обязательный Набор элементов Country

Элемент Country

Элемент Описание Допустимые значения
Атрибут Id Обязательный. Идентификатор страны (ISO). Целое число
Code Обязательный. Код страны ISO. Строка из 2-х латинских букв
Continent Обязательный. Название континента. Строка.
Data Обязательный. Информация требующая перевода. Набор элементов Info.

Элемент Info

Элемент Описание Допустимые значения
Атрибут Language Обязательный. Язык в котором представлена информация. Строка из 2-х латинских букв.
Name Обязательный. Наименование страны. Строка в произвольном формате.

Ошибки

Город

Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом:

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CityStatic

Запрос

 1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
 3    <soapenv:Header/>
 4    <soapenv:Body>
 5       <ver:cities>
 6          <RequestBin>
 7             <Request>
 8                <CityStatic>
 9                   <CountryId>4</CountryId>
10                </CityStatic>
11             </Request>
12             <Source>
13                <ClientId></ClientId>
14                <APIKey></APIKey>
15                <Language>ru</Language>
16                <Currency>RUB</Currency>
17             </Source>
18          </RequestBin>
19       </ver:cities>
20    </soapenv:Body>
21 </soapenv:Envelope>

Элемент CityStatic

Элемент Описание Допустимые значения
CountryId Обязательный. Идентификатор страны. Целое число

Элемент Source

Элемент Описание Допустимые значения
ClientID Обязательный. ID клиента в системе Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Целое число.
APIKey Обязательный. APIKey - секретный ключ доступа к API Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Латинские буквы и цифры. Всего 32 символа.

Ответ

 1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
 3    <SOAP-ENV:Body>
 4       <ns1:citiesResponse>
 5          <ResponseBin>
 6             <Response>
 7                <CityStatic>
 8                   <Cities>
 9                      <City Id="1">
10                         <Name>Кабул</Name>
11                         <CountryId>4</CountryId>
12                         <Data>
13                            <Info Language="EN">
14                               <Name>Kabul</Name>
15                            </Info>
16                            <Info Language="RU">
17                               <Name>Кабул</Name>
18                            </Info>
19                         </Data>
20                      </City>
21                      <City Id="204793">
22                         <Name>Aibak</Name>
23                         <CountryId>4</CountryId>
24                         <Data>
25                            <Info Language="EN">
26                               <Name>Aibak</Name>
27                            </Info>
28                            <Info Language="RU">
29                               <Name>Aibak</Name>
30                            </Info>
31                         </Data>
32                      </City>
33                      <City Id="204785">
34                         <Name>Anar Darah</Name>
35                         <CountryId>4</CountryId>
36                         <Data>
37                            <Info Language="EN">
38                               <Name>Anar Darah</Name>
39                            </Info>
40                            <Info Language="RU">
41                               <Name>Anar Darah</Name>
42                            </Info>
43                         </Data>
44                      </City>
45 			...
46                   </Cities>
47                </CityStatic>
48             </Response>
49          </ResponseBin>
50       </ns1:citiesResponse>
51    </SOAP-ENV:Body>
52 </SOAP-ENV:Envelope>

Элемент CityStatic

Элемент Описание Допустимые значения
Cities Обязательный. Массив городов. Набор элементов City

Элемент City

Элемент Описание Допустимые значения
Атрибут Id Обязательный. Идентификатор города. Целое число
Name Название города.
Data Названия городов на разных языках. В данный момент поддерживаются названия на русском и английском. См. описание элемента Data в ответе получения информации о стране.

Ошибки

Статика по отелям и апартаментам

Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStatic

Запрос

 1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic">
 3    <soapenv:Header/>
 4    <soapenv:Body>
 5       <ver:hotels>
 6          <RequestBin>
 7             <Request>
 8                <HotelStatic>
 9                   <CityId>58166</CityId>
10                </HotelStatic>
11             </Request>
12             <Source>
13                <ClientId></ClientId>
14                <APIKey></APIKey>
15                <Language>ru</Language>
16                <Currency>RUB</Currency>
17             </Source>
18          </RequestBin>
19       </ver:hotels>
20    </soapenv:Body>
21 </soapenv:Envelope>

Элемент Hotels

Элемент Описание Допустимые значения
CityId Обязательный. Идентификатор города из которого необходимо получить отели. Целое число

Элемент Source

Элемент Описание Допустимые значения
ClientID Обязательный. ID клиента в системе Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Целое число.
APIKey Обязательный. APIKey - секретный ключ доступа к API Nemo.

Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".

Латинские буквы и цифры. Всего 32 символа.

Ответ

 1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
 2 xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" 
 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 4    <SOAP-ENV:Body>
 5       <ns1:hotelsResponse>
 6          <ResponseBin>
 7             <Response>
 8                <HotelStatic>
 9                   <Hotels>
10                      <Hotel Id="271714" Apartment="false">
11                         <CityId>58166</CityId>
12                         <CountryId>643</CountryId>
13                         <Latitude xsi:nil="true"/>
14                         <Longitude xsi:nil="true"/>
15                         <Rating>3</Rating>
16                         <Floors xsi:nil="true"/>
17                         <Data>
18                            <Info>
19                               <Name>* Azimut (business)</Name>
20                               <Area xsi:nil="true"/>
21                               <Location>Within city</Location>
22                               <Desc>This 3 star hotel is located within the city of St Petersburg.</Desc>
23                               <Address>43/1 Lermoutovsky Prospect, St Petersburg, 190103</Address>
24                            </Info>
25                         </Data>
26                         <Phones>
27                            <Phone>812 7402640</Phone>
28                         </Phones>
29                         <Fax>812 2518890</Fax>
30                         <Images/>
31                      </Hotel>
32                      <Hotel Id="159535" Apartment="false">
33                         <CityId>58166</CityId>
34                         <CountryId>643</CountryId>
35                         <Latitude>59.935011</Latitude>
36                         <Longitude>30.309284</Longitude>
37                         <Rating>5</Rating>
38                         <Floors xsi:nil="true"/>
39                         <Data>
40                            <Info>
41                               <Name>W St.petersburg</Name>
42                               <Area xsi:nil="true"/>
43                               <Location>City centre</Location>
44                               <Desc>This 5 star hotel is located in the city centre of St Petersburg 
45                                     and was established in 2011. It is close to the St.Isaac's Cathedral 
46                                     and the nearest station is Admiralteyskaya station. The Hotel has 
47                                     a restaurant, 2 bars, a conference room, a coffee shop, an indoor 
48                                     swimming pool and a fitness centre/gym. All 137 rooms are equipped 
49                                     with minibar, hairdryer, safe, trouser press and air conditioning.</Desc>
50                               <Address>6 Voznesensky Prospect, St. Petersburg, 190000, St Petersburg, Russia</Address>
51                            </Info>
52                         </Data>
53                         <Phones/>
54                         <Fax>+7 812 6106160</Fax>
55                         <Images>
56                            <Image>
57                               <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/ext.jpg</Path>
58                               <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/ext-t.jpg</Icon>
59                            </Image>
60                            <Image>
61                               <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/unknown.jpg</Path>
62                               <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/unknown-t.jpg</Icon>
63                            </Image>
64                            <Image>
65                               <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/bed room.jpg</Path>
66                               <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/bed room-t.jpg</Icon>
67                            </Image>
68                         </Images>
69                      </Hotel>			
70                      ...
71                   </Hotels>
72                </HotelStatic>
73             </Response>
74          </ResponseBin>
75       </ns1:hotelsResponse>
76    </SOAP-ENV:Body>
77 </SOAP-ENV:Envelope>

Элемент Hotel

Элемент Описание Допустимые значения
Атрибут Id Обязательный. Идентификатор отеля в системе Nemo. Целое число.
CityId Обязательный. Идентификатор города. Целое число.
CountryId Обязательный. Идентификатор страны . Целое число.
Latitude Необязательный. Широта. Вещественное число.
Longitude Необязательный. Долгота. Вещественное число.
Rating Необязательный. Рейтинг. Вещественное число.
Floors Необязательный. Количество этажей Целое число.
Data Необязательный. Набор элементов Info.
Phones Необязательный. Массив телефонов. Набор элементов Phone.
Fax Необязательный. Факс. Строка в произвольном формате.
Images Необязательный. Маcсив изображений. Набор элементов Image.

Элемент Info

Элемент Описание Допустимые значения
Name Обязательный. Наименование отеля. Строка в произвольном формате.
Area Необязательный. Описание места расположения отеля. Строка в произвольном формате.
Location Необязательный. Район города. Строка в произвольном формате.
Desc Необязательный. Описание отеля. Строка в произвольном формате.
Address Необязательный. Адрес отеля. Строка в произвольном формате.

Элемент Phones

Элемент Описание Допустимые значения
Phone Обязательный. Телефон. Строка в произвольном формате.

Элемент Image

Элемент Описание Допустимые значения
Path Необязательный. Путь к полному изображению. Строка в произвольном формате.
Icon Необязательный. Путь к миниатюре, иконке. Строка в произвольном формате.

Ошибки

Источник — https://support.nemo.travel/index.php?title=Агентский_API_Отели&oldid=5421