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

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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Запрос)
 
(не показано 98 промежуточных версий 5 участников)
Строка 1: Строка 1:
 +
{{Attention|В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по [http://docs.nemo.travel/ ссылке]}}
 +
 +
[[Категория:Агентский API]]
 +
[[Категория:Интеграция]]
 
[[Файл:Nemo-logo.png‎|right]]
 
[[Файл:Nemo-logo.png‎|right]]
'''Агентский API Отелей''' - система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.
+
'''Агентский API Отели''' система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.
  
== Динамические данные ==
+
= Динамические данные =
=== Поиск ===
+
== Поиск ==
  
 
Сервис предназначен для получения списка отелей, удовлетворяющих условиям запроса. В условия запроса входят: идентификатор города, где будет вестись поиск; дата заезда и дата выезда; информация о количестве людей и способе их размещения в комнатах. Так же указываются дополнительные необязательные поля фильтров.
 
Сервис предназначен для получения списка отелей, удовлетворяющих условиям запроса. В условия запроса входят: идентификатор города, где будет вестись поиск; дата заезда и дата выезда; информация о количестве людей и способе их размещения в комнатах. Так же указываются дополнительные необязательные поля фильтров.
Строка 9: Строка 13:
 
Для получения списка доступных городов, воспользуйтесь запросом на выгрузку статики (см. ССЫЛКА). Список допустимых отелей для фильтра также доступен через сервис (см. ССЫЛКА). Рекомендуется выгрузить все данные по отелям, городам и странам в локальную базу, для экономии времени и запросов.
 
Для получения списка доступных городов, воспользуйтесь запросом на выгрузку статики (см. ССЫЛКА). Список допустимых отелей для фильтра также доступен через сервис (см. ССЫЛКА). Рекомендуется выгрузить все данные по отелям, городам и странам в локальную базу, для экономии времени и запросов.
  
WSDL (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch]
+
'''WSDL''' (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch]
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
<pre><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
+
<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;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 28: Строка 36:
 
                   <!--Zero or more repetitions:-->
 
                   <!--Zero or more repetitions:-->
 
                   <Person Id="1" Type="ADT" Age="30"/>
 
                   <Person Id="1" Type="ADT" Age="30"/>
                   <Person Id="1" Type="CLD" Age="10"/>
+
                   <Person Id="2" Type="CLD" Age="10"/>
 
                 </Persons>
 
                 </Persons>
 
                 <!--Optional:-->
 
                 <!--Optional:-->
Строка 59: Строка 67:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
 
Элемент '''HotelSearch'''
 
Элемент '''HotelSearch'''
Строка 89: Строка 97:
 
|}
 
|}
  
Элемент Room.
+
Элемент '''Room'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 107: Строка 115:
 
|}
 
|}
  
Элемент Person.
+
Элемент '''Person'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 131: Строка 139:
 
|}
 
|}
  
Элемент Filters.
+
Элемент '''Filters'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 144: Строка 152:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
 
+
<div class="mw-collapsible-content">
 
Система по заданным параметрам ищет отели и возвращает результаты поиска. Все результаты поиска хранятся в базе Nemo определенный срок и доступны для бронирования по идентификатору CacheId.
 
Система по заданным параметрам ищет отели и возвращает результаты поиска. Все результаты поиска хранятся в базе Nemo определенный срок и доступны для бронирования по идентификатору CacheId.
  
Строка 151: Строка 180:
  
 
Каждый отель содержит:
 
Каждый отель содержит:
 +
* Набор номеров &lt;Rooms&gt;. Типы номеров (одноместный, двухместный и т.д.)&nbsp;: устанавливается автоматически по количеству клиентов из запроса.
 +
* Сервисы &lt;Services&gt;. Каждый отель предлагает различные типы обслуживания в номерах. Цена и доступность может различаться.
 +
* Категория &lt;Categories&gt;. Это допустимые комбинации номер + обслуживание. Для бронирования отеля пользователь должен выбрать одну из предлагаемых ему категорий.
  
#Набор номеров &lt;Rooms&gt;. Типы номеров (одноместный, двухместный и т.д.)&nbsp;: устанавливается автоматически по количеству клиентов из запроса.
+
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
#Сервисы &lt;Services&gt;. Каждый отель предлагает различные типы обслуживания в номерах. Цена и доступность может различаться.
+
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
#Категория &lt;Categories&gt;. Это допустимые комбинации номер + обслуживание. Для бронирования отеля пользователь должен выбрать одну из предлагаемых ему категорий.
+
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
<pre><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
 
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
     <ns1:searchResponse>
 
     <ns1:searchResponse>
Строка 196: Строка 227:
 
               </Hotel>
 
               </Hotel>
 
...
 
...
    </Hotels>
+
            </Hotels>
 
           </HotelSearch>
 
           </HotelSearch>
 
         </Response>
 
         </Response>
Строка 203: Строка 234:
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Hotel.
+
Элемент '''Hotel'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 254: Строка 285:
 
|}
 
