Интеграция со сторонними системами АПИ
Версия от 17:59, 29 января 2015; Кирилл Фимченко (обсуждение | вклад)
Содержание
- 1 API Поиска авиабилетов
- 2 API Поиска отелей
- 3 API бронирования, аннуляции, войдирования авиабилетов
- 4 API бронирования, отмены отелей
- 5 API Выгрузки статистики продаж через API
- 6 Выгрузка информации о продажах в формате Nemo XML
- 7 Выгрузка информации о продажах в формате СОФИ XML
- 8 Фиксация оплаты внешним запросом
- 9 Выгрузка заказов по критериям в формате Nemo XML
- 10 Выгрузка определенного заказа по критериям в формате Nemo XML
- 11 API универсального платежного шлюза
- 12 API Синхронизации пользователей и субагентов
- 13 API Кроссавторизации
- 14 Передача параметров в форму поиска
- 15 Проверка в сторонней системе возможности тикетинга
- 16 API загрузки счетов из сторонней системы
- 17 API загрузки сальдо компаний из СОФИ
API Поиска авиабилетов
Подключение
Это сервис внутри Nemo, который позволяет получить результаты поиска.
Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе «Администрирование» ⇨ «Веб-служба. Авторизация».
После добавления пользователя, ему будут присвоены Номер (ClientId) и API ключ клиента, которые нужно использовать для подключения.
WSDL находится по адресу: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=SearchFlights
Общий формат запроса / ответа поиска
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:search>
5 <RequestBin>
6 <Request>
7 <SearchFlights LinkOnly="?">
8 <!--LinkOnly — Позволяет управлять выдачей результатов. true — вернуть только ссылку на результаты поиска,
9 без перелётов (занимает меньше времени), false — полная выдача, ссылки и перелёты.-->
10 <ODPairs Type="?" Direct="?" AroundDates="?">
11 <!--Type — тип перелёта, возможные значения: OW — туда, RT — туда-обратно, CR — сложный маршрут. Для перелета
12 туда-обратно или сложного маршрута необходимо добавить еще один или несколько тэгов ODPair, примеры далее-->
13 <!--Direct — искать только прямые перелёты, возможные значения: true/false-->
14 <!--AroundDates — поиск по окружным датам, количество дней +/- от даты заезда/возвращения, значения: 0, 1, 3.
15 Применим только для типов перелёта в одну сторону(OW) и туда-обратно(RT)-->
16 <!--Zero or more repetitions:-->
17 <ODPair>
18 <DepDate>?</DepDate>
19 <!--DepDate — дата вылета, в формате ГГГГ-MM-ДД-->
20 <DepAirp CodeType="IATA">?</DepAirp>
21 <!--DepAirp — аэропорт вылета, IATA код-->
22 <ArrAirp CodeType="IATA">?</ArrAirp>
23 <!--ArrAirp — аэропорт прилёта, IATA код-->
24 </ODPair>
25 </ODPairs>
26 <Travellers>
27 <!--Zero or more repetitions:-->
28 <Traveller Type="?" Count="?"/>
29 <!--Type — тип пассажира, возможные значения: ADT — взрослые, CNN — дети,
30 INF — младенцы, INS — младенцы с местом-->
31 <!--Count — количество пассажиров-->
32 </Travellers>
33 <Restrictions>
34 <ClassPref>?</ClassPref> <!--необязательный-->
35 <!--ClassPref — предпочитаемый класс поиска, возможные значения: economy, business, first.
36 Если не заполнять, то будет произведен поиск эконом класса-->
37 <OnlyAvail>?</OnlyAvail> <!--необязательный-->
38 <!--OnlyAvail — искать только доступные, возможные значения: true/false-->
39 <AirVPrefs>
40 <!--Zero or more repetitions:-->
41 <AirVPref Code="?" Include="?" Type="IATA"/> <!--необязательный-->
42 <!--Code — код авиакомпании, SU, FV и т.п.-->
43 <!--Include — включить или исключить авиакомпанию из результатов: true — включить, false — исключить-->
44 </AirVPrefs>
45 <IncludePrivateFare>?</IncludePrivateFare> <!--необязательный-->
46 <!--IncludePrivateFare — искать цены для агентства, если true — то включаем приватные, false — публичные-->
47 <CurrencyCode>?</CurrencyCode> <!--необязательный-->
48 <!--CurrencyCode — код валюты, например: RUB, EUR-->
49 </Restrictions>
50 </SearchFlights>
51 </Request>
52 <Source>
53 <ClientId>?</ClientId>
54 <!--ClientId — ID клиента в системе Nemo. Можно посмотреть/добавить в разделе
55 "Администрирование" ? "Веб-служба. Авторизация".-->
56 <APIKey>?</APIKey>
57 <!--APIKey — секретный ключ доступа к API Nemo. Можно посмотреть/добавить в разделе
58 "Администрирование" ? "Веб-служба. Авторизация".-->
59 <Language>?</Language>
60 <!--Language — язык, например: RU-->
61 <Currency>?</Currency>
62 <!-- Currency — валюта, например: RUB, EUR-->
63 <ShowNames>?</ShowNames>
64 <!-- ShowNames — отображение названий аэропортов, авиакомпаний и воздушных судов: true - отображать, false - не отображать. Возвращает значение на том языке, который был указан в запросе. Для RU - русский вариант, для UKR, EN, ES - латинский вариант. Опциональный элемент. -->
65 </Source>
66 </RequestBin>
67 </ver:search>
68 </soapenv:Body>
69 </soapenv:Envelope>
Ответ
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:searchResponse>
4 <ResponseBin>
5 <Response>
6 <SearchFlights>
7 <Flights SearchId="?" ResultURL="?">
8 <!--SearchId — номер процесса поиска в Nemo-->
9 <!--ResultURL — ссылка на страницу просмотра результатов на сайте агентства-->
10 <Flight FlightId="?">
11 <!--FlightId — Id перелёта в системе Nemo-->
12 <WebService>?</WebService>
13 <!--WebService — поставщик перелёта-->
14 <ValCompany>?</ValCompany>
15 <!--ValCompany — код авиакомпании, являющейся валидирующим перевозчиком, IATA-->
16 <URL>?</URL>
17 <!--URL — ссылка на бронирование конкретного перелета-->
18 <Segments>
19 <Segment SegNum="?" SegGroupNum="?">
20 <!--SegNum — номер сегмента в перелёте-->
21 <!--SegGroupNum – номер плеча перелёта-->
22 <DepAirp CodeType="IATA" Name="?">?</DepAirp>
23 <!--DepAirp — аэропорт отправления, например: MOW — любой аэропорт в г.Москва или SVO — Шереметьево. Name - название аэропорта отправления-->
24 <DepTerminal>?</DepTerminal>
25 <!--DepTerminal — терминал пункта отправления, если пустое значение,
26 то в аэропорту всего 1 терминал-->
27 <ArrAirp CodeType="IATA" Name="?">?</ArrAirp>
28 <!--ArrAirp — аэропорт прибытия. Name - название аэропорта прибытия-->
29 <ArrTerminal>?</ArrTerminal>
30 <!--ArrTerminal — терминал пункта прибытия, если пустое значение,
31 то в аэропорту всего 1 терминал-->
32 <OpAirline>?</OpAirline>
33 <!--OpAirline — авиакомпания перевозчик, например: SU — Аэрофлот-->
34 <OpAirlineName>?</OpAirlineName>
35 <!--OpAirlineName — название авиакомпании перевозчика, например: Аэрофлот - Российские авиалинии -->
36 <MarkAirline>?</MarkAirline>
37 <!--MarkAirline — авиакомпания, продающая перелёт-->
38 <MarkAirlineName>?</MarkAirlineName>
39 <!--MarkAirlineName — название авиакомпании, продающей перелёт-->
40 <FlightNumber>?</FlightNumber>
41 <!--FlightNumber — номер рейса-->
42 <AircraftName>?</AircraftName>
43 <!--AircraftName — название воздушного судна. Например: Airbus 320-->
44 <AircraftType>?</AircraftType>
45 <!--AircraftType — тип воздушного судна, код-->
46 <DepDateTime>?</DepDateTime>
47 <!--DepDateTime — дата и время отправления, формат ГГГГ-MM-ДДTЧЧ:ММ:СС-->
48 <ArrDateTime>?</ArrDateTime>
49 <!--ArrDateTime — дата и время прибытия, формат ГГГГ-MM-ДДTЧЧ:ММ:СС-->
50 <StopNum>?</StopNum>
51 <!--StopNum — количество остановок-->
52 <BookingCodes>
53 <BookingCode ClassType="?">
54 <!--ClassType — класс перелета, например: economy-->
55 <BookingCode>?</BookingCode>
56 <!--BookingCode — код класса бронирования, у разных авиакомпаний один и тот же класс
57 может записываться разными литерами, например: L-->
58 </BookingCode>
59 </BookingCodes>
60 <FlightTime>?</FlightTime>
61 <!--FlightTime — время перелёта в минутах-->
62 <TimeZone Departure="?" Arrival="?"/>
63 <!--Departure временная зона аэропорта отправления-->
64 <!--Arrival — временная зона аэропорта прибытия-->
65 <ETicket>?</ETicket>
66 <!--ETicket — признак электронного билета, значения: true / false-->
67 </Segment>
68 </Segments>
69 <PricingInfo Refundable="?">
70 <!--Refundable — возвратный/невозвратный, true/false. Если пустое, то не известно-->
71 <PassengerFare Type="?" Quantity="?">
72 <!--Type — тип пассажира, возможные значения: ADT — взрослые, CNN — дети,
73 INF — младенцы, INS — младенцы с местом-->
74 <!--Quantity — количество пассажиров данного типа-->
75 <BaseFare Currency="?" Amount="?"/>
76 <!--BaseFare — базовая стоимость, в базовой валюте. Currency — код валюты, Amount — значение цены-->
77 <EquiveFare Currency="?" Amount="?"/>
78 <!--EquiveFare — базовая стоимость, в эквивалентной валюте(валюте продажи).
79 Currency — код валюты, Amount — значение цены-->
80 <TotalFare Currency="?" Amount="?"/>
81 <!--TotalFare — суммарная стоимость, в эквивалентной валюте.
82 Currency — код валюты, Amount — значение цены-->
83 <Taxes>
84 <Tax CurCode="?" TaxCode="?" Amount="?"/>
85 <!--CurCode — код валюты, TaxCode — код таксы, Amount — сумма таксы-->
86 </Taxes>
87 <Tariffs>
88 <Tariff Code="?" SegNum="?"/>
89 <!--Code — код тарифа, SegNum — номер сегмента, к которому применён тариф-->
90 </Tariffs>
91 <FareCalc>?</FareCalc>
92 <!--FareCalc — строка расчёта цены-->
93 <LastTicketDateTime>?</LastTicketDateTime>
94 <!--LastTicketDateTime — дата и время таймлимита по выписке в формате ГГГГ-MM-ДДTЧЧ:ММ:СС-->
95 </PassengerFare>
96 </PricingInfo>
97 <Commission/>
98 <Charges Currency="?">?</Charges>
99 <!--Charges — сборы, Currency — код валюты-->
100 <TotalPrice Currency="?">?</TotalPrice>
101 <!--TotalPrice — итоговая цена, Currency — код валюты-->
102 </Flight>
103 <Flight>...</Flight>
104 ....................
105 <Flight>...</Flight>
106 </Flights>
107 <Errors>
108 <Error Code="?">
109 <!--Code — код ошибки в системе Nemo-->
110 <ServiceErrorMessage>?</ServiceErrorMessage>
111 <!--ServiceErrorMessage — сообщение об ошибке полученное от веб-сервиса поставщика-->
112 <Message>?</Message>
113 <!--Message — сообщение об ошибке от системы Nemo-->
114 </Error>
115 </Errors>
116 </SearchFlights>
117 </Response>
118 </ResponseBin>
119 </ns1:searchResponse>
120 </SOAP-ENV:Body>
121 </SOAP-ENV:Envelope>
В ссылках на просмотр страницы результата поиска и на бронирование конкретного перелета, домен агентства/субагентства определяется следующим образом:
- Если текущий домен агентства/субагентства есть в настройках (Администрирование ⇨ Настройки агентства ⇨ Доменное имя сайта для загрузки настроек), то этот домен используется в ссылках.
- Если текущего домена нет в настройках, то используется первый домен из настроек.
- Если в настройках не прописано ни одного домена, то используется текущий домен.
На поиск действуют ограничения заданные в настройках агентства, в частности ограничения по пассажирам и ограничение ближайшей разрешенной даты поиска билетов.
- Если дата поиска меньше ближайшей разрешенной даты для поиска билетов, то выводится сообщение об ошибке Invalid search param: Неверная дата вылета: слишком близкая
- Если количество взрослых пассажиров превышает допустимое ограничение - Invalid search param: Слишком много взрослых
- Если количество детей в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много детей
- Если количество младенцев в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много инфантов
- Если количество младенцев с местом в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много инфантов
Примеры использования
Односторонний перелет
Пример одностороннего перелета: Москва — Мадрид, 1 взрослый, 1 ребенок, эконом класс, предпочитаемая авиакомпания — Аэрофлот.
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:search>
5 <RequestBin>
6 <Request>
7 <SearchFlights LinkOnly="false">
8 <ODPairs Type="OW" Direct="false" AroundDates="0">
9 <!--Zero or more repetitions:-->
10 <ODPair>
11 <DepDate>2014-03-20</DepDate>
12 <DepAirp CodeType="IATA">MOW</DepAirp>
13 <ArrAirp CodeType="IATA">MAD</ArrAirp>
14 </ODPair>
15 </ODPairs>
16 <Travellers>
17 <!--Zero or more repetitions:-->
18 <Traveller Type="ADT" Count="1"/>
19 <Traveller Type="CNN" Count="1"/>
20 </Travellers>
21 <Restrictions>
22 <ClassPref>economy</ClassPref>
23 <OnlyAvail>false</OnlyAvail>
24 <AirVPrefs>
25 <!--Zero or more repetitions:-->
26 <AirVPref Code="SU" Include="true" Type="IATA"/>
27 </AirVPrefs>
28 <IncludePrivateFare>false</IncludePrivateFare>
29 <CurrencyCode>RUB</CurrencyCode>
30 </Restrictions>
31 </SearchFlights>
32 </Request>
33 <Source>
34 <ClientId>---</ClientId>
35 <APIKey>---</APIKey>
36 <Language>RU</Language>
37 <Currency>RUB</Currency>
38 <ShowNames>true</ShowNames>
39 </Source>
40 </RequestBin>
41 </ver:search>
42 </soapenv:Body>
43 </soapenv:Envelope>
Ответ
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://CLIEN_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:searchResponse>
4 <ResponseBin>
5 <Response>
6 <SearchFlights>
7 <Flights SearchId="13949" ResultURL="http%3A%2F%2FCLIENT_DOMAIN%2F%3Fgo%3Dsearch%2Fview_results%26uid%3D13949">
8 <Flight FlightId="168090001">
9 <WebService>SABRE</WebService>
10 <ValCompany/>
11 <URL>http%3A%2F%2FCLIENT_DOMAIN%2F%3Fgo%3Dbooking%2Finfo%26uid%3D13949%26flight%3D168090001</URL>
12 <Segments>
13 <Segment SegNum="1" SegGroupNum="0">
14 <DepAirp CodeType="IATA" Name="Шереметьево, Москва">SVO</DepAirp>
15 <DepTerminal/>
16 <ArrAirp CodeType="IATA" Name="Мадрид">MAD</ArrAirp>
17 <ArrTerminal/>
18 <OpAirline>SU</OpAirline>
19 <OpAirlineName>Аэрофлот - Российские авиалинии</OpAirlineName>
20 <MarkAirline>SU</MarkAirline>
21 <MarkAirlineName>Аэрофлот - Российские авиалинии</MarkAirlineName>
22 <FlightNumber>2500</FlightNumber>
23 <AircraftName>Airbus 320</AircraftName>
24 <AircraftType>320</AircraftType>
25 <DepDateTime>2014-03-20T08:05:00</DepDateTime>
26 <ArrDateTime>2014-03-20T10:15:00</ArrDateTime>
27 <StopNum>0</StopNum>
28 <BookingCodes>
29 <BookingCode ClassType="economy">
30 <BookingCode>E</BookingCode>
31 </BookingCode>
32 </BookingCodes>
33 <FlightTime>310</FlightTime>
34 <TimeZone Departure="4" Arrival="1"/>
35 <ETicket>true</ETicket>
36 </Segment>
37 </Segments>
38 <PricingInfo Refundable="false">
39 <PassengerFare Type="ADT" Quantity="1">
40 <BaseFare Currency="EUR" Amount="165"/>
41 <EquiveFare Currency="RUB" Amount="8250"/>
42 <TotalFare Currency="RUB" Amount="10535"/>
43 <Taxes>
44 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
45 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
46 </Taxes>
47 <Tariffs/>
48 <FareCalc>MOW SU MAD225.45NUC225.45END ROE0.731857</FareCalc>
49 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
50 </PassengerFare>
51 <PassengerFare Type="CNN" Quantity="1">
52 <BaseFare Currency="EUR" Amount="124"/>
53 <EquiveFare Currency="RUB" Amount="6200"/>
54 <TotalFare Currency="RUB" Amount="8485"/>
55 <Taxes>
56 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
57 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
58 </Taxes>
59 <Tariffs/>
60 <FareCalc>MOW SU MAD169.08NUC169.08END ROE0.731857</FareCalc>
61 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
62 </PassengerFare>
63 </PricingInfo>
64 <Commission/>
65 <Charges Currency="RUB">0</Charges>
66 <TotalPrice Currency="RUB">19020</TotalPrice>
67 </Flight>
68 <Flight FlightId="168090002">
69 <WebService>SABRE</WebService>
70 <ValCompany/>
71 <URL>http%3A%2F%2FCLIENT_DOMAIN%2F%3Fgo%3Dbooking%2Finfo%26uid%3D13949%26flight%3D168090002</URL>
72 <Segments>
73 <Segment SegNum="1" SegGroupNum="0">
74 <DepAirp CodeType="IATA">SVO</DepAirp>
75 <DepTerminal/>
76 <ArrAirp CodeType="IATA">MAD</ArrAirp>
77 <ArrTerminal/>
78 <OpAirline>SU</OpAirline>
79 <MarkAirline>SU</MarkAirline>
80 <FlightNumber>2604</FlightNumber>
81 <AircraftType>320</AircraftType>
82 <DepDateTime>2014-03-20T20:30:00</DepDateTime>
83 <ArrDateTime>2014-03-20T22:40:00</ArrDateTime>
84 <StopNum>0</StopNum>
85 <BookingCodes>
86 <BookingCode ClassType="economy">
87 <BookingCode>E</BookingCode>
88 </BookingCode>
89 </BookingCodes>
90 <FlightTime>310</FlightTime>
91 <TimeZone Departure="4" Arrival="1"/>
92 <ETicket>true</ETicket>
93 </Segment>
94 </Segments>
95 <PricingInfo Refundable="false">
96 <PassengerFare Type="ADT" Quantity="1">
97 <BaseFare Currency="EUR" Amount="165"/>
98 <EquiveFare Currency="RUB" Amount="8250"/>
99 <TotalFare Currency="RUB" Amount="10535"/>
100 <Taxes>
101 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
102 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
103 </Taxes>
104 <Tariffs/>
105 <FareCalc>MOW SU MAD225.45NUC225.45END ROE0.731857</FareCalc>
106 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
107 </PassengerFare>
108 <PassengerFare Type="CNN" Quantity="1">
109 <BaseFare Currency="EUR" Amount="124"/>
110 <EquiveFare Currency="RUB" Amount="6200"/>
111 <TotalFare Currency="RUB" Amount="8485"/>
112 <Taxes>
113 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
114 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
115 </Taxes>
116 <Tariffs/>
117 <FareCalc>MOW SU MAD169.08NUC169.08END ROE0.731857</FareCalc>
118 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
119 </PassengerFare>
120 </PricingInfo>
121 <Commission/>
122 <Charges Currency="RUB">0</Charges>
123 <TotalPrice Currency="RUB">19020</TotalPrice>
124 </Flight>
125 <Flight FlightId="168090003">
126 <WebService>SABRE</WebService>
127 <ValCompany/>
128 <URL>http%3A%2F%2FCLIENT_DOMAIN%2F%3Fgo%3Dbooking%2Finfo%26uid%3D13949%26flight%3D168090003</URL>
129 <Segments>
130 <Segment SegNum="1" SegGroupNum="0">
131 <DepAirp CodeType="IATA">SVO</DepAirp>
132 <DepTerminal/>
133 <ArrAirp CodeType="IATA">BCN</ArrAirp>
134 <ArrTerminal/>
135 <OpAirline>SU</OpAirline>
136 <MarkAirline>SU</MarkAirline>
137 <FlightNumber>2638</FlightNumber>
138 <AircraftType>321</AircraftType>
139 <DepDateTime>2014-03-20T09:10:00</DepDateTime>
140 <ArrDateTime>2014-03-20T10:40:00</ArrDateTime>
141 <StopNum>0</StopNum>
142 <BookingCodes>
143 <BookingCode ClassType="economy">
144 <BookingCode>E</BookingCode>
145 </BookingCode>
146 </BookingCodes>
147 <FlightTime>270</FlightTime>
148 <TimeZone Departure="4" Arrival="1"/>
149 <ETicket>true</ETicket>
150 </Segment>
151 <Segment SegNum="2" SegGroupNum="0">
152 <DepAirp CodeType="IATA">BCN</DepAirp>
153 <DepTerminal/>
154 <ArrAirp CodeType="IATA">MAD</ArrAirp>
155 <ArrTerminal/>
156 <OpAirline>UX</OpAirline>
157 <MarkAirline>SU</MarkAirline>
158 <FlightNumber>3403</FlightNumber>
159 <AircraftType>738</AircraftType>
160 <DepDateTime>2014-03-20T12:05:00</DepDateTime>
161 <ArrDateTime>2014-03-20T13:25:00</ArrDateTime>
162 <StopNum>0</StopNum>
163 <BookingCodes>
164 <BookingCode ClassType="economy">
165 <BookingCode>E</BookingCode>
166 </BookingCode>
167 </BookingCodes>
168 <FlightTime>80</FlightTime>
169 <TimeZone Departure="1" Arrival="1"/>
170 <ETicket>true</ETicket>
171 </Segment>
172 </Segments>
173 <PricingInfo Refundable="false">
174 <PassengerFare Type="ADT" Quantity="1">
175 <BaseFare Currency="EUR" Amount="165"/>
176 <EquiveFare Currency="RUB" Amount="8250"/>
177 <TotalFare Currency="RUB" Amount="13681"/>
178 <Taxes>
179 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
180 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
181 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
182 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
183 <Tax CurCode="RUB" TaxCode="JD" Amount="675"/>
184 <Tax CurCode="RUB" TaxCode="QV" Amount="186"/>
185 </Taxes>
186 <Tariffs/>
187 <FareCalc>MOW SU X/BCN SU MAD225.45NUC225.45END ROE0.731857</FareCalc>
188 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
189 </PassengerFare>
190 <PassengerFare Type="CNN" Quantity="1">
191 <BaseFare Currency="EUR" Amount="124"/>
192 <EquiveFare Currency="RUB" Amount="6200"/>
193 <TotalFare Currency="RUB" Amount="11631"/>
194 <Taxes>
195 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
196 <Tax CurCode="RUB" TaxCode="YQF" Amount="2100"/>
197 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
198 <Tax CurCode="RUB" TaxCode="YRI" Amount="185"/>
199 <Tax CurCode="RUB" TaxCode="JD" Amount="675"/>
200 <Tax CurCode="RUB" TaxCode="QV" Amount="186"/>
201 </Taxes>
202 <Tariffs/>
203 <FareCalc>MOW SU X/BCN SU MAD169.08NUC169.08END ROE0.731857</FareCalc>
204 <LastTicketDateTime>2014-03-09T23:59:59</LastTicketDateTime>
205 </PassengerFare>
206 </PricingInfo>
207 <Commission/>
208 <Charges Currency="RUB">0</Charges>
209 <TotalPrice Currency="RUB">25312</TotalPrice>
210 </Flight>
211 .........
212 <Flight>...</Flight>
213 </Flights>
214 <Errors xsi:nil="true"/>
215 </SearchFlights>
216 </Response>
217 </ResponseBin>
218 </ns1:searchResponse>
219 </SOAP-ENV:Body>
220 </SOAP-ENV:Envelope>
Перелет туда-обратно
Пример перелета туда-обратно: Москва — Париж, 2 взрослых, бизнес класс. Выдача с именами авиакомпаний, воздушных судов, аэропортов.
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:search>
5 <RequestBin>
6 <Request>
7 <SearchFlights LinkOnly="false">
8 <ODPairs Type="RT" Direct="false" AroundDates="0">
9 <!--Zero or more repetitions:-->
10 <ODPair>
11 <DepDate>2014-12-20</DepDate>
12 <DepAirp CodeType="IATA">MOW</DepAirp>
13 <ArrAirp CodeType="IATA">PAR</ArrAirp>
14 </ODPair>
15 <ODPair>
16 <DepDate>2014-12-21</DepDate>
17 <DepAirp CodeType="IATA">PAR</DepAirp>
18 <ArrAirp CodeType="IATA">MOW</ArrAirp>
19 </ODPair>
20 </ODPairs>
21 <Travellers>
22 <!--Zero or more repetitions:-->
23 <Traveller Type="ADT" Count="2"/>
24 </Travellers>
25 <Restrictions>
26 <ClassPref>business</ClassPref>
27 <OnlyAvail>false</OnlyAvail>
28 <AirVPrefs/>
29 <IncludePrivateFare>false</IncludePrivateFare>
30 <CurrencyCode>RUB</CurrencyCode>
31 </Restrictions>
32 </SearchFlights>
33 </Request>
34 <Source>
35 <ClientId>---</ClientId>
36 <APIKey>---</APIKey>
37 <Language>RU</Language>
38 <Currency>RUB</Currency>
39 <ShowNames>true</ShowNames>
40 </Source>
41 </RequestBin>
42 </ver:search>
43 </soapenv:Body>
44 </soapenv:Envelope>
Ответ
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://trunk.mlsd.ru/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:searchResponse>
4 <ResponseBin>
5 <Response>
6 <SearchFlights>
7 <Flights SearchId="190484987" ResultURL="http%3A%2F%2Ftst.nemo.travel%2F%3Fgo%3Dsearch%2Fview_results%26uid%3D190484987">
8 <Flight FlightId="372384680001">
9 <WebService>SABRE</WebService>
10 <ValCompany/>
11 <URL>http%3A%2F%2Ftst.nemo.travel%2F%3Fgo%3Dbooking%2Finfo%26uid%3D190484987%26flight%3D372384680001%26utm_source%3Dalias1</URL>
12 <Segments>
13 <Segment SegNum="1" SegGroupNum="0">
14 <DepAirp CodeType="IATA" Name="Шереметьево, Москва">SVO</DepAirp>
15 <DepTerminal xsi:nil="true"/>
16 <ArrAirp CodeType="IATA" Name="Белград, Никола Тесла">BEG</ArrAirp>
17 <ArrTerminal xsi:nil="true"/>
18 <OpAirline>JU</OpAirline>
19 <OpAirlineName>ДЖАТ Эйрвэйз</OpAirlineName>
20 <MarkAirline>JU</MarkAirline>
21 <MarkAirlineName>ДЖАТ Эйрвэйз</MarkAirlineName>
22 <FlightNumber>657</FlightNumber>
23 <AircraftName>Airbus 319</AircraftName>
24 <AircraftType>319</AircraftType>
25 <DepDateTime>2014-12-20T05:05:00</DepDateTime>
26 <ArrDateTime>2014-12-20T06:05:00</ArrDateTime>
27 <StopNum>0</StopNum>
28 <BookingCodes>
29 <BookingCode ClassType="business">
30 <BookingCode>W</BookingCode>
31 </BookingCode>
32 </BookingCodes>
33 <FlightTime>180</FlightTime>
34 <TimeZone Departure="3" Arrival="1"/>
35 <ETicket>true</ETicket>
36 </Segment>
37 <Segment SegNum="2" SegGroupNum="0">
38 <DepAirp CodeType="IATA" Name="Белград, Никола Тесла">BEG</DepAirp>
39 <DepTerminal xsi:nil="true"/>
40 <ArrAirp CodeType="IATA" Name="Шарль де Голль, Париж">CDG</ArrAirp>
41 <ArrTerminal xsi:nil="true"/>
42 <OpAirline>JU</OpAirline>
43 <OpAirlineName>ДЖАТ Эйрвэйз</OpAirlineName>
44 <MarkAirline>JU</MarkAirline>
45 <MarkAirlineName>ДЖАТ Эйрвэйз</MarkAirlineName>
46 <FlightNumber>314</FlightNumber>
47 <AircraftName>Airbus 320</AircraftName>
48 <AircraftType>320</AircraftType>
49 <DepDateTime>2014-12-20T17:10:00</DepDateTime>
50 <ArrDateTime>2014-12-20T19:50:00</ArrDateTime>
51 <StopNum>0</StopNum>
52 <BookingCodes>
53 <BookingCode ClassType="business">
54 <BookingCode>W</BookingCode>
55 </BookingCode>
56 </BookingCodes>
57 <FlightTime>160</FlightTime>
58 <TimeZone Departure="1" Arrival="1"/>
59 <ETicket>true</ETicket>
60 </Segment>
61 <Segment SegNum="3" SegGroupNum="1">
62 <DepAirp CodeType="IATA" Name="Шарль де Голль, Париж">CDG</DepAirp>
63 <DepTerminal xsi:nil="true"/>
64 <ArrAirp CodeType="IATA" Name="Белград, Никола Тесла">BEG</ArrAirp>
65 <ArrTerminal xsi:nil="true"/>
66 <OpAirline>JU</OpAirline>
67 <OpAirlineName>ДЖАТ Эйрвэйз</OpAirlineName>
68 <MarkAirline>JU</MarkAirline>
69 <MarkAirlineName>ДЖАТ Эйрвэйз</MarkAirlineName>
70 <FlightNumber>311</FlightNumber>
71 <AircraftName>Airbus 320</AircraftName>
72 <AircraftType>320</AircraftType>
73 <DepDateTime>2014-12-21T10:10:00</DepDateTime>
74 <ArrDateTime>2014-12-21T12:30:00</ArrDateTime>
75 <StopNum>0</StopNum>
76 <BookingCodes>
77 <BookingCode ClassType="business">
78 <BookingCode>W</BookingCode>
79 </BookingCode>
80 </BookingCodes>
81 <FlightTime>140</FlightTime>
82 <TimeZone Departure="1" Arrival="1"/>
83 <ETicket>true</ETicket>
84 </Segment>
85 <Segment SegNum="4" SegGroupNum="1">
86 <DepAirp CodeType="IATA" Name="Белград, Никола Тесла">BEG</DepAirp>
87 <DepTerminal xsi:nil="true"/>
88 <ArrAirp CodeType="IATA" Name="Шереметьево, Москва">SVO</ArrAirp>
89 <ArrTerminal xsi:nil="true"/>
90 <OpAirline>JU</OpAirline>
91 <OpAirlineName>ДЖАТ Эйрвэйз</OpAirlineName>
92 <MarkAirline>JU</MarkAirline>
93 <MarkAirlineName>ДЖАТ Эйрвэйз</MarkAirlineName>
94 <FlightNumber>656</FlightNumber>
95 <AircraftName>Airbus 319</AircraftName>
96 <AircraftType>319</AircraftType>
97 <DepDateTime>2014-12-21T23:20:00</DepDateTime>
98 <ArrDateTime>2014-12-22T04:10:00</ArrDateTime>
99 <StopNum>0</StopNum>
100 <BookingCodes>
101 <BookingCode ClassType="business">
102 <BookingCode>W</BookingCode>
103 </BookingCode>
104 </BookingCodes>
105 <FlightTime>170</FlightTime>
106 <TimeZone Departure="1" Arrival="3"/>
107 <ETicket>true</ETicket>
108 </Segment>
109 </Segments>
110 <PricingInfo Refundable="true">
111 <PassengerFare Type="ADT" Quantity="2">
112 <BaseFare Currency="EUR" Amount="620"/>
113 <EquiveFare Currency="RUB" Amount="34720"/>
114 <TotalFare Currency="RUB" Amount="44430"/>
115 <Taxes>
116 <Tax CurCode="RUB" TaxCode="YQF" Amount="1176"/>
117 <Tax CurCode="RUB" TaxCode="YQF" Amount="1176"/>
118 <Tax CurCode="RUB" TaxCode="YQF" Amount="1176"/>
119 <Tax CurCode="RUB" TaxCode="YQF" Amount="1176"/>
120 <Tax CurCode="RUB" TaxCode="RI" Amount="428"/>
121 <Tax CurCode="RUB" TaxCode="RI" Amount="428"/>
122 <Tax CurCode="RUB" TaxCode="UH" Amount="304"/>
123 <Tax CurCode="RUB" TaxCode="LG" Amount="185"/>
124 <Tax CurCode="RUB" TaxCode="LG" Amount="185"/>
125 <Tax CurCode="RUB" TaxCode="RS" Amount="224"/>
126 <Tax CurCode="RUB" TaxCode="RS" Amount="224"/>
127 <Tax CurCode="RUB" TaxCode="RF" Amount="55"/>
128 <Tax CurCode="RUB" TaxCode="RF" Amount="55"/>
129 <Tax CurCode="RUB" TaxCode="FR1" Amount="434"/>
130 <Tax CurCode="RUB" TaxCode="FR4" Amount="714"/>
131 <Tax CurCode="RUB" TaxCode="QX3" Amount="1546"/>
132 <Tax CurCode="RUB" TaxCode="IZ4" Amount="224"/>
133 </Taxes>
134 <Tariffs>
135 <Tariff Code="WRTRU" SegNum="4"/>
136 </Tariffs>
137 <FareCalc>MOW JU X/BEG JU PAR401.57JU X/BEG JU MOW401.57NUC803.14END ROE0.771963</FareCalc>
138 <LastTicketDateTime>2014-12-20T04:05:00</LastTicketDateTime>
139 </PassengerFare>
140 </PricingInfo>
141 <Commission/>
142 <Charges Currency="RUB">0</Charges>
143 <TotalPrice Currency="RUB">88860</TotalPrice>
144 </Flight>
145 .........
146 <Flight>...</Flight>
147 </Flights>
148 <Errors xsi:nil="true"/>
149 </SearchFlights>
150 </Response>
151 </ResponseBin>
152 </ns1:searchResponse>
153 </SOAP-ENV:Body>
154 </SOAP-ENV:Envelope>
Сложный маршрут
Пример сложного маршрута: Прага — Москва — Милан — Мадрид, 1 взрослый, 1 младенец, эконом класс. Выдача с именами авиакомпаний, воздушных судов, аэропортов.
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:search>
5 <RequestBin>
6 <Request>
7 <SearchFlights LinkOnly="false">
8 <ODPairs Type="CR" Direct="false" AroundDates="0">
9 <!--Zero or more repetitions:-->
10 <ODPair>
11 <DepDate>2014-12-20</DepDate>
12 <DepAirp CodeType="IATA">PRG</DepAirp>
13 <ArrAirp CodeType="IATA">MOW</ArrAirp>
14 </ODPair>
15 <ODPair>
16 <DepDate>2014-12-23</DepDate>
17 <DepAirp CodeType="IATA">MOW</DepAirp>
18 <ArrAirp CodeType="IATA">MIL</ArrAirp>
19 </ODPair>
20 <ODPair>
21 <DepDate>2014-12-27</DepDate>
22 <DepAirp CodeType="IATA">MIL</DepAirp>
23 <ArrAirp CodeType="IATA">MAD</ArrAirp>
24 </ODPair>
25 </ODPairs>
26 <Travellers>
27 <!--Zero or more repetitions:-->
28 <Traveller Type="ADT" Count="1"/>
29 <Traveller Type="INF" Count="1"/>
30 </Travellers>
31 <Restrictions>
32 <ClassPref>economy</ClassPref>
33 <OnlyAvail>false</OnlyAvail>
34 <AirVPrefs/>
35 <IncludePrivateFare>false</IncludePrivateFare>
36 <CurrencyCode>RUB</CurrencyCode>
37 </Restrictions>
38 </SearchFlights>
39 </Request>
40 <Source>
41 <ClientId>134</ClientId>
42 <APIKey>93632C10DA299034C03D742FB160C2D6</APIKey>
43 <Language>RU</Language>
44 <Currency>RUB</Currency>
45 <ShowNames>true</ShowNames>
46 </Source>
47 </RequestBin>
48 </ver:search>
49 </soapenv:Body>
50 </soapenv:Envelope>
Ответ
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://trunk.mlsd.ru/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:searchResponse>
4 <ResponseBin>
5 <Response>
6 <SearchFlights>
7 <Flights SearchId="190491108" ResultURL="http%3A%2F%2Ftst.nemo.travel%2F%3Fgo%3Dsearch%2Fview_results%26uid%3D190491108">
8 <Flight FlightId="372394480001">
9 <WebService>SABRE</WebService>
10 <ValCompany/>
11 <URL>http%3A%2F%2Ftst.nemo.travel%2F%3Fgo%3Dbooking%2Finfo%26uid%3D190491108%26flight%3D372394480001%26utm_source%3Dalias1</URL>
12 <Segments>
13 <Segment SegNum="1" SegGroupNum="0">
14 <DepAirp CodeType="IATA" Name="Прага">PRG</DepAirp>
15 <DepTerminal xsi:nil="true"/>
16 <ArrAirp CodeType="IATA" Name="Цюрих">ZRH</ArrAirp>
17 <ArrTerminal xsi:nil="true"/>
18 <OpAirline>LX</OpAirline>
19 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
20 <MarkAirline>LX</MarkAirline>
21 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
22 <FlightNumber>1485</FlightNumber>
23 <AircraftName>Avro RJ100</AircraftName>
24 <AircraftType>AR1</AircraftType>
25 <DepDateTime>2014-12-20T10:05:00</DepDateTime>
26 <ArrDateTime>2014-12-20T11:30:00</ArrDateTime>
27 <StopNum>0</StopNum>
28 <BookingCodes>
29 <BookingCode ClassType="economy">
30 <BookingCode>K</BookingCode>
31 </BookingCode>
32 </BookingCodes>
33 <FlightTime>85</FlightTime>
34 <TimeZone Departure="1" Arrival="1"/>
35 <ETicket>true</ETicket>
36 </Segment>
37 <Segment SegNum="2" SegGroupNum="0">
38 <DepAirp CodeType="IATA" Name="Цюрих">ZRH</DepAirp>
39 <DepTerminal xsi:nil="true"/>
40 <ArrAirp CodeType="IATA" Name="Домодедово, Москва">DME</ArrAirp>
41 <ArrTerminal xsi:nil="true"/>
42 <OpAirline>LX</OpAirline>
43 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
44 <MarkAirline>LX</MarkAirline>
45 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
46 <FlightNumber>1326</FlightNumber>
47 <AircraftName>Airbus 321</AircraftName>
48 <AircraftType>321</AircraftType>
49 <DepDateTime>2014-12-20T12:20:00</DepDateTime>
50 <ArrDateTime>2014-12-20T17:50:00</ArrDateTime>
51 <StopNum>0</StopNum>
52 <BookingCodes>
53 <BookingCode ClassType="economy">
54 <BookingCode>K</BookingCode>
55 </BookingCode>
56 </BookingCodes>
57 <FlightTime>210</FlightTime>
58 <TimeZone Departure="1" Arrival="3"/>
59 <ETicket>true</ETicket>
60 </Segment>
61 <Segment SegNum="3" SegGroupNum="1">
62 <DepAirp CodeType="IATA" Name="Домодедово, Москва">DME</DepAirp>
63 <DepTerminal xsi:nil="true"/>
64 <ArrAirp CodeType="IATA" Name="Цюрих">ZRH</ArrAirp>
65 <ArrTerminal xsi:nil="true"/>
66 <OpAirline>LX</OpAirline>
67 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
68 <MarkAirline>LX</MarkAirline>
69 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
70 <FlightNumber>1325</FlightNumber>
71 <AircraftName>Airbus 321</AircraftName>
72 <AircraftType>321</AircraftType>
73 <DepDateTime>2014-12-23T09:05:00</DepDateTime>
74 <ArrDateTime>2014-12-23T10:50:00</ArrDateTime>
75 <StopNum>0</StopNum>
76 <BookingCodes>
77 <BookingCode ClassType="economy">
78 <BookingCode>V</BookingCode>
79 </BookingCode>
80 </BookingCodes>
81 <FlightTime>225</FlightTime>
82 <TimeZone Departure="3" Arrival="1"/>
83 <ETicket>true</ETicket>
84 </Segment>
85 <Segment SegNum="4" SegGroupNum="1">
86 <DepAirp CodeType="IATA" Name="Цюрих">ZRH</DepAirp>
87 <DepTerminal xsi:nil="true"/>
88 <ArrAirp CodeType="IATA" Name="Мальпенса, Милан">MXP</ArrAirp>
89 <ArrTerminal xsi:nil="true"/>
90 <OpAirline>LX</OpAirline>
91 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
92 <MarkAirline>LX</MarkAirline>
93 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
94 <FlightNumber>1628</FlightNumber>
95 <AircraftName>Avro RJ100</AircraftName>
96 <AircraftType>AR1</AircraftType>
97 <DepDateTime>2014-12-23T12:25:00</DepDateTime>
98 <ArrDateTime>2014-12-23T13:20:00</ArrDateTime>
99 <StopNum>0</StopNum>
100 <BookingCodes>
101 <BookingCode ClassType="economy">
102 <BookingCode>K</BookingCode>
103 </BookingCode>
104 </BookingCodes>
105 <FlightTime>55</FlightTime>
106 <TimeZone Departure="1" Arrival="1"/>
107 <ETicket>true</ETicket>
108 </Segment>
109 <Segment SegNum="5" SegGroupNum="2">
110 <DepAirp CodeType="IATA" Name="Мальпенса, Милан">MXP</DepAirp>
111 <DepTerminal xsi:nil="true"/>
112 <ArrAirp CodeType="IATA" Name="Цюрих">ZRH</ArrAirp>
113 <ArrTerminal xsi:nil="true"/>
114 <OpAirline>LX</OpAirline>
115 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
116 <MarkAirline>LX</MarkAirline>
117 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
118 <FlightNumber>1639</FlightNumber>
119 <AircraftName>Avro RJ100</AircraftName>
120 <AircraftType>AR1</AircraftType>
121 <DepDateTime>2014-12-27T07:05:00</DepDateTime>
122 <ArrDateTime>2014-12-27T08:05:00</ArrDateTime>
123 <StopNum>0</StopNum>
124 <BookingCodes>
125 <BookingCode ClassType="economy">
126 <BookingCode>K</BookingCode>
127 </BookingCode>
128 </BookingCodes>
129 <FlightTime>60</FlightTime>
130 <TimeZone Departure="1" Arrival="1"/>
131 <ETicket>true</ETicket>
132 </Segment>
133 <Segment SegNum="6" SegGroupNum="2">
134 <DepAirp CodeType="IATA" Name="Цюрих">ZRH</DepAirp>
135 <DepTerminal xsi:nil="true"/>
136 <ArrAirp CodeType="IATA" Name="Мадрид">MAD</ArrAirp>
137 <ArrTerminal xsi:nil="true"/>
138 <OpAirline>LX</OpAirline>
139 <OpAirlineName>Свисс Интернешнл Эйрлайнз</OpAirlineName>
140 <MarkAirline>LX</MarkAirline>
141 <MarkAirlineName>Свисс Интернешнл Эйрлайнз</MarkAirlineName>
142 <FlightNumber>2026</FlightNumber>
143 <AircraftName/>
144 <AircraftType>32A</AircraftType>
145 <DepDateTime>2014-12-27T12:30:00</DepDateTime>
146 <ArrDateTime>2014-12-27T14:50:00</ArrDateTime>
147 <StopNum>0</StopNum>
148 <BookingCodes>
149 <BookingCode ClassType="economy">
150 <BookingCode>V</BookingCode>
151 </BookingCode>
152 </BookingCodes>
153 <FlightTime>140</FlightTime>
154 <TimeZone Departure="1" Arrival="1"/>
155 <ETicket>true</ETicket>
156 </Segment>
157 </Segments>
158 <PricingInfo Refundable="false">
159 <PassengerFare Type="ADT" Quantity="1">
160 <BaseFare Currency="CZK" Amount="8440"/>
161 <EquiveFare Currency="RUB" Amount="17305"/>
162 <TotalFare Currency="RUB" Amount="31456"/>
163 <Taxes>
164 <Tax CurCode="RUB" TaxCode="YQI" Amount="840"/>
165 <Tax CurCode="RUB" TaxCode="YQI" Amount="840"/>
166 <Tax CurCode="RUB" TaxCode="YQI" Amount="1960"/>
167 <Tax CurCode="RUB" TaxCode="YQI" Amount="840"/>
168 <Tax CurCode="RUB" TaxCode="YQI" Amount="840"/>
169 <Tax CurCode="RUB" TaxCode="YQI" Amount="1960"/>
170 <Tax CurCode="RUB" TaxCode="RI" Amount="378"/>
171 <Tax CurCode="RUB" TaxCode="RI" Amount="378"/>
172 <Tax CurCode="RUB" TaxCode="UH" Amount="284"/>
173 <Tax CurCode="RUB" TaxCode="CZ" Amount="1159"/>
174 <Tax CurCode="RUB" TaxCode="CH2" Amount="1112"/>
175 <Tax CurCode="RUB" TaxCode="CH2" Amount="1112"/>
176 <Tax CurCode="RUB" TaxCode="CH2" Amount="1112"/>
177 <Tax CurCode="RUB" TaxCode="EX" Amount="56"/>
178 <Tax CurCode="RUB" TaxCode="IT1" Amount="707"/>
179 <Tax CurCode="RUB" TaxCode="VT" Amount="142"/>
180 <Tax CurCode="RUB" TaxCode="HB" Amount="364"/>
181 <Tax CurCode="RUB" TaxCode="MJ" Amount="67"/>
182 </Taxes>
183 <Tariffs>
184 <Tariff Code="KNC29F3S" SegNum="2"/>
185 <Tariff Code="VNC28G2S" SegNum="6"/>
186 <Tariff Code="KNN2SSR" SegNum="5"/>
187 </Tariffs>
188 <FareCalc>PRG LX X/ZRH LX MOW28.06LX ZRH*LX MIL31.13LX ZRH31.13*LX MAD175.52 1S129.53NUC395.37END ROE21.3469</FareCalc>
189 <LastTicketDateTime>2014-12-20T11:05:00</LastTicketDateTime>
190 </PassengerFare>
191 <PassengerFare Type="INF" Quantity="1">
192 <BaseFare Currency="CZK" Amount="3333"/>
193 <EquiveFare Currency="RUB" Amount="6835"/>
194 <TotalFare Currency="RUB" Amount="6835"/>
195 <Taxes/>
196 <Tariffs>
197 <Tariff Code="KNC29F3S/IN90" SegNum="2"/>
198 <Tariff Code="VNC28G2S/IN90" SegNum="6"/>
199 <Tariff Code="KNN2SSR/IN90" SegNum="5"/>
200 </Tariffs>
201 <FareCalc>PRG LX X/ZRH LX MOW2.80LX ZRH*LX MIL3.11LX ZRH3.11*LX MAD17.55 1S129.53NUC156.10END ROE21.3469</FareCalc>
202 <LastTicketDateTime>2014-12-20T11:05:00</LastTicketDateTime>
203 </PassengerFare>
204 </PricingInfo>
205 <Commission/>
206 <Charges Currency="RUB">765.82</Charges>
207 <TotalPrice Currency="RUB">39056.82</TotalPrice>
208 </Flight>
209 .........
210 <Flight>...</Flight>
211 </Flights>
212 <Errors xsi:nil="true"/>
213 </SearchFlights>
214 </Response>
215 </ResponseBin>
216 </ns1:searchResponse>
217 </SOAP-ENV:Body>
218 </SOAP-ENV:Envelope>
API Поиска отелей
Агентский API Отелей - система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.
Динамические данные
Поиск
Сервис предназначен для получения списка отелей, удовлетворяющих условиям запроса. В условия запроса входят: идентификатор города, где будет вестись поиск; дата заезда и дата выезда; информация о количестве людей и способе их размещения в комнатах. Так же указываются дополнительные необязательные поля фильтров.
Для получения списка доступных городов, воспользуйтесь запросом на выгрузку статики (см. ССЫЛКА). Список допустимых отелей для фильтра также доступен через сервис (см. ССЫЛКА). Рекомендуется выгрузить все данные по отелям, городам и странам в локальную базу, для экономии времени и запросов.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:search>
6 <RequestBin>
7 <Request>
8 <HotelSearch>
9 <CityId>22046</CityId>
10 <DateBegin>2013-10-15</DateBegin>
11 <DateEnd>2013-10-18</DateEnd>
12 <Rooms>
13 <!--Zero or more repetitions:-->
14 <Room>
15 <Persons>
16 <!--Zero or more repetitions:-->
17 <Person Id="1" Type="ADT" Age="30"/>
18 <Person Id="2" Type="CLD" Age="10"/>
19 </Persons>
20 <!--Optional:-->
21 <DoubleBed>false</DoubleBed>
22 </Room>
23 <Room>
24 <Persons>
25 <!--Zero or more repetitions:-->
26 <Person Id="1" Type="ADT" Age="30"/>
27 </Persons>
28 </Room>
29 </Rooms>
30 <!--Optional:-->
31 <Filters>
32 <Hotels>
33 <!--Zero or more repetitions:-->
34 <!--<Id>123</Id>-->
35 </Hotels>
36 </Filters>
37 </HotelSearch>
38 </Request>
39 <Source>
40 <ClientId></ClientId>
41 <APIKey></APIKey>
42 <Language>ru</Language>
43 <Currency>RUB</Currency>
44 </Source>
45 </RequestBin>
46 </ver:search>
47 </soapenv:Body>
48 </soapenv:Envelope>
Элемент HotelSearch
| Элемент | Описание | Допустимые значения |
|---|---|---|
| CityId | Обязательный. Идентификатор города в системе Nemo. | Целое число |
| DateBegin | Обязательный. Дата заселения. | Формат гггг-мм-дд. |
| DateEnd | Обязательный. Дата выезда. | Формат гггг-мм-дд. |
| Rooms | Обязательный. Содержит массив запрашиваемых номеров/апартаментов. | Элемент Room. Максимум 4 элемента Room. |
| Filters | Необязательный. Содержит различные фильтры поиска отелей. | Элемент Hotels. |
Элемент Room
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Persons | Обязательный. Содержит данные о клиентах в номерах. | Элемент Person |
| DoubleBed | Необязательный. Может быть использован только если сумма количества детей и взрослых равна 2-м, а также
Если в запросе сумма детей и взрослых не равна 2, то данный элемент будет проигнорирован. |
true/false
true означает, что номер должен иметь двуспальную кровать |
Элемент Person
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Уникальный идентификатор. См. результаты бронирования. | Целое число |
| Атрибут Type | Тип клиента.
Если не указан, будет определен по возрасту Age. |
Константы:
ADT - взрослый CLD - ребенок 2-12 лет INF - младенец до 2х лет |
| Атрибут Age | Возраст. Обязателен для детей (CLD). | Целое число. Количество лет. |
Элемент Filters
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Hotels | Необязательный. Набор идентификаторов отелей в системе Nemo.
Результаты поиска будут ограничены только этими отелями. Данная опция может существенно ускорить поиск - рекомендуется всегда устанавливать при поиске конкретных отелей. |
Элемент Id – целое число |
Элемент Source
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ClientID | Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Целое число. |
| APIKey | Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Латинские буквы и цифры. Всего 32 символа. |
Ответ
Система по заданным параметрам ищет отели и возвращает результаты поиска. Все результаты поиска хранятся в базе Nemo определенный срок и доступны для бронирования по идентификатору CacheId.
Структура ответа - это набор уникальных отелей. У каждого указан Id - это идентификатор из базы Nemo. По нему можно получить дополнительную статичную информацию из путеводителя Nemo.
Каждый отель содержит:
- Набор номеров <Rooms>. Типы номеров (одноместный, двухместный и т.д.) : устанавливается автоматически по количеству клиентов из запроса.
- Сервисы <Services>. Каждый отель предлагает различные типы обслуживания в номерах. Цена и доступность может различаться.
- Категория <Categories>. Это допустимые комбинации номер + обслуживание. Для бронирования отеля пользователь должен выбрать одну из предлагаемых ему категорий.
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%3DHotelsSearch">
3 <SOAP-ENV:Body>
4 <ns1:searchResponse>
5 <ResponseBin>
6 <Response>
7 <HotelSearch>
8 <Hotels>
9 <Hotel Id="1872666">
10 <Supplier>GTA</Supplier>
11 <CityId>22046</CityId>
12 <DateBegin>2013-10-15</DateBegin>
13 <DateEnd>2013-10-18</DateEnd>
14 <CacheId>1872666</CacheId>
15 <Name>ADLON KEMPINSKI</Name>
16 <Categories>
17 <Category Id="1">
18 <Rooms>
19 <Room Count="1" Id="1" ServiceId="1"/>
20 <Room Count="1" Id="2" ServiceId="2"/>
21 </Rooms>
22 <TotalPrice Currency="RUB">74733.84</TotalPrice>
23 </Category>
24 </Categories>
25 <Services>
26 <Service Id="1" Status="OK">
27 <Desc>Standard Twin</Desc>
28 <Meal>Full Breakfast</Meal>
29 <Price/>
30 </Service>
31 <Service Id="2" Status="OK">
32 <Desc>Standard Twin</Desc>
33 <Meal>Full Breakfast</Meal>
34 <Price/>
35 </Service>
36 </Services>
37 <Rooms>
38 <Room Id="1" Type="TWIN"/>
39 <Room Id="2" Type="SNGL"/>
40 </Rooms>
41 </Hotel>
42 ...
43 </Hotels>
44 </HotelSearch>
45 </Response>
46 </ResponseBin>
47 </ns1:searchResponse>
48 </SOAP-ENV:Body>
49 </SOAP-ENV:Envelope>
Элемент Hotel
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор отеля как одного из результатов поиска в системе Nemo. | Целое число. |
| Supplier | Обязательный. Тип поставщика, в котором найден отель. | Строка.
Возможные значения: GTA HOTELBEDS DOTW SERHS MIKI TRAVCO ACADEM TOURICO |
| CityId | Обязательный. Идентификатор города в системе Nemo. | Целое число. |
| CacheId | Обязательный. Идентификатор результата поиска для данного отеля в системе Nemo. | Целое число. |
| Name | Обязательный. Название отеля. | Строка в произвольном формате. |
| Services | Обязательный. Услуги в отеле. | Элемент Service |
| Rooms | Обязательный. Комнаты в отеле. | Элемент Room |
| Categories | Обязательный. Категории, доступные для бронирования в отеле. | Элемент Category |
Элемент Service
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор услуги. | Целое число |
| Атрибут Status | Обязательный. Доступность отеля. ОК означает доступен (мгновенное подтверждение).
RQ - недоступен (по запросу). |
ОК/RQ |
| Desc | Необязательный. Описание отеля. | Строка в произвольном формате. |
| Meal | Обязательный. Питание для данного сервиса. | Строка в произвольном формате. |
| Price | Необязательный. Указывает на стоимость номера с данной услугой. | Вещественное число.
Атрибут Currency - код валюты. |
Элемент Room
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор комнаты в отеле. | Целое число. |
| Type | Обязательный. Тип номера. | Строка. Возможные значения:
SNGL – одноместный DBL – двухместный с двухспальной кроватью TWIN – двухместный с двумя кроватями TRIP – трёхместный QUAD – четырёхместный |
Элемент Category
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор категории. | Целое число. |
| Rooms | Обязательный. Массив комнат с соответствием услуг. | Целое число. |
| Room | Атрибут: Count
Обязательный. Количество комнат данного типа. Атрибут: Id Обязательный. Идентификатор комнаты из атрибута Id в элементе Hotel-> Rooms-> Room. Атрибут: ServiceId - Идентификатор услуги из атрибута Id элемента Service. |
Целое число.
Целое число. Целое число. |
| TotalPrice | Обязательный. Суммарная стоимость бронируемого сочетания “Комнаты - услуги”. | Вещественное число.
Атрибут Currency - код валюты. |
Расширенная информация по одному отелю
Сервис получения дополнительной информации об отеле требует указания идентификатора отеля в системе Nemo и категории.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:extInfo>
6 <RequestBin>
7 <Request>
8 <HotelExtInfo>
9 <Item>
10 <CacheId>1867246</CacheId>
11 <!--Optional:-->
12 <CategoryId>1</CategoryId>
13 </Item>
14 </HotelExtInfo>
15 </Request>
16 <Source>
17 <ClientId></ClientId>
18 <APIKey></APIKey>
19 <Language>ru</Language>
20 <Currency>RUB</Currency>
21 </Source>
22 </RequestBin>
23 </ver:extInfo>
24 </soapenv:Body>
25 </soapenv:Envelope>
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| CacheId | Обязательный. Идентификатор результата поиска. | Целое число |
| CategoryId | ID выбранной категории. | Целое число |
Элемент 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%3DHotelExtInfo"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
4 <SOAP-ENV:Body>
5 <ns1:extInfoResponse>
6 <ResponseBin>
7 <Response>
8 <HotelExtInfo>
9 <CategoryId>1</CategoryId>
10 <PriceInfo>
11 <PriceBreakDown>
12 <Date>
13 <From>2013-10-15</From>
14 <To>2013-10-18</To>
15 <Price Currency="RUB">12455.64</Price>
16 </Date>
17 <Date>
18 <From>2013-10-15</From>
19 <To>2013-10-18</To>
20 <Price Currency="RUB">12455.64</Price>
21 </Date>
22 </PriceBreakDown>
23 <Netto Currency="EUR">1821</Netto>
24 <Gross xsi:nil="true"/>
25 </PriceInfo>
26 </HotelExtInfo>
27 </Response>
28 </ResponseBin>
29 </ns1:extInfoResponse>
30 </SOAP-ENV:Body>
31 </SOAP-ENV:Envelope>
Элемент HotelExtInfo
| Элемент | Описание | Допустимые значения |
|---|---|---|
| CategoryId | Обязательный. Идентификатор категории. | Целое число |
| PriceInfo | Обязательный. Элемент содержащий информацию о цене | см. Элемент PriceInfo |
Элемент PriceInfo
| Элемент | Описание | Допустимые значения |
|---|---|---|
|
PriceBreakDown |
Необязательный. Информация о ценах, расписанная по каждому дню. |
Список элементов Date |
| Netto | Обязательный. Стоимость от поставщика. | Вещественное число.
Атрибут Currency - код валюты. |
| Gross | Обязательный. Общая стоимость. | Вещественное число.
Атрибут Currency - код валюты. |
Элемент Date
| Элемент | Описание | Допустимые значения |
|---|---|---|
| From | Обязательный. Дата начала действия тарифа | Формат гггг-мм-дд |
| To | Обязательный. Дата окончания действия тарифа | Формат гггг-мм-дд |
| Price | Цена за одну ночь. | Вещественное число.
Атрибут Currency - код валюты. |
Штрафы за аннуляцию
Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.
Штрафы получаются по каждой услуге отдельным запросом. Нужно указать тип услуги, идентификатор результата поиска и выбранную категорию.
Внимание. Для отелей из Hotelbeds (Supplier=HOTELBEDS) штрафы до бронирования получить невозможно.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:penalty>
6 <RequestBin>
7 <Request>
8 <Penalty>
9 <Item>
10 <Type>HOTELS</Type>
11 <CacheId>1867246</CacheId>
12 <CategoryId>1</CategoryId>
13 </Item>
14 </Penalty>
15 </Request>
16 <Source>
17 <ClientId></ClientId>
18 <APIKey></APIKey>
19 <Language>ru</Language>
20 <Currency>RUB</Currency>
21 </Source>
22 </RequestBin>
23 </ver:penalty>
24 </soapenv:Body>
25 </soapenv:Envelope>
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Type | Обязательный. Тип объекта. | HOTELS |
| CacheId | Обязательный. Идентификатор результата поиска в системе Nemo. | Целое число |
| CategoryId | Обязательный. Идентификатор категории. | Целое число |
Элемент Source
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ClientID | Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Целое число. |
| APIKey | Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Латинские буквы и цифры. Всего 32 символа. |
Ответ
1 <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">
2 <SOAP-ENV:Body>
3 <ns1:penaltyResponse>
4 <ResponseBin>
5 <Response>
6 <Penalty>
7 <ItemDateBegin>2013-10-15 00:00:00</ItemDateBegin>
8 <CancelCharges>
9 <Charge>
10 <DateFrom>2013-10-12 00:00:00</DateFrom>
11 <DateTo>2013-10-15 23:59:59</DateTo>
12 <Money Currency="RUB">74733.84</Money>
13 </Charge>
14 <Charge>
15 <DateFrom>2013-09-23 00:00:00</DateFrom>
16 <DateTo>2013-10-11 00:00:00</DateTo>
17 <Money Currency="RUB">67260.46</Money>
18 </Charge>
19 <Charge>
20 <DateFrom>2013-08-01 17:59:00</DateFrom>
21 <DateTo>2013-09-22 00:00:00</DateTo>
22 <Money Currency="RUB">12455.64</Money>
23 </Charge>
24 </CancelCharges>
25 <ModifyCharges/>
26 </Penalty>
27 </Response>
28 </ResponseBin>
29 </ns1:penaltyResponse>
30 </SOAP-ENV:Body>
31 </SOAP-ENV:Envelope>
Элемент Penalty
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ItemDateBegin | Обязательный. Дата начала услуги (дата заселения в отель). | Формат гггг-мм-дд чч:мм:сс |
| CancelCharges | Необязательный. Содержит информацию о штрафах за аннуляцию. | Элемент Charge |
| ModifyCharges | Необязательный. Содержит информацию о штрафах за модификацию. | Элемент Charge |
Штрафы разбиваются по временным интервалам. На каждом интервале указывается значение штрафа.
Элемент Charge
| Элемент | Описание | Допустимые значения |
|---|---|---|
| DateFrom | Обязательный. Дата/время начала интервала. | Формат гггг-мм-дд чч:мм:сс |
| DateTo | Необязательный. Дата/время окончания интервала. | Формат гггг-мм-дд чч:мм:сс |
| Money | Обязательный. Сумма штрафа. | Вещественное число.
Атрибут: Currency - код валюты. |
Бронирование
Запрос
Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.
Сейчас же необходимо указывать только 1 услугу-отель (элемент Item) в запросе на бронирование.
Для успешного запроса нужно указать:
- Услугу. В запросе не требуется перечислять все параметры из результатов поиска, достаточно указать уникальный ID результата.
- Информация о клиентах. Все клиенты перечисляются в отдельной ветке и нумеруются по порядку. Указатели (элементы с номером клиента), также добавляются в описание услуги.
- Заказчик. Указатель на одну персону.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:booking>
6 <RequestBin>
7 <Request>
8 <Booking>
9 <Items>
10 <!--Zero or more repetitions:-->
11 <Item>
12 <!--You have a CHOICE of the next 3 items at this level-->
13 <HotelBookData>
14 <CacheId>1872666</CacheId>
15 <CategoryId>1</CategoryId>
16 <Rooms>
17 <!--Zero or more repetitions:-->
18 <Room Id="2">
19 <Persons>
20 <!--Zero or more repetitions:-->
21 <Person Number="1"/>
22 <Person Number="2"/>
23 </Persons>
24 </Room>
25 <Room Id="1">
26 <Persons>
27 <!--Zero or more repetitions:-->
28 <Person Number="3"/>
29 </Persons>
30 </Room>
31 </Rooms>
32 </HotelBookData>
33 <Customer>
34 <Person Number="1"/>
35 </Customer>
36 </Item>
37 </Items>
38 <Persons>
39 <!--Zero or more repetitions:-->
40 <Person Number="1" Type="ADT">
41 <!--Optional:-->
42 <Lastname>IVANOV</Lastname>
43 <!--Optional:-->
44 <Name>IVAN</Name>
45 <!--Optional:-->
46 <Middlename>IVANOVICH</Middlename>
47 <!--Optional:-->
48 <DateOfBirth>1987-12-12</DateOfBirth>
49 <!--Optional:-->
50 <Phone>+79871231212</Phone>
51 <!--Optional:-->
52 <Email>m.rudenko@mute-lab.com</Email>
53 <!--Optional:-->
54 <Gender>MR</Gender>
55 <!--Optional:-->
56 <Document Type="P">
57 <Series>1811</Series>
58 <Number>912219</Number>
59 <!--Optional:-->
60 <IssueDate>2012-12-12</IssueDate>
61 <!--Optional:-->
62 <ExpiryDate>2014-12-12</ExpiryDate>
63 </Document>
64 </Person>
65 <Person Number="2" Type="CHD">
66 <!--Optional:-->
67 <Lastname>PETROV</Lastname>
68 <!--Optional:-->
69 <Name>IVAN</Name>
70 <!--Optional:-->
71 <Middlename>MIKHAILOVICH</Middlename>
72 <!--Optional:-->
73 <DateOfBirth>2008-12-12</DateOfBirth>
74 <!--Optional:-->
75 <Phone>+79871231212</Phone>
76 <!--Optional:-->
77 <Email>m.rudenko@mute-lab.com</Email>
78 <!--Optional:-->
79 <Gender>MR</Gender>
80 <!--Optional:-->
81 <Document Type="P">
82 <Series>1866</Series>
83 <Number>913319</Number>
84 <!--Optional:-->
85 <IssueDate>2012-12-12</IssueDate>
86 <!--Optional:-->
87 <ExpiryDate>2014-12-12</ExpiryDate>
88 </Document>
89 </Person>
90 <Person Number="3" Type="ADT">
91 <!--Optional:-->
92 <Lastname>SIDOROV</Lastname>
93 <!--Optional:-->
94 <Name>IVAN</Name>
95 <!--Optional:-->
96 <Middlename>SERGEEVICH</Middlename>
97 <!--Optional:-->
98 <DateOfBirth>1987-12-12</DateOfBirth>
99 <!--Optional:-->
100 <Phone>+79871231212</Phone>
101 <!--Optional:-->
102 <Email>m.rudenko@mute-lab.com</Email>
103 <!--Optional:-->
104 <Gender>MR</Gender>
105 <!--Optional:-->
106 <Document Type="P">
107 <Series>1866</Series>
108 <Number>913319</Number>
109 <!--Optional:-->
110 <IssueDate>2012-12-12</IssueDate>
111 <!--Optional:-->
112 <ExpiryDate>2014-12-12</ExpiryDate>
113 </Document>
114 </Person>
115 </Persons>
116 </Booking>
117 </Request>
118 <Source>
119 <ClientId></ClientId>
120 <APIKey></APIKey>
121 <Language>ru</Language>
122 <Currency>RUB</Currency>
123 </Source>
124 </RequestBin>
125 </ver:booking>
126 </soapenv:Body>
127 </soapenv:Envelope>
Элемент Booking
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Items | Обязательный. Массив элементов Item. | Элемент Item |
| Customer | Обязательный. Элемент установки заказчика. | |
| Persons | Обязательный. Массив клиентов. |
Данные об услугах записываются в элементы <Item>.
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| HotelBookData | Обязательный. В зависимости от типа объекта бронирования. В данный момент возможно указать только данные для отеля. | |
| Persons | Необязательный. Привязка клиентов к услуге. Если не указаны, будут привязаны все из указанных в главном элементе Booking. | [<Person Number="1" />] |
Бронирование отеля. Для бронирования отеля необходимы следующие параметры:
- ID результата поиска - один отель
- ID выбранной категории этого отеля
- Распределение клиентов по комнатам.
Элемент HotelBookData
| Элемент | Описание | Допустимые значения |
|---|---|---|
| CacheId | Обязательный. Идентификатор результата поиска для данного отеля в системе Nemo. | Целое число |
| CategoryId | Обязательный. Идентификатор категории. | Целое число |
| Rooms | Обязательный. Распределение клиентов по комнатам. | Список элементов Room |
| Room | Атрибут Id
Ид комнаты из результата поиска Элемент Persons |
Целое число |
| Persons | Обязательный.
Список людей |
Список элементов Person |
| Person | Обязательный.
Атрибут Number Номер пассажира из Booking ->Persons->Person->Number |
Целое число |
Информация о клиентах. Для успешного завершения бронирования нужно указать как минимум одного клиента. Максимальное число клиентов в текущей версии не ограничено.
Набор обязательных данных может меняться в зависимости от типов услуг в бронировании. Рекомендуемый набор обязательных параметров: Lastname, Name, DateOfBirth. Остальные обязательные параметры будут устанавливаться индивидуально при подключении к сервису.
Элемент Person
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Number | Обязательный. Номер клиента, необходим для правильной привязки к услугам. | Целое число |
| Type | Обязательный.
Тип пассажира. |
Строка.
Возможные значения: ADT CLD INF |
| Lastname | Фамилия. | Строка в произвольном формате. |
| Name | Имя. | Строка в произвольном формате. |
| Middlename | Отчество. | Строка в произвольном формате. |
| DateOfBirth | Дата рождения. | Формат гггг-мм-дд. |
| Phone | Телефон.
Рекомендуемый формат: +79871234567 |
Строка |
| Электронный адрес. | Строка | |
| Gender | Пол. | MR - мужчина,
MS - женщина. |
| Document | Документ | Элемент Document |
Для некоторых услуг может потребоваться информация о документах.
Элемент Document
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Type | Обязательный. Тип документа. | P - загранпаспорт
C - внутренний гражданский паспорт B - свидетельство о рождении |
| Series | Необязательный. Серия документа. Можно указать слитно с номером в Number. | Строка в произвольном формате |
| Number | Обязательный. Номер документа. | Строка в произвольном формате |
| IssueDate | Необязательный. Дата выдачи документа. | Формат гггг-мм-дд |
| ExpiryDate | Необязательный. Дата истечения срока действия документа. | Формат гггг-мм-дд |
Элемент Source
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ClientID | Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Целое число. |
| APIKey | Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Латинские буквы и цифры. Всего 32 символа. |
Ответ
После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы <Status> всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.
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%3DBooking"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
4 <SOAP-ENV:Body>
5 <ns1:bookingResponse>
6 <ResponseBin>
7 <Response>
8 <Booking>
9 <Items>
10 <Item Id="386610">
11 <Hotel Id="1872666">
12 <Supplier>GTA</Supplier>
13 <CityId>22046</CityId>
14 <DateBegin>2013-10-15</DateBegin>
15 <DateEnd>2013-10-18</DateEnd>
16 <CacheId>1872666</CacheId>
17 <Name>ADLON KEMPINSKI</Name>
18 <Categories>
19 <Category Id="1">
20 <Rooms>
21 <Room Count="1" Id="1" ServiceId="1"/>
22 <Room Count="1" Id="2" ServiceId="2"/>
23 </Rooms>
24 <TotalPrice Currency="RUB">74733.84</TotalPrice>
25 </Category>
26 </Categories>
27 <Services>
28 <Service Id="1" Status="OK">
29 <Desc>Standard Twin</Desc>
30 <Meal>Full Breakfast</Meal>
31 <Price Currency="RUB">37366.92</Price>
32 </Service>
33 <Service Id="2" Status="OK">
34 <Desc>Standard Twin</Desc>
35 <Meal>Full Breakfast</Meal>
36 <Price Currency="RUB">37366.92</Price>
37 </Service>
38 </Services>
39 <Rooms>
40 <Room Id="1" Type="TWIN"/>
41 <Room Id="2" Type="SNGL"/>
42 </Rooms>
43 </Hotel>
44 <Type>HOTELS</Type>
45 <Status>waiting</Status>
46 <Prices>
47 <Price Currency="RUB">74733.84</Price>
48 <Charges Currency="RUB">0</Charges>
49 <Commission Currency="RUB">0</Commission>
50 <Penalty Currency="RUB">0</Penalty>
51 <TotalPrice Currency="RUB">74733.84</TotalPrice>
52 </Prices>
53 <Dates>
54 <BookingDate>2013-08-01 19:49:56</BookingDate>
55 <UpdateDate>2013-08-01 19:49:57</UpdateDate>
56 <CancelDate xsi:nil="true"/>
57 <PenaltyDate>2013-07-31 19:10:37</PenaltyDate>
58 <AutoCancelDate>2013-08-01 19:51:56</AutoCancelDate>
59 <ConfirmationLimit/>
60 </Dates>
61 <Statuses>
62 <PaymentStatus>1</PaymentStatus>
63 <DocumentStatus>1</DocumentStatus>
64 <DeliveryStatus>1</DeliveryStatus>
65 <InvoiceStatus>1</InvoiceStatus>
66 <ProblemStatus>1</ProblemStatus>
67 </Statuses>
68 <Customer>
69 <Person Number="1"/>
70 </Customer>
71 <Persons>
72 <Person Number="1"/>
73 <Person Number="2"/>
74 <Person Number="3"/>
75 </Persons>
76 </Item>
77 </Items>
78 <Persons>
79 <Person Number="1">
80 <Lastname>IVANOV</Lastname>
81 <Name>IVAN</Name>
82 <Middlename>IVANOVICH</Middlename>
83 <DateOfBirth xsi:nil="true"/>
84 <Phone>+79871231212</Phone>
85 <Email>m.rudenko@mute-lab.com</Email>
86 <Gender xsi:nil="true"/>
87 <Document Type="P">
88 <Series>1811</Series>
89 <Number>912219</Number>
90 <IssueDate>2012-12-12 00:00:00</IssueDate>
91 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
92 </Document>
93 </Person>
94 <Person Number="2">
95 <Lastname>PETROV</Lastname>
96 <Name>IVAN</Name>
97 <Middlename>MIKHAILOVICH</Middlename>
98 <DateOfBirth xsi:nil="true"/>
99 <Phone>+79871231212</Phone>
100 <Email>m.rudenko@mute-lab.com</Email>
101 <Gender xsi:nil="true"/>
102 <Document Type="P">
103 <Series>1866</Series>
104 <Number>913319</Number>
105 <IssueDate>2012-12-12 00:00:00</IssueDate>
106 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
107 </Document>
108 </Person>
109 <Person Number="3">
110 <Lastname>SIDOROV</Lastname>
111 <Name>IVAN</Name>
112 <Middlename>SERGEEVICH</Middlename>
113 <DateOfBirth xsi:nil="true"/>
114 <Phone>+79871231212</Phone>
115 <Email>m.rudenko@mute-lab.com</Email>
116 <Gender xsi:nil="true"/>
117 <Document Type="P">
118 <Series>1866</Series>
119 <Number>913319</Number>
120 <IssueDate>2012-12-12 00:00:00</IssueDate>
121 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
122 </Document>
123 </Person>
124 </Persons>
125 </Booking>
126 </Response>
127 </ResponseBin>
128 </ns1:bookingResponse>
129 </SOAP-ENV:Body>
130 </SOAP-ENV:Envelope>
Структура ответа очень похожа на запрос. Выделяются те же основные элементы.
Элемент Booking
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Items | Обязательный. Содержит элемент(ы) Item. | Элемент Item |
| Persons | Обязательный. Здесь перечислены все клиенты заказа. | Элемент Person |
В элементах Item раскрывается подробнейшая информация об одной услуге в бронировании.
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный.
Номер заказа в системе Nemo. |
Целое число |
| Type | Обязательный.
Тип объекта бронирования. |
HOTELS |
| Status | Обязательный. Статус объекта бронирования . | booked - забронирован
cancelled - аннулирован pending confirmation - в процессе подтверждения pending – произошла попытка бронирования, которое не было завершено waiting – ожидается результат запроса на бронирование |
| Prices | Обязательный. Данные о ценах. | см. Элемент Prices |
| Dates | Обязательный. Данные о датах. | см. Элемент Dates |
| Statuses | Обязательный. Различные дополнительные статусы заказанной услуги. | см. Элемент Statuses |
| Persons | Обязательный. Содержит клиентов привязанных к услуге. | элементы Person |
| Hotel | Необязательный. Элемент с данными об отеле. | см. элемент Hotel (результат поиска отеля) |
Информация о цене услуги вынесена в отдельную ветку:
Элемент Prices
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Price | Обязательный. Базовая цена услуги. | Вещественное число.
Атрибут Currency - код валюты. |
| Charges | Необязательный. Сумма дополнительных сборов. | Вещественное число.
Атрибут Currency - код валюты. |
| Commission | Необязательный. Сумма комиссий (вычитается из общей стоимости). | Вещественное число.
Атрибут Currency - код валюты. |
| Penalty | Необязательный. Сумма штрафов. | Вещественное число.
Атрибут Currency - код валюты. |
| TotalPrice | Обязательный. Итоговая стоимость.
= Price + Charges + Commission |
Вещественное число.
Атрибут Currency - код валюты. |
Информация о датах услуги также вынесена в отдельную ветку:
Элемент Dates
| Элемент | Описание | Допустимые значения |
|---|---|---|
| BookingDate | Обязательный. Дата бронирования. | Формат гггг-мм-дд чч:мм:сс |
| UpdateDate | Необязательный. Дата обновления. | Формат гггг-мм-дд чч:мм:сс |
| CancelDate | Необязательный. Дата аннуляции. | Формат гггг-мм-дд чч:мм:сс |
| PenaltyDate | Необязательный. Дата наступления штрафов. | Формат гггг-мм-дд чч:мм:сс |
| AutoCancelDate | Необязательный. Дата автоаннулирования. | Формат гггг-мм-дд чч:мм:сс |
Дополнительные статусы:
Элемент Statuses
| Элемент | Описание | Допустимые значения |
|---|---|---|
| PaymentStatus | Необязательный.
Статус оплаты. |
Целое число
1 - неоплачено 2 - частично оплачено 3 - оплачено |
| DocumentStatus | Необязательный.
Статус ваучера. |
Целое число
1 - документ не сформирован 2 - документ сформирован |
| DeliveryStatus | Необязательный.
Статус доставки. |
Целое число
1 - не доставлен 2 - доставлен |
| InvoiceStatus | Необязательный.
Статус счета. |
Целое число
1 - счет выставлен. 2 - счет не выставлен. |
Информация о клиентах заказа полностью повторяет структуру запроса.
Подтверждение бронирования
Запрос
Подтверждение бронирования заказа.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=ConfirmBooking
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DConfirmBooking">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:confirm>
5 <RequestBin>
6 <Request>
7 <BookingId>179547</BookingId>
8 </Request>
9 <Source>
10 <ClientId></ClientId>
11 <APIKey></APIKey>
12 <Language>ru</Language>
13 <Currency>RUB</Currency>
14 </Source>
15 </RequestBin>
16 </ver:confirm>
17 </soapenv:Body>
18 </soapenv:Envelope>
Элемент Request
| Элемент | Описание | Допустимые значения |
|---|---|---|
| BookingID | Обязательный. Идентификатор заказа в системе Nemo. | Целое число |
Элемент Source
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ClientID | Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Целое число. |
| APIKey | Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Латинские буквы и цифры. Всего 32 символа. |
Ответ
1 <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">
2 <SOAP-ENV:Body>
3 <ns1:confirmResponse>
4 <ResponseBin>
5 <Response>
6 <Books>
7 <Book>
8 <Id>179547</Id>
9 <Status>booked</Status>
10 </Book>
11 </Books>
12 </Response>
13 </ResponseBin>
14 </ns1:confirmResponse>
15 </SOAP-ENV:Body>
16 </SOAP-ENV:Envelope>
Выгрузка актуальных данных по заказу(ам)
Используется для экспорта бронирований и для обновления данных в локальной клиентской базе.
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Export
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DExport">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:export>
6 <RequestBin>
7 <Request>
8 <Export>
9 <Items>
10 <!--Zero or more repetitions:-->
11 <Item Id="386621"/>
12 </Items>
13 </Export>
14 </Request>
15 <Source>
16 <ClientId></ClientId>
17 <APIKey></APIKey>
18 <Language>ru</Language>
19 <Currency>RUB</Currency>
20 </Source>
21 </RequestBin>
22 </ver:export>
23 </soapenv:Body>
24 </soapenv:Envelope>
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор заказа в системе Nemo. | Целое число |
Элемент 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%3DExport"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
4 <SOAP-ENV:Body>
5 <ns1:exportResponse>
6 <ResponseBin>
7 <Response>
8 <Export>
9 <Items>
10 <Item Id="386621">
11 <Hotel Id="1872666">
12 <Supplier>GTA</Supplier>
13 <CityId>22046</CityId>
14 <DateBegin>2013-10-15</DateBegin>
15 <DateEnd>2013-10-18</DateEnd>
16 <CacheId>1872666</CacheId>
17 <Name>ADLON KEMPINSKI</Name>
18 <Categories>
19 <Category Id="1">
20 <Rooms>
21 <Room Count="1" Id="1" ServiceId="1"/>
22 <Room Count="1" Id="2" ServiceId="2"/>
23 </Rooms>
24 <TotalPrice Currency="RUB">74733.84</TotalPrice>
25 </Category>
26 </Categories>
27 <Services>
28 <Service Id="1" Status="OK">
29 <Desc>Standard Twin</Desc>
30 <Meal>Full Breakfast</Meal>
31 <Price Currency="RUB">37366.92</Price>
32 </Service>
33 <Service Id="2" Status="OK">
34 <Desc>Standard Twin</Desc>
35 <Meal>Full Breakfast</Meal>
36 <Price Currency="RUB">37366.92</Price>
37 </Service>
38 </Services>
39 <Rooms>
40 <Room Id="1" Type="TWIN"/>
41 <Room Id="2" Type="SNGL"/>
42 </Rooms>
43 </Hotel>
44 <Type>HOTELS</Type>
45 <Status>waiting</Status>
46 <Prices>
47 <Price Currency="RUB">74733.84</Price>
48 <Charges Currency="RUB">0</Charges>
49 <Commission Currency="RUB">0</Commission>
50 <Penalty Currency="RUB">0</Penalty>
51 <TotalPrice Currency="RUB">74733.84</TotalPrice>
52 </Prices>
53 <Dates>
54 <BookingDate>2013-08-01 20:21:47</BookingDate>
55 <UpdateDate>2013-08-01 20:35:01</UpdateDate>
56 <CancelDate xsi:nil="true"/>
57 <PenaltyDate>2013-07-31 19:10:37</PenaltyDate>
58 <AutoCancelDate>2013-08-01 20:23:47</AutoCancelDate>
59 <ConfirmationLimit/>
60 </Dates>
61 <Statuses>
62 <PaymentStatus>1</PaymentStatus>
63 <DocumentStatus>1</DocumentStatus>
64 <DeliveryStatus>1</DeliveryStatus>
65 <InvoiceStatus>1</InvoiceStatus>
66 <ProblemStatus>1</ProblemStatus>
67 </Statuses>
68 <Customer>
69 <Person Number="1"/>
70 </Customer>
71 <Persons>
72 <Person Number="1"/>
73 <Person Number="2"/>
74 <Person Number="3"/>
75 </Persons>
76 </Item>
77 </Items>
78 <Persons>
79 <Person Number="1">
80 <Lastname>IVANOV</Lastname>
81 <Name>IVAN</Name>
82 <Middlename>IVANOVICH</Middlename>
83 <DateOfBirth xsi:nil="true"/>
84 <Phone>+79871231212</Phone>
85 <Email>m.rudenko@mute-lab.com</Email>
86 <Gender xsi:nil="true"/>
87 <Document Type="P">
88 <Series>1811</Series>
89 <Number>912219</Number>
90 <IssueDate>2012-12-12 00:00:00</IssueDate>
91 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
92 </Document>
93 </Person>
94 <Person Number="2">
95 <Lastname>PETROV</Lastname>
96 <Name>IVAN</Name>
97 <Middlename>MIKHAILOVICH</Middlename>
98 <DateOfBirth xsi:nil="true"/>
99 <Phone>+79871231212</Phone>
100 <Email>m.rudenko@mute-lab.com</Email>
101 <Gender xsi:nil="true"/>
102 <Document Type="P">
103 <Series>1866</Series>
104 <Number>913319</Number>
105 <IssueDate>2012-12-12 00:00:00</IssueDate>
106 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
107 </Document>
108 </Person>
109 <Person Number="3">
110 <Lastname>SIDOROV</Lastname>
111 <Name>IVAN</Name>
112 <Middlename>SERGEEVICH</Middlename>
113 <DateOfBirth xsi:nil="true"/>
114 <Phone>+79871231212</Phone>
115 <Email>m.rudenko@mute-lab.com</Email>
116 <Gender xsi:nil="true"/>
117 <Document Type="P">
118 <Series>1866</Series>
119 <Number>913319</Number>
120 <IssueDate>2012-12-12 00:00:00</IssueDate>
121 <ExpiryDate>2014-12-12 00:00:00</ExpiryDate>
122 </Document>
123 </Person>
124 </Persons>
125 </Export>
126 </Response>
127 </ResponseBin>
128 </ns1:exportResponse>
129 </SOAP-ENV:Body>
130 </SOAP-ENV:Envelope>
Формат ответа аналогичен результату бронирования.
Аннуляция заказа
WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking
Запрос
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCancelBooking">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:cancel>
6 <RequestBin>
7 <Request>
8 <CancelBooking>
9 <Item Id="386621"/>
10 </CancelBooking>
11 </Request>
12 <Source>
13 <ClientId></ClientId>
14 <APIKey></APIKey>
15 <Language>ru</Language>
16 <Currency>RUB</Currency>
17 </Source>
18 </RequestBin>
19 </ver:cancel>
20 </soapenv:Body>
21 </soapenv:Envelope>
Элемент Item
| Элемент | Описание | Допустимые значения |
|---|---|---|
| Атрибут Id | Обязательный. Идентификатор заказа в системе Nemo. | Целое число |
Элемент Source
| Элемент | Описание | Допустимые значения |
|---|---|---|
| ClientID | Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Целое число. |
| APIKey | Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация". |
Латинские буквы и цифры. Всего 32 символа. |
Ответ
см. результаты бронирования.
Статические данные
Для работы с веб-сервисом 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 | Необязательный. Путь к миниатюре, иконке. | Строка в произвольном формате. |