|}
  
 
+
Элемент '''Service'''
Элемент Service.
 
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 285: Строка 315:
 
|}
 
|}
  
 
+
Элемент '''Room'''
Элемент Room.
 
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 307: Строка 336:
 
|}
 
|}
  
Элемент Category.
+
Элемент '''Category'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 346: Строка 375:
 
Атрибут Currency - код валюты.
 
Атрибут Currency - код валюты.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ошибки ====
 
==== Ошибки ====
  
=== Расширенная информация по одному отелю ===
+
== Расширенная информация по одному отелю ==
 
 
 
Сервис получения дополнительной информации об отеле требует указания идентификатора отеля в системе Nemo и категории.
 
Сервис получения дополнительной информации об отеле требует указания идентификатора отеля в системе Nemo и категории.
  
'''WSDL''' (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo]
+
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
<pre>
+
<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;">
 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
 
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo">
 
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo">
Строка 382: Строка 414:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Item.
+
Элемент '''Item'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 400: Строка 432:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
<pre><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
<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;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo"  
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
     <ns1:extInfoResponse>
 
     <ns1:extInfoResponse>
Строка 430: Строка 487:
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент HotelExtInfo.
+
Элемент '''HotelExtInfo'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 448: Строка 505:
 
|}
 
|}
  
 
+
Элемент '''PriceInfo'''
Элемент PriceInfo.
 
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 474: Строка 530:
 
|}
 
|}
  
Элемент Date
+
Элемент '''Date'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 494: Строка 550:
 
Атрибут Currency - код валюты.
 
Атрибут Currency - код валюты.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ошибки ====
 
==== Ошибки ====
  
=== Штрафы за аннуляцию ===
+
== Штрафы за аннуляцию ==
 +
 
 
Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.
 
Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.
  
Строка 506: Строка 565:
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
<pre><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
+
<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;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 522: Строка 585:
 
         </Request>
 
         </Request>
 
         <Source>
 
         <Source>
           <ClientId>134</ClientId>
+
           <ClientId></ClientId>
           <APIKey>93632C10DA299034C03D742FB160C2D6</APIKey>
+
           <APIKey></APIKey>
 
           <Language>ru</Language>
 
           <Language>ru</Language>
 
           <Currency>RUB</Currency>
 
           <Currency>RUB</Currency>
Строка 531: Строка 594:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Item.
+
Элемент '''Item'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 553: Строка 616:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
<pre><soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
+
<div class="mw-collapsible-content">
   <soap-env:body>
+
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
     <ns1:penaltyresponse>
+
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
       <responsebin>
+
   <SOAP-ENV:Body>
         <response>
+
     <ns1:penaltyResponse>
           <penalty>
+
       <ResponseBin>
             <itemdatebegin>2013-10-15 00:00:00</itemdatebegin>
+
         <Response>
             <cancelcharges>
+
           <Penalty>
               <charge>
+
             <ItemDateBegin>2013-10-15 00:00:00</ItemDateBegin>
                 <datefrom>2013-10-12 00:00:00</datefrom>
+
             <CancelCharges>
                 <dateto>2013-10-15 23:59:59</dateto>
+
               <Charge>
                 <money currency="RUB">74733.84</money>
+
                 <DateFrom>2013-10-12 00:00:00</DateFrom>
               </charge>
+
                 <DateTo>2013-10-15 23:59:59</DateTo>
               <charge>
+
                 <Money Currency="RUB">74733.84</Money>
                 <datefrom>2013-09-23 00:00:00</datefrom>
+
               </Charge>
                 <dateto>2013-10-11 00:00:00</dateto>
+
               <Charge>
                 <money currency="RUB">67260.46</money>
+
                 <DateFrom>2013-09-23 00:00:00</DateFrom>
               </charge>
+
                 <DateTo>2013-10-11 00:00:00</DateTo>
               <charge>
+
                 <Money Currency="RUB">67260.46</Money>
                 <datefrom>2013-08-01 17:59:00</datefrom>
+
               </Charge>
                 <dateto>2013-09-22 00:00:00</dateto>
+
               <Charge>
                 <money currency="RUB">12455.64</money>
+
                 <DateFrom>2013-08-01 17:59:00</DateFrom>
               </charge>
+
                 <DateTo>2013-09-22 00:00:00</DateTo>
             </cancelcharges>
+
                 <Money Currency="RUB">12455.64</Money>
             <modifycharges>
+
               </Charge>
           </modifycharges></penalty><modifycharges>
+
             </CancelCharges>
         </modifycharges></response><modifycharges>
+
             <ModifyCharges/>
       </modifycharges></responsebin><modifycharges>
+
           </Penalty>
     </modifycharges></ns1:penaltyresponse><modifycharges>
+
         </Response>
   </modifycharges></soap-env:body><modifycharges>
+
       </ResponseBin>
</modifycharges></soap-env:envelope></pre>
+
     </ns1:penaltyResponse>
 +
   </SOAP-ENV:Body>
 +
</SOAP-ENV:Envelope>
 +
</syntaxhighlight>
  
Элемент Penalty.
+
Элемент '''Penalty'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 608: Строка 695:
 
Штрафы разбиваются по временным интервалам. На каждом интервале указывается значение штрафа.
 
Штрафы разбиваются по временным интервалам. На каждом интервале указывается значение штрафа.
  
Элемент Charge.
+
Элемент '''Charge'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 628: Строка 715:
 
Атрибут: Currency - код валюты.
 
Атрибут: Currency - код валюты.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ошибки ====
 
==== Ошибки ====
  
=== Бронирование ===
+
== Бронирование ==
 
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
 
+
<div class="mw-collapsible-content">
 
Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.
 
Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.
  
Строка 640: Строка 729:
  
 
Для успешного запроса нужно указать:
 
Для успешного запроса нужно указать:
 
 
#Услугу. В запросе не требуется перечислять все параметры из результатов поиска, достаточно указать уникальный ID результата.
 
#Услугу. В запросе не требуется перечислять все параметры из результатов поиска, достаточно указать уникальный ID результата.
 
#Информация о клиентах. Все клиенты перечисляются в отдельной ветке и нумеруются по порядку. Указатели (элементы с номером клиента), также добавляются в описание услуги.
 
#Информация о клиентах. Все клиенты перечисляются в отдельной ветке и нумеруются по порядку. Указатели (элементы с номером клиента), также добавляются в описание услуги.
 
#Заказчик. Указатель на одну персону.
 
#Заказчик. Указатель на одну персону.
  
WSDL (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking]
+
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking
<pre><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking">
+
 
 +
<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/"  
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 763: Строка 854:
 
         </Request>
 
         </Request>
 
         <Source>
 
         <Source>
           <ClientId>134</ClientId>
+
           <ClientId></ClientId>
           <APIKey>93632C10DA299034C03D742FB160C2D6</APIKey>
+
           <APIKey></APIKey>
 
           <Language>ru</Language>
 
           <Language>ru</Language>
 
           <Currency>RUB</Currency>
 
           <Currency>RUB</Currency>
Строка 772: Строка 863:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Booking.
+
Элемент '''Booking'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 796: Строка 887:
 
Данные об услугах записываются в элементы &lt;Item&gt;.
 
Данные об услугах записываются в элементы &lt;Item&gt;.
  
Элемент Item.
+
Элемент '''Item'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 818: Строка 909:
 
# Распределение клиентов по комнатам.
 
# Распределение клиентов по комнатам.
  
Элемент HotelBookData.
+
Элемент '''HotelBookData'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 862: Строка 953:
 
Набор обязательных данных может меняться в зависимости от типов услуг в бронировании. Рекомендуемый набор обязательных параметров: Lastname, Name, DateOfBirth. Остальные обязательные параметры будут устанавливаться индивидуально при подключении к сервису.
 
Набор обязательных данных может меняться в зависимости от типов услуг в бронировании. Рекомендуемый набор обязательных параметров: Lastname, Name, DateOfBirth. Остальные обязательные параметры будут устанавливаться индивидуально при подключении к сервису.
  
Элемент Person.
+
Элемент '''Person'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 920: Строка 1011:
 
Для некоторых услуг может потребоваться информация о документах.
 
Для некоторых услуг может потребоваться информация о документах.
  
Элемент Document.
+
Элемент '''Document'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 950: Строка 1041:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
 +
<div class="mw-collapsible-content">
 +
После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы &lt;Status&gt; всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.
  
После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы &lt;Status&gt; всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.
+
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<pre><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking"  
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
     <ns1:bookingResponse>
 
     <ns1:bookingResponse>
Строка 1082: Строка 1197:
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
</pre>
+
</syntaxhighlight>
==== Ошибки ====
+
 
 +
Структура ответа очень похожа на запрос. Выделяются те же основные элементы.
  
=== Выгрузка актуальных данных по заказу(ам) ===
+
Элемент '''Booking'''
==== Запрос ====
+
{| style="width: 800px" class="wikitable"
==== Ответ ====
+
|-
==== Ошибки ====
+
! scope="col" width="200" | Элемент
=== Аннуляция заказа ===
+
! scope="col" width="300" | Описание
==== Запрос ====
+
! scope="col" width="300" | Допустимые значения
==== Ответ ====
+
|-
==== Ошибки ====
+
| Items
== Статические данные ==
+
| Обязательный. Содержит элемент(ы) Item.
Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.
+
| Элемент Item
=== Страна ===
+
|-
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStatic
+
| Persons
==== Запрос ====
+
| Обязательный. Здесь перечислены все клиенты заказа.
<pre><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic">
+
| Элемент Person
  <soapenv:Header/>
+
|}
  <soapenv:Body>
+
 
      <ver:countries>
+
В элементах Item раскрывается подробнейшая информация об одной услуге в бронировании.
        <RequestBin>
 
            <Request>
 
              <CountryStatic>
 
              </CountryStatic>
 
            </Request>
 
            <Source>
 
              <ClientId></ClientId>
 
              <APIKey></APIKey>
 
              <Language>ru</Language>
 
              <Currency>RUB</Currency>
 
            </Source>
 
        </RequestBin>
 
      </ver:countries>
 
  </soapenv:Body>
 
</soapenv:Envelope>
 
</pre>
 
  
Элемент '''Request'''
+
Элемент '''Item'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1126: Строка 1226:
 
! scope="col" width="300" | Допустимые значения
 
! scope="col" width="300" | Допустимые значения
 
|-
 
|-
| CountryStatic
+
| Атрибут Id
| Пустой элемент
+
| Обязательный.
| <br/>
+
Номер заказа в системе Nemo.
 +
| Целое число
 +
|-
 +
| Type
 +
| Обязательный.
 +
Тип объекта бронирования.
 +
| HOTELS
 +
|-
 +
| Status
 +
| Обязательный. Статус объекта бронирования .
 +
| booked - забронирован
 +
cancelled - аннулирован
 +
pending confirmation - в процессе подтверждения
 +
pending – произошла попытка бронирования, которое не было завершено
 +
waiting – ожидается результат запроса на бронирование
 +
|-
 +
| Prices
 +
| Обязательный. Данные о ценах.
 +
| см. Элемент Prices
 +
|-
 +
| Dates
 +
| Обязательный. Данные о датах.
 +
| см. Элемент Dates
 +
|-
 +
| Statuses
 +
| Обязательный. Различные дополнительные статусы заказанной услуги.
 +
| см. Элемент Statuses
 +
|-
 +
| Persons
 +
| Обязательный. Содержит клиентов привязанных к услуге.
 +
| элементы Person
 +
|-
 +
| Hotel
 +
| Необязательный. Элемент с данными об отеле.
 +
| см. элемент Hotel (результат поиска отеля)
 
|}
 
|}
  
==== Ответ ====
+
Информация о цене услуги вынесена в отдельную ветку:
<pre>
+
 
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
Элемент '''Prices'''
   <SOAP-ENV:Body>
+
{| style="width: 800px" class="wikitable"
       <ns1:countriesResponse>
+
|-
         <ResponseBin>
+
! scope="col" width="200" | Элемент
             <Response>
+
! scope="col" width="300" | Описание
               <CountryStatic>
+
! scope="col" width="300" | Допустимые значения
                   <Countries>
+
|-
                     <Country Id="4">
+
| Price
                         <Code>AF</Code>
+
| Обязательный. Базовая цена услуги.
                         <Continent>asia</Continent>
+
| Вещественное число.
                         <Data>
+
Атрибут Currency - код валюты.
                           <Info Language="RU">
+
|-
                               <Name>Афганистан</Name>
+
| Charges
                           </Info>
+
| Необязательный. Сумма дополнительных сборов.
                           <Info Language="EN">
+
| Вещественное число.
                               <Name>Afghanistan</Name>
+
Атрибут Currency - код валюты.
                           </Info>
+
|-
                         </Data>
+
| Commission
                     </Country>
+
| Необязательный. Сумма комиссий (вычитается из общей стоимости).
                   </Countries>
+
| Вещественное число.
               </CountryStatic>
+
Атрибут Currency - код валюты.
             </Response>
+
|-
         </ResponseBin>
+
| Penalty
       </ns1:countriesResponse>
+
| Необязательный. Сумма штрафов.
   </SOAP-ENV:Body>
+
| Вещественное число.
</SOAP-ENV:Envelope>
+
Атрибут Currency - код валюты.
</pre>
+
|-
 +
| TotalPrice
 +
| Обязательный. Итоговая стоимость.
 +
= Price + Charges + Commission
 +
| Вещественное число.
 +
Атрибут Currency - код валюты.
 +
|}
 +
 
 +
Информация о датах услуги также вынесена в отдельную ветку:
 +
 
 +
Элемент '''Dates'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| BookingDate
 +
| Обязательный. Дата бронирования.
 +
| Формат гггг-мм-дд чч:мм:сс
 +
|-
 +
| UpdateDate
 +
| Необязательный. Дата обновления.
 +
| Формат гггг-мм-дд чч:мм:сс
 +
|-
 +
| CancelDate
 +
| Необязательный. Дата аннуляции.
 +
| Формат гггг-мм-дд чч:мм:сс
 +
|-
 +
| PenaltyDate
 +
| Необязательный. Дата наступления штрафов.
 +
| Формат гггг-мм-дд чч:мм:сс
 +
|-
 +
| AutoCancelDate
 +
| Необязательный. Дата автоаннулирования.
 +
| Формат гггг-мм-дд чч:мм:сс
 +
|}
 +
 
 +
Дополнительные статусы:
 +
 
 +
Элемент '''Statuses'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| PaymentStatus
 +
| Необязательный.
 +
Статус оплаты.
 +
| Целое число
 +
1 - неоплачено
 +
2 - частично оплачено
 +
3 - оплачено
 +
|-
 +
| DocumentStatus
 +
| Необязательный.
 +
Статус ваучера.
 +
| Целое число
 +
1 - документ не сформирован
 +
2 - документ сформирован
 +
|-
 +
| DeliveryStatus
 +
| Необязательный.
 +
Статус доставки.
 +
| Целое число
 +
1 - не доставлен
 +
2 - доставлен
 +
|-
 +
| InvoiceStatus
 +
| Необязательный.
 +
Статус счета.
 +
| Целое число
 +
1 - счет выставлен.
 +
2 - счет не выставлен.
 +
|}
 +
 
 +
Информация о клиентах заказа полностью повторяет структуру запроса.
 +
</div>
 +
</div>
 +
 
 +
==== Ошибки ====
 +
 
 +
== Подтверждение бронирования ==
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 +
==== Запрос ====
 +
<div class="mw-collapsible-content">
 +
Подтверждение бронирования заказа.
 +
 
 +
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=ConfirmBooking
 +
 
 +
<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/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DConfirmBooking">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <ver:confirm>
 +
        <RequestBin>
 +
            <Request>
 +
              <BookingId>179547</BookingId>
 +
            </Request>
 +
            <Source>
 +
              <ClientId></ClientId>
 +
              <APIKey></APIKey>
 +
              <Language>ru</Language>
 +
              <Currency>RUB</Currency>
 +
            </Source>
 +
        </RequestBin>
 +
      </ver:confirm>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Элемент '''Request'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| BookingID
 +
| Обязательный. Идентификатор заказа в системе Nemo.
 +
| Целое число
 +
|}
 +
 
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 
 +
<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;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DConfirmBooking">
 +
  <SOAP-ENV:Body>
 +
      <ns1:confirmResponse>
 +
        <ResponseBin>
 +
            <Response>
 +
              <Books>
 +
                  <Book>
 +
                    <Id>179547</Id>
 +
                    <Status>booked</Status>
 +
                  </Book>
 +
              </Books>
 +
            </Response>
 +
        </ResponseBin>
 +
      </ns1:confirmResponse>
 +
  </SOAP-ENV:Body>
 +
</SOAP-ENV:Envelope>
 +
</syntaxhighlight>
 +
</div>
 +
</div>
 +
 
 +
==== Ошибки ====
 +
 
 +
== Выгрузка актуальных данных по заказу(ам) ==
 +
Используется для экспорта бронирований и для обновления данных в локальной клиентской базе.
 +
 
 +
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Export
 +
 
 +
<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;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DExport">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
    <ver:export>
 +
      <RequestBin>
 +
        <Request>
 +
          <Export>
 +
            <Items>
 +
              <!--Zero or more repetitions:-->
 +
              <Item Id="386621"/>
 +
            </Items>
 +
          </Export>
 +
        </Request>
 +
        <Source>
 +
          <ClientId></ClientId>
 +
          <APIKey></APIKey>
 +
          <Language>ru</Language>
 +
          <Currency>RUB</Currency>
 +
        </Source>
 +
      </RequestBin>
 +
    </ver:export>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Элемент '''Item'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| Атрибут Id
 +
| Обязательный. Идентификатор заказа в системе Nemo.
 +
| Целое число
 +
|}
 +
 
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 
 +
<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;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DExport"
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 +
  <SOAP-ENV:Body>
 +
    <ns1:exportResponse>
 +
      <ResponseBin>
 +
        <Response>
 +
          <Export>
 +
            <Items>
 +
              <Item Id="386621">
 +
                <Hotel Id="1872666">
 +
                  <Supplier>GTA</Supplier>
 +
                  <CityId>22046</CityId>
 +
                  <DateBegin>2013-10-15</DateBegin>
 +
                  <DateEnd>2013-10-18</DateEnd>
 +
                  <CacheId>1872666</CacheId>
 +
                  <Name>ADLON KEMPINSKI</Name>
 +
                  <Categories>
 +
                    <Category Id="1">
 +
                      <Rooms>
 +
                        <Room Count="1" Id="1" ServiceId="1"/>
 +
                        <Room Count="1" Id="2" ServiceId="2"/>
 +
                      </Rooms>
 +
                      <TotalPrice Currency="RUB">74733.84</TotalPrice>
 +
                    </Category>
 +
                  </Categories>
 +
                  <Services>
 +
                    <Service Id="1" Status="OK">
 +
                      <Desc>Standard Twin</Desc>
 +
                      <Meal>Full Breakfast</Meal>
 +
                      <Price Currency="RUB">37366.92</Price>
 +
                    </Service>
 +
                    <Service Id="2" Status="OK">
 +
                      <Desc>Standard Twin</Desc>
 +
                      <Meal>Full Breakfast</Meal>
 +
                      <Price Currency="RUB">37366.92</Price>
 +
                    </Service>
 +
                  </Services>
 +
                  <Rooms>
 +
                    <Room Id="1" Type="TWIN"/>
 +
                    <Room Id="2" Type="SNGL"/>
 +
                  </Rooms>
 +
                </Hotel>
 +
                <Type>HOTELS</Type>
 +
                <Status>waiting</Status>
 +
                <Prices>
 +
                  <Price Currency="RUB">74733.84</Price>
 +
                  <Charges Currency="RUB">0</Charges>
 +
                  <Commission Currency="RUB">0</Commission>
 +
                  <Penalty Currency="RUB">0</Penalty>
 +
                  <TotalPrice Currency="RUB">74733.84</TotalPrice>
 +
                </Prices>
 +
                <Dates>
 +
                  <BookingDate>2013-08-01 20:21:47</BookingDate>
 +
                  <UpdateDate>2013-08-01 20:35:01</UpdateDate>
 +
                  <CancelDate xsi:nil="true"/>
 +
                  <PenaltyDate>2013-07-31 19:10:37</PenaltyDate>
 +
                  <AutoCancelDate>2013-08-01 20:23:47</AutoCancelDate>
 +
                  <ConfirmationLimit/>
 +
                </Dates>
 +
                <Statuses>
 +
                  <PaymentStatus>1</PaymentStatus>
 +
                  <DocumentStatus>1</DocumentStatus>
 +
                  <DeliveryStatus>1</DeliveryStatus>
 +
                  <InvoiceStatus>1</InvoiceStatus>
 +
                  <ProblemStatus>1</ProblemStatus>
 +
                </Statuses>
 +
                <Customer>
 +
                  <Person Number="1"/>
 +
                </Customer>
 +
                <Persons>
 +
                  <Person Number="1"/>
 +
                  <Person Number="2"/>
 +
                  <Person Number="3"/>
 +
                </Persons>
 +
              </Item>
 +
            </Items>
 +
            <Persons>
 +
              <Person Number="1">
 +
                <Lastname>IVANOV</Lastname>
 +
                <Name>IVAN</Name>
 +
                <Middlename>IVANOVICH</Middlename>
 +
                <DateOfBirth xsi:nil="true"/>
 +
                <Phone>+79871231212</Phone>
 +
                <Email>m.rudenko@mute-lab.com</Email>
 +
                <Gender xsi:nil="true"/>
 +
                <Document Type="P">
 +
                  <Series>1811</Series>
 +
                  <Number>912219</Number>
 +
                  <IssueDate>2012-12-12 00:00:00</IssueDate>
 +
                  <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
 +
                </Document>
 +
              </Person>
 +
              <Person Number="2">
 +
                <Lastname>PETROV</Lastname>
 +
                <Name>IVAN</Name>
 +
                <Middlename>MIKHAILOVICH</Middlename>
 +
                <DateOfBirth xsi:nil="true"/>
 +
                <Phone>+79871231212</Phone>
 +
                <Email>m.rudenko@mute-lab.com</Email>
 +
                <Gender xsi:nil="true"/>
 +
                <Document Type="P">
 +
                  <Series>1866</Series>
 +
                  <Number>913319</Number>
 +
                  <IssueDate>2012-12-12 00:00:00</IssueDate>
 +
                  <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
 +
                </Document>
 +
              </Person>
 +
              <Person Number="3">
 +
                <Lastname>SIDOROV</Lastname>
 +
                <Name>IVAN</Name>
 +
                <Middlename>SERGEEVICH</Middlename>
 +
                <DateOfBirth xsi:nil="true"/>
 +
                <Phone>+79871231212</Phone>
 +
                <Email>m.rudenko@mute-lab.com</Email>
 +
                <Gender xsi:nil="true"/>
 +
                <Document Type="P">
 +
                  <Series>1866</Series>
 +
                  <Number>913319</Number>
 +
                  <IssueDate>2012-12-12 00:00:00</IssueDate>
 +
                  <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
 +
                </Document>
 +
              </Person>
 +
            </Persons>
 +
          </Export>
 +
        </Response>
 +
      </ResponseBin>
 +
    </ns1:exportResponse>
 +
  </SOAP-ENV:Body>
 +
</SOAP-ENV:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Формат ответа аналогичен результату бронирования.
 +
</div>
 +
</div>
 +
 
 +
==== Ошибки ====
 +
 
 +
== Аннуляция заказа ==
 +
'''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;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCancelBooking">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
    <ver:cancel>
 +
      <RequestBin>
 +
        <Request>
 +
          <CancelBooking>           
 +
            <Item Id="386621"/>
 +
          </CancelBooking>
 +
        </Request>
 +
        <Source>
 +
          <ClientId></ClientId>
 +
          <APIKey></APIKey>
 +
          <Language>ru</Language>
 +
          <Currency>RUB</Currency>
 +
        </Source>
 +
      </RequestBin>
 +
    </ver:cancel>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Элемент '''Item'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| Атрибут Id
 +
| Обязательный. Идентификатор заказа в системе Nemo.
 +
| Целое число
 +
|}
 +
 
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 
 +
==== Ответ ====
 +
см. результаты бронирования.
 +
==== Ошибки ====
 +
* '''You can cancel only booked order''' - возникает при попытке аннулировать незабронированный заказ.
 +
* '''Invalid Booking Id N''' - заказ с номером N отсутствует.
 +
 
 +
= Статические данные =
 +
Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.
 +
== Страна ==
 +
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStatic
 +
<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;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <ver:countries>
 +
        <RequestBin>
 +
            <Request>
 +
              <CountryStatic>
 +
              </CountryStatic>
 +
            </Request>
 +
            <Source>
 +
              <ClientId></ClientId>
 +
              <APIKey></APIKey>
 +
              <Language>ru</Language>
 +
              <Currency>RUB</Currency>
 +
            </Source>
 +
        </RequestBin>
 +
      </ver:countries>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Элемент '''Request'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| CountryStatic
 +
| Пустой элемент
 +
| <br/>
 +
|}
 +
 
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 
 +
<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;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic"  
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 +
   <SOAP-ENV:Body>
 +
       <ns1:countriesResponse>
 +
         <ResponseBin>
 +
             <Response>
 +
               <CountryStatic>
 +
                   <Countries>
 +
                     <Country Id="4">
 +
                         <Code>AF</Code>
 +
                         <Continent>asia</Continent>
 +
                         <Data>
 +
                           <Info Language="RU">
 +
                               <Name>Афганистан</Name>
 +
                           </Info>
 +
                           <Info Language="EN">
 +
                               <Name>Afghanistan</Name>
 +
                           </Info>
 +
                         </Data>
 +
                     </Country>
 +
                   </Countries>
 +
               </CountryStatic>
 +
             </Response>
 +
         </ResponseBin>
 +
       </ns1:countriesResponse>
 +
   </SOAP-ENV:Body>
 +
</SOAP-ENV:Envelope>
 +
</syntaxhighlight>
 +
 
 +
Элемент '''CountryStatic'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| Countries
 +
| Обязательный
 +
| Набор элементов Country
 +
|}
 +
 
 +
Элемент '''Country'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| Атрибут Id
 +
| Обязательный. Идентификатор страны (ISO).
 +
| Целое число
 +
|-
 +
| Code
 +
| Обязательный. Код страны ISO.
 +
| Строка из 2-х латинских букв
 +
|-
 +
| Continent
 +
| Обязательный. Название континента.
 +
| Строка.
 +
|-
 +
| Data
 +
| Обязательный. Информация требующая перевода.
 +
| Набор элементов Info.
 +
|}
  
Элемент CountryStatic
+
Элемент '''Info'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1168: Строка 1880:
 
! scope="col" width="300" | Допустимые значения
 
! scope="col" width="300" | Допустимые значения
 
|-
 
|-
| Countries
+
| Атрибут Language
| Обязательный
+
| Обязательный. Язык в котором представлена информация.
| Набор элементов Country
+
| Строка из 2-х латинских букв.
|}
 
 
 
Элемент Country
 
{| style="width: 800px" class="wikitable"
 
 
|-
 
|-
! scope="col" width="200" | Элемент
+
| Name
! scope="col" width="300" | Описание
+
| Обязательный. Наименование страны.
! scope="col" width="300" | Допустимые значения
+
| Строка в произвольном формате.
|-
 
| Атрибут Id
 
| Обязательный. Идентификатор страны (ISO).
 
| Целое число
 
|-
 
| Code
 
| Обязательный. Код страны ISO.
 
| Строка из 2-х латинских букв
 
|-
 
| Continent
 
| Обязательный. Название континента.
 
| Строка.
 
|-
 
| Data
 
| Обязательный. Информация требующая перевода.
 
| Набор элементов Info.
 
 
|}
 
|}
 +
</div>
 +
</div>
  
Элемент Info
+
==== Ошибки ====
{| style="width: 800px" class="wikitable"
 
|-
 
! scope="col" width="200" | Элемент
 
! scope="col" width="300" | Описание
 
! scope="col" width="300" | Допустимые значения
 
|-
 
| Атрибут Language
 
| Обязательный. Язык в котором представлена информация.
 
| Строка из 2-х латинских букв.
 
|-
 
| Name
 
| Обязательный. Наименование страны.
 
| Строка в произвольном формате.
 
|}
 
 
 
==== Ошибки ====
 
  
=== Город ===
+
== Город ==
 
Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом:
 
Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом:
  
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CityStatic
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CityStatic
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
<pre>
+
<div class="mw-collapsible-content">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
+
<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/"  
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 1242: Строка 1923:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент CityStatic
+
Элемент '''CityStatic'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1256: Строка 1937:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
<pre>
+
<div class="mw-collapsible-content">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
+
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
       <ns1:citiesResponse>
 
       <ns1:citiesResponse>
Строка 1265: Строка 1969:
 
               <CityStatic>
 
               <CityStatic>
 
                   <Cities>
 
                   <Cities>
<City Id="1">
+
                    <City Id="1">
 
                         <Name>Кабул</Name>
 
                         <Name>Кабул</Name>
 
                         <CountryId>4</CountryId>
 
                         <CountryId>4</CountryId>
Строка 1302: Строка 2006:
 
                     </City>
 
                     </City>
 
...
 
...
    </Cities>
+
                  </Cities>
 
               </CityStatic>
 
               </CityStatic>
 
             </Response>
 
             </Response>
Строка 1309: Строка 2013:
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент CityStatic
+
Элемент '''CityStatic'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1323: Строка 2027:
 
|}
 
|}
  
Элемент City
+
Элемент '''City'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1330: Строка 2034:
 
! scope="col" width="300" | Допустимые значения
 
! scope="col" width="300" | Допустимые значения
 
|-
 
|-
| Атрибут Id
+
| Атрибут '''Id'''
 
| Обязательный. Идентификатор города.
 
| Обязательный. Идентификатор города.
 
| Целое число
 
| Целое число
Строка 1342: Строка 2046:
 
| См. описание элемента Data в ответе получения информации о стране.
 
| См. описание элемента Data в ответе получения информации о стране.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ошибки ====
 
==== Ошибки ====
  
=== Статика по отелям и апартаментам ===
+
== Статика по отелям и апартаментам ==
 
Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям.
 
Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям.
  
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStatic
 
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStatic
  
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Запрос ====
 
==== Запрос ====
<pre>
+
<div class="mw-collapsible-content">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic">
+
<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/"  
 +
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 1372: Строка 2081:
 
   </soapenv:Body>
 
   </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Hotels
+
Элемент '''Hotels'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1386: Строка 2095:
 
|}
 
|}
  
 +
Элемент '''Source'''
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
! scope="col" width="200" | Элемент
 +
! scope="col" width="300" | Описание
 +
! scope="col" width="300" | Допустимые значения
 +
|-
 +
| ClientID
 +
| Обязательный. ID клиента в системе Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Целое число.
 +
|-
 +
| APIKey
 +
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
 +
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
 +
| Латинские буквы и цифры. Всего 32 символа.
 +
|}
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Ответ ====
 
==== Ответ ====
<pre><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
<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;">
 +
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
 +
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic"  
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
       <ns1:hotelsResponse>
 
       <ns1:hotelsResponse>
Строка 1428: Строка 2162:
 
                               <Area xsi:nil="true"/>
 
                               <Area xsi:nil="true"/>
 
                               <Location>City centre</Location>
 
                               <Location>City centre</Location>
                               <Desc>This 5 star hotel is located in the city centre of St Petersburg and was established in 2011. It is close to the St.Isaac's Cathedral and the nearest station is Admiralteyskaya station. The Hotel has a restaurant, 2 bars, a conference room, a coffee shop, an indoor swimming pool and a fitness centre/gym. All 137 rooms are equipped with minibar, hairdryer, safe, trouser press and air conditioning.</Desc>
+
                               <Desc>This 5 star hotel is located in the city centre of St Petersburg  
 +
                                    and was established in 2011. It is close to the St.Isaac's Cathedral  
 +
                                    and the nearest station is Admiralteyskaya station. The Hotel has  
 +
                                    a restaurant, 2 bars, a conference room, a coffee shop, an indoor  
 +
                                    swimming pool and a fitness centre/gym. All 137 rooms are equipped  
 +
                                    with minibar, hairdryer, safe, trouser press and air conditioning.</Desc>
 
                               <Address>6 Voznesensky Prospect, St. Petersburg, 190000, St Petersburg, Russia</Address>
 
                               <Address>6 Voznesensky Prospect, St. Petersburg, 190000, St Petersburg, Russia</Address>
 
                           </Info>
 
                           </Info>
Строка 1457: Строка 2196:
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
</pre>
+
</syntaxhighlight>
  
Элемент Hotel
+
Элемент '''Hotel'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1511: Строка 2250:
 
|}
 
|}
  
Элемент Info.
+
Элемент '''Info'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1539: Строка 2278:
 
|}
 
|}
  
Элемент Phones.
+
Элемент '''Phones'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1550: Строка 2289:
 
| Строка в произвольном формате.
 
| Строка в произвольном формате.
 
|}
 
|}
Элемент Image.
+
 
 +
Элемент '''Image'''
 
{| style="width: 800px" class="wikitable"
 
{| style="width: 800px" class="wikitable"
 
|-
 
|-
Строка 1565: Строка 2305:
 
| Строка в произвольном формате.
 
| Строка в произвольном формате.
 
|}
 
|}
 +
</div>
 +
</div>
  
 
==== Ошибки ====
 
==== Ошибки ====
 +
 +
==См. также==
 +
* [[Агентский интерфейс прикладного программирования (Агентский API)]]
 +
* [[Схема использования агентского API (workflow)]]
 +
* [[Агентский API Авиабилеты]]
 +
* [[Агентский API Оплата]]

Текущая версия на 18:45, 6 мая 2019

Внимание! В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по ссылке

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

развернуть

Запрос

развернуть

Ответ

Ошибки

Город

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

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

развернуть

Запрос

развернуть

Ответ

Ошибки

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

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

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

развернуть

Запрос

развернуть

Ответ

Ошибки

См. также