Агентский API Авиабилеты: различия между версиями
Перейти к навигации
Перейти к поиску
(→Отмена бронирования) |
(→Запрос на обновление заказа) |
||
| Строка 162: | Строка 162: | ||
'''REQUEST''' | '''REQUEST''' | ||
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"> | <syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"> | ||
| − | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http:// | + | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DUpdateBook"> |
<soapenv:Header/> | <soapenv:Header/> | ||
| − | <soapenv:Body> | + | <soapenv:Body> |
<ver:UpdateBook> | <ver:UpdateBook> | ||
<RequestBin> | <RequestBin> | ||
<Request> | <Request> | ||
| − | |||
<UpdateBook> | <UpdateBook> | ||
| − | <!--BookID Id заказа в системе Немо, обязательный--> | + | <!--Запрос, обязательный--> |
| − | <BookID> | + | <!--BookID - Id заказа в системе Немо, обязательный--> |
| + | <BookID>260647</BookID> | ||
</UpdateBook> | </UpdateBook> | ||
</Request> | </Request> | ||
| + | <Source> | ||
<!--Авторизация, обязательный--> | <!--Авторизация, обязательный--> | ||
| − | <!-- | + | <!--ClientId, идентификатор клиента, обязательный--> |
| − | <!-- | + | <!--APIKey, API ключ клиента, обязательный--> |
| − | <!-- | + | <!--Language, код языка, обязательный--> |
| − | <!-- | + | <!--Currency код валюты, обязательный--> |
| − | |||
<ClientId>102</ClientId> | <ClientId>102</ClientId> | ||
<APIKey>7F48365D42B73307C99C12A578E92B36</APIKey> | <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey> | ||
Версия 13:49, 8 февраля 2014
Содержание
- 1 Агентский АПИ поиска авиабилетов и бронирования
- 2 Агентский АПИ выписки
- 3 Отмена бронирования
- 4 Проверка на доступность
- 5 Запрос на обновление заказа
- 6 Чтение тарифных правил
- 7 Запрос на выписку
- 8 Войдирование билета
- 9 Параметры, используемые в запросах
- 10 Параметры, используемые в ответах
- 11 См. также
Агентский АПИ поиска авиабилетов и бронирования
1. Подключение 2. Просмотр результатов 3. Односторонний перелет 4. Перелет туда-обратно 5. Сложный маршрут
1. Запрос на бронирование 2. Односторонний перелет: Москва - Санкт-Петербург 3. Перелет Москва - Санкт-Петербург
Агентский АПИ выписки
Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета.
! Как правило для выписки билета достаточно сформировать запрос на проставление статуса "ОПЛАЧЕНО". При включенной опции «Производить оформление билета: автоматически» билет будет выпущен в фоновом режиме.
В Nemo 2.0 в агентский сервис (интерфейс к серверу бронирования) добавлены дополнительные настройками для выписки авиабилетов. В новой версии АПИ позволяет:
- принимать запросы на возможность тикетинга;
- сообщать ВП (валидирующего перевозчика) по данной комбинации;
- сообщать комиссию по данной комбинации;
- сообщать эндорсменты по данной комбинации;
- принимать запрос на тикетинг;
- проверять наличие брони в ГДС;
- синхронизировать бронь;
- выписывать билет
- присылать маршрут-квитанцию;
- войдировать билет;
Отмена бронирования
После бронирования, если не истек таймлимит можно аннулировать сделанный заказ. Аннуляция заказа в Nemo может быть ручной (сделанной пользователем) и автоматической - по истечению таймлимита, установленного для заказа система сама аннулирует заказ.
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=CancelBook
Пример запроса и ответа на аннуляцию заказа:
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DCancelBook">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:CancelBook>
5 <RequestBin>
6 <Request>
7 <!--Запрос, обязательный-->
8 <!--BookID - Ид брони в системе немо, целое число, обязательный-->
9 <CancelBook BookID="260646"/>
10 </Request>
11 <Source>
12 <!--Авторизация, обязательный-->
13 <!--ClientId, идентификатор клиента, обязательный-->
14 <!--APIKey, API ключ клиента, обязательный-->
15 <!--Language, код языка, обязательный-->
16 <!--Currency код валюты, обязательный-->
17 <ClientId>102</ClientId>
18 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
19 <Language>RU</Language>
20 <Currency>RUB</Currency>
21 </Source>
22 </RequestBin>
23 </ver:CancelBook>
24 </soapenv:Body>
25 </soapenv:Envelope>
RESPONSE
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DCancelBook" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:CancelBookResponse>
4 <ResponseBin>
5 <Response>
6 <!--BookID - Ид брони в системе немо, целое число-->
7 <CancelBook BookID="260646">
8 <!--Result, Отмена брони-->
9 <!--Sucscess, Результат отмены брони, true или false-->
10 <Result Success="true"/>
11 </CancelBook>
12 <Requisites/>
13 <RequestType xsi:nil="true"/>
14 <UserID xsi:nil="true"/>
15 <Errors xsi:nil="true"/>
16 </Response>
17 </ResponseBin>
18 </ns1:CancelBookResponse>
19 </SOAP-ENV:Body>
20 </SOAP-ENV:Envelope>
Проверка на доступность
Данный запрос отправляется из Nemo после того как пользователь на результатах поиска нажимает ссылку «забронировать». Он необходим для того чтобы перед подтверждением бронирования повторно проверить перелет на доступность и исключить максимально возможное количество заказов, которые нельзя будет забронировать из-за сервисных ошибок, либо изменения условий (например, снятия мест).
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=AirAvail
Пример запроса и ответа:
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DAirAvail">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:AirAvail>
5 <RequestBin>
6 <Request>
7 <AirAvail>
8 <!--Запрос, обязательный-->
9 <!--FlightId ид перелёта в системе Немо, обязательный-->
10 <FlightId>142330001</FlightId>
11 </AirAvail>
12 </Request>
13 <Source>
14 <!--Авторизация, обязательный-->
15 <!--ClientId, идентификатор клиента, обязательный-->
16 <!--APIKey, API ключ клиента, обязательный-->
17 <!--Language, код языка, обязательный-->
18 <!--Currency код валюты, обязательный-->
19 <ClientId>102</ClientId>
20 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
21 <Language>RU</Language>
22 <Currency>RUB</Currency>
23 </Source>
24 </RequestBin>
25 </ver:AirAvail>
26 </soapenv:Body>
27 </soapenv:Envelope>
RESPONSE
1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DAirAvail" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2 <SOAP-ENV:Body>
3 <ns1:AirAvailResponse>
4 <ResponseBin>
5 <Response>
6 <!--FlightId ид перелёта в системе Немо-->
7 <!--IsAvail доступность перелёта, true или false-->
8 <AirAvail FlightId="142330001" IsAvail="true"/>
9 <Requisites/>
10 <RequestType xsi:nil="true"/>
11 <UserID xsi:nil="true"/>
12 <Errors xsi:nil="true"/>
13 </Response>
14 </ResponseBin>
15 </ns1:AirAvailResponse>
16 </SOAP-ENV:Body>
17 </SOAP-ENV:Envelope>
Запрос на обновление заказа
Запрос на обновление заказа
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=UpdateBook
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://sys.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DUpdateBook">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:UpdateBook>
5 <RequestBin>
6 <Request>
7 <UpdateBook>
8 <!--Запрос, обязательный-->
9 <!--BookID - Id заказа в системе Немо, обязательный-->
10 <BookID>260647</BookID>
11 </UpdateBook>
12 </Request>
13 <Source>
14 <!--Авторизация, обязательный-->
15 <!--ClientId, идентификатор клиента, обязательный-->
16 <!--APIKey, API ключ клиента, обязательный-->
17 <!--Language, код языка, обязательный-->
18 <!--Currency код валюты, обязательный-->
19 <ClientId>102</ClientId>
20 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
21 <Language>RU</Language>
22 <Currency>RUB</Currency>
23 </Source>
24 </RequestBin>
25 </ver:UpdateBook>
26 </soapenv:Body>
27 </soapenv:Envelope>
Чтение тарифных правил
Чтение тарифных правил - это запрос, который отправляется после того, как пользователь на результатах поиска выбрал перелет и нажал «Забронировать». При помощи него Nemo получает информацию от поставщика о возвратности/невозвратности тарифов, а так же иную полезную информацию, которая доступна пользователю на странице подтверждения бронировании по клику на названии тарифного правила.
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=GetAirRules
Пример запроса и ответа:
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:GetAirRules>
5 <RequestBin>
6 <Request>
7 <!--Запрос, обязательный-->
8 <GetAirRules>
9 <!--FlightId ид перелёта в системе Немо, обязательный-->
10 <FlightId>531846</FlightId>
11 </GetAirRules>
12 </Request>
13 <!--Авторизация, обязательный-->
14 <!--@ClientId, идентификатор клиента, обязательный-->
15 <!--@APIKey, API ключ клиента, обязательный-->
16 <!--@Language, код языка, обязательный-->
17 <!--@Currency код валюты, обязательный-->
18 <Source>
19 <ClientId>102</ClientId>
20 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
21 <Language>RU</Language>
22 <Currency>RUB</Currency>
23 </Source>
24 </RequestBin>
25 </ver:GetAirRules>
26 </soapenv:Body>
27 </soapenv:Envelope>
RESPONSE
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:GetAirRules>
5 <ResponseBin>
6 <Response>
7 <!--Запрос, обязательный-->
8 <GetAirRules>
9 <!--FlightId ид перелёта в системе Немо, обязательный-->
10 <FlightId>531846</FlightId>
11 <!--Rules Правила перелета, обязательный-->
12 <Rules>
13 <!--@Code код правила, обязательный-->
14 <!--@Tarrif название тарифа, обязательный-->
15 <!--@Name название правила, обязательный-->
16 <Rule Code="6" Tarrif="VSSOW" Name="MINIMUM STAY">
17 <!--Текст правила, обязательный-->
18 <RuleText>No Minimum Stay</RuleText>
19 </Rule>
20 <Rule Code="7" Tarrif="VSSOW" Name="MAXIMUM STAY">
21 <RuleText>No Maximum Stay</RuleText>
22 </Rule>
23 <Rule Code="5" Tarrif="VSSOW" Name="ADVANCE RESERVATIONS/TICKETING">
24 <RuleText>Advanced reservations anytime Advanced ticketing departure
25 time - 0 Advanced ticketing reservation time - 24 hours</RuleText>
26 </Rule>
27 <Rule Code="2" Tarrif="VSSOW" Name="DAY/TIME">
28 <RuleText>Most restrictive ticketing date 20110524</RuleText>
29 </Rule>
30 <Rule Code="12" Tarrif="VSSOW" Name="SURCHARGES">
31 <RuleText>No surcharges</RuleText>
32 </Rule>
33 <Rule Code="16" Tarrif="VSSOW" Name="PENALTIES">
34 <RuleText>Condition: If Itinerary is changed requiring reissue of ticket.
35 Amount - Condition: If canceled. Amount -</RuleText>
36 </Rule>
37 <Rule Code="0" Tarrif="VSSOW" Name="APPLICATION AND OTHER CONDITIONS">
38 <RuleText>Application and other conditions
39 rule - 304/ut23
40 unless otherwise specified
41 one way instant purchase fare
42 application
43 area
44 these fares apply
45 within russia.
46 class of service
47 these fares apply for economy class service.
48 types of transportation
49 this rule governs one-way fares.
50 fares governed by this rule can be used to create
51 one-way journeys.
52 capacity limitations
53 the carrier shall limit the number of passengers carried
54 on any one flight at fares governed by this rule and such
55 fares will not necessarily be available on all flights.
56 the number of seats which the carrier shall make
57 available on a given flight will be determined by the
58 carriers best judgment
59 </RuleText>
60 </Rule>
61 <Rule Code="4" Tarrif="VSSOW" Name="FLIGHT APPLICATION">
62 <RuleText>Flight application
63 unless otherwise specified
64 the fare component must be on
65 one or more of the following
66 any ut flight.</RuleText>
67 </Rule>
68 <Rule Code="5" Tarrif="VSSOW" Name="ADVANCE RES/TICKETING">
69 <RuleText>Advance res/ticketing
70 unless otherwise specified
71 reservations are required for all sectors.
72 ticketing must be completed within 24 hours after
73 reservations are made.</RuleText>
74 </Rule>
75 <Rule Code="8" Tarrif="VSSOW" Name="STOPOVERS">
76 <RuleText>Stopovers
77 unless otherwise specified
78 unlimited stopovers permitted.</RuleText>
79 </Rule>
80 <Rule Code="9" Tarrif="VSSOW" Name="TRANSFERS">
81 <RuleText>Transfers
82 unless otherwise specified
83 unlimited transfers permitted on the pricing unit
84 fare break and embedded surface sectors permitted on the
85 fare component.</RuleText>
86 </Rule>
87 <Rule Code="10" Tarrif="VSSOW" Name="PERMITTED COMBINATIONS">
88 <RuleText>Permitted combinations
89 unless otherwise specified
90 single/double open jaws/round trips/circle trips not
91 permitted.
92 add-ons not permitted.
93 end-on-end
94 end-on-end combinations permitted with ut fares.
95 validate all fare components.
96 provided -
97 combinations are with any one way fare for carrier ut.</RuleText>
98 </Rule>
99 <Rule Code="15" Tarrif="VSSOW" Name="SALES RESTRICTIONS">
100 <RuleText>Sales restrictions
101 unless otherwise specified
102 tickets must be issued on ut.
103 </RuleText>
104 </Rule>
105 <Rule Code="16" Tarrif="VSSOW" Name="PENALTIES">
106 <RuleText>Penalties
107 unless otherwise specified
108 cancellations
109 cancellations permitted for cancel/no-show/refund.
110 note -
111 -full refund if ticket is presented for the refund
112 more than 24hrs before departure time shown on the
113 flight coupon.
114 -refund the fare paid less 25 percent if ticket is
115 presented for the refund less than 24hrs before
116 departure time shown on the flight coupon or after
117 departure time shown on the flight coupon/no-show/
118 ---------------------
119 refund of unused fees and taxes permitted
120 ---------------------
121 penalties waived in case of involuntary refund
122 ---------------------
123 refund permitted at any time within one year from
124 the day of original ticket issue.
125 changes
126 changes permitted.
127 note -
128 permitted upon payment to any higher applicable
129 ow fare. the difference in fares has to be
130 collected.
131 ----------------
132 changes permitted if the ticket is presented for
133 the change within 1 month from the date of
134 departure shown on the original flight coupon.
135 involuntary changes
136 involuntary changes permitted.
137 </RuleText>
138 </Rule>
139 <Rule Code="17" Tarrif="VSSOW" Name="HIP/MILEAGE EXCEPTIONS">
140 <RuleText>Hip/mileage exceptions
141 unless otherwise specified
142 note -
143 higher intermediate rule applies.
144 unless otherwise specified
145 note -
146 higher intermediate rule applies.
147 </RuleText>
148 </Rule>
149 <Rule Code="19" Tarrif="VSSOW" Name="CHILDREN DISCOUNTS">
150 <RuleText>Children discounts
151 within russia
152 </RuleText>
153 </Rule>
154 <Rule Code="6" Tarrif="VSSOW" Name="PENALTIES">
155 <RuleText>Penalties
156 unless otherwise specified
157 cancellations
158 cancellations permitted for cancel/no-show/refund.
159 note -
160 -full refund if ticket is presented for the refund
161 more than 24hrs before departure time shown on the
162 flight coupon.
163 -refund the fare paid less 25 percent if ticket is
164 presented for the refund less than 24hrs before
165 departure time shown on the flight coupon or after
166 departure time shown on the flight coupon/no-show/
167 ---------------------
168 refund of unused fees and taxes permitted
169 ---------------------
170 penalties waived in case of involuntary refund
171 ---------------------
172 refund permitted at any time within one year from
173 the day of original ticket issue.
174 changes
175 changes permitted.
176 note -
177 permitted upon payment to any higher applicable
178 ow fare. the difference in fares has to be
179 collected.
180 ----------------
181 changes permitted if the ticket is presented for
182 the change within 1 month from the date of
183 departure shown on the original flight coupon.
184 involuntary changes
185 involuntary changes permitted.
186 17. hip/mileage exceptions
187 unless otherwise specified
188 note -
189 higher intermediate rule applies.
190 unless otherwise specified
191 note -
192 higher intermediate rule applies.
193 19. children discounts
194 within russia
195 accompanied child 2-11 - charge 67 percent of the fare.
196 ticket designator - cn and percent of discount.
197 note -
198 discount applies if the number of children is 6
199 or less
200 -----------------------------------------------
201 unaccompanied children not permitted
202 or - 1st and each additional group child 2-11 - charge 95
203 percent of the fare.
204 ticket designator - cn and percent of discount.
205 note -
206 discount applies if the number of children in the
207 group is more than 6. group required to travel
208 together for the entire pricing unit.
209 -------------
210 unaccompanied children not permitted
211 or - 1st infant under 2 without a seat - no charge
212 ticket designator - in and percent of discount
213 or - 2nd and each additional infant under 2 without a
214 seat- charge 67 percent of the fare.
215 ticket designator - cn and percent of discount
216 or - infant under 2 with a seat - charge 67 percent of the
217 fare.
218 ticket designator - cn and percent of discount.
219 note -
220 unaccompanied infants not permitted
221 </RuleText>
222 </Rule>
223 <Rule Code="20" Tarrif="VSSOW" Name="TOUR CONDUCTOR DISCOUNTS">
224 <RuleText>Tourconductor discounts
225 unless otherwise specified
226 note -
227 tour conductor discounts not permitted.
228 </RuleText>
229 </Rule>
230 <Rule Code="21" Tarrif="VSSOW" Name="AGENT DISCOUNTS">
231 <RuleText>Agent discounts
232 unless otherwise specified
233 note -
234 agent discounts not permitted.
235 </RuleText>
236 </Rule>
237 <Rule Code="22" Tarrif="VSSOW" Name="ALL OTHER DISCOUNTS">
238 <RuleText>All other discounts
239 unless otherwise specified
240 note -
241 not permitted.
242 </RuleText>
243 </Rule>
244 </Rules>
245 </GetAirRules>
246 </Response>
247 <!--Авторизация, обязательный-->
248 <!--@ClientId, идентификатор клиента, обязательный-->
249 <!--@APIKey, API ключ клиента, обязательный-->
250 <!--@Language, код языка, обязательный-->
251 <!--@Currency код валюты, обязательный-->
252 <Source>
253 <ClientId>102</ClientId>
254 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
255 <Language>RU</Language>
256 <Currency>RUB</Currency>
257 </Source>
258 </ResponseBin>
259 </ver:AirAvail>
260 </soapenv:Body>
261 </soapenv:Envelope>
Запрос на выписку
Данный запрос запускается после оплаты заказа, может быть запущен как в ручную - пользователем, у которого есть на это права, так и автоматически при использовании соответствующей опции. Выписать неоплаченный заказ через Nemo возможности нет. При запуске запроса на выписку также запускается процесс обновления заказа, в ходе которого сверяется цена и остальные параметры заказа, а также проверяется его актуальность. Заказы, с истекшим таймлимитом выписаны через Nemo быть не могут.
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=Ticketing
Примеры запроса и ответа:
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DTicketing">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:Ticketing>
5 <RequestBin>
6 <Request>
7 <!--Запрос, обязательный-->
8 <Ticketing>
9 <BookID>21032</BookID>
10 <!--Валидирующий перевозчик (тот кто выписывает билет), необязательный-->
11 <ValCompany></ValCompany>
12 <!--Комиссии, указывается или в валюте, или в процентах, для валюты обязательным является код валюты.
13 Если указана и в валюте и в процентах, то у поставщика комиссия устанавливается в валюте.-->
14 <!--@Amount - комиссия в валюте-->
15 <!--@Percent - комиссия в процентах-->
16 <!--@CurrencyCode - код валюты комиссии-->
17 <!--Optional:-->
18 <Comission Amount="" Percent="" CurrencyCode=""/>
19 </Ticketing>
20 </Request>
21 <!--Авторизация, обязательный-->
22 <!--@ClientId, идентификатор клиента, обязательный-->
23 <!--@APIKey, API ключ клиента, обязательный-->
24 <!--@Language, код языка, обязательный-->
25 <!--@Currency код валюты, обязательный-->
26 <Source>
27 <ClientId>102</ClientId>
28 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
29 <Language>RU</Language>
30 <Currency>RUB</Currency>
31 </Source>
32 </RequestBin>
33 </ver:Ticketing>
34 </soapenv:Body>
35 </soapenv:Envelope>
RESPONSE
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DTicketing">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <ver:Ticketing>
5 <ResponseBin>
6 <Response>
7 <!--Ответ, обязательный-->
8 <!--@ID - Ид брони в системе немо, целое число, обязательный-->
9 <!--@Status - Индикатор состояния брони, обязательный, возможные значения:
10 booked - забронировано,
11 canceled - бронь отменена,
12 ticket - выписана
13 UNDEFINED - статус не определён
14 -->
15 <!--@Code - Код брони в системе бронирования/поиска, строка, обязательный-->
16 <BookFlight ID="21032" Status="booked" Code="QCH3DA">
17 <!--Положение брони в очереди, необязательный-->
18 <!--@Number - номер брони в очереди, обязательный-->
19 <QueryPlace/>
20 <!--@FlightId ид перелёта в системе Немо, обязательный-->
21 <Flight FlightId="534733">
22 <!--Веб-сервис из которого получен перелёт, обязательный-->
23 <WebService>GALILEO</WebService>
24 <!--Код авиакомпании - валидирующего перевозчика, IATA, обязательный-->
25 <ValCompany>UN</ValCompany>
26 <URL>http:///</URL>
27 <!--Сегменты в перелёте, обязательный-->
28 <Segments>
29 <!--SegNum - Номер сегмента в перелёте, обязательный-->
30 <Segment SegNum="1">
31 <!--Аэропорт отправления. Обязательный-->
32 <DepAirp CodeType="IATA">DME</DepAirp>
33 <!--Терминал пункта отправления, если пустое значение, то терминала нет, т.е. в аэропорту всего 1 терминал, необязательный-->
34 <DepTerminal/>
35 <!--Аэропорт прибытия. Обязательный-->
36 <ArrAirp CodeType="IATA">LED</ArrAirp>
37 <!--Терминал пункта прибытия, если пустое значение, то терминала нет, т.е. в аэропорту всего 1 терминал, необязательный-->
38 <ArrTerminal>1</ArrTerminal>
39 <!--Авиакомпания перевозчик. Обязательный-->
40 <OpAirline>UN</OpAirline>
41 <!--Авиакомпания, продающая перелёт. Обязательный-->
42 <MarkAirline>UN</MarkAirline>
43 <!--Номер рейса. Обязательный-->
44 <FlightNumber>5</FlightNumber>
45 <!--Тип воздушного судна, код. Обязательный-->
46 <AircraftType>735</AircraftType>
47 <!--Дата и время отправления, формат ГГГГ-MM-DDTЧЧ:ММ:СС. Обязательный-->
48 <DepDateTime>2011-06-28T19:25:00</DepDateTime>
49 <!--Дата и время прибытия, формат ГГГГ-MM-DDTЧЧ:ММ:СС. Обязательный-->
50 <ArrDateTime>2011-06-28T20:50:00</ArrDateTime>
51 <!--Количество остановок. Обязательный-->
52 <StopNum>0</StopNum>
53 <!--Код класса бронирования. Обязательный-->
54 <BookingCodes>
55 <BookingCode>W</BookingCode>
56 </BookingCodes>
57 <!--Время перелёта, в минутах. Обязательный-->
58 <FlightTime>85</FlightTime>
59 <!--Временные зоны точки отправления и прибытия. Необязательный-->
60 <!--@departure временная зона аэропорта отправления-->
61 <!--@arrival - временная зона аэропорта прибытия-->
62 <TimeZone Departure="" Arrival=""/>
63 <!--Признак электронного билета. Значения: true или false. Обязательный-->
64 <ETicket>true</ETicket>
65 </Segment>
66 </Segments>
67 <!--информация о стоимости, может встречаться более 1 раза, обязательный-->
68 <!--@Refundable возвратный/невозвратный, true/false. Если пустое, то не известно, необязательный-->
69 <PricingInfo Refundable="true">
70 <!--Типы пассажиров с ценами, таксами и тп, может встречаться более 1 раза, необязательный-->
71 <!--@Type тип пассажира, возможные значения:
72 ADT - взрослые,
73 CNN - дети со взрослыми,
74 UNN - дети без сопровождения взрослых,
75 INF - младенцы,
76 INS - младенцы с местом, обязательный-->
77 <!--@Quantity Количество пассажиров данного типа, обязательный-->
78 <PassengerFare Type="ADT" Quantity="1">
79 <!--Базовая стоимость, в базовой валюте, обязательный-->
80 <!--@Currency код валюты, @Amount значение цены, обязательный-->
81 <BaseFare Currency="RUB" Amount="300"/>
82 <!--Базовая стоимость, в эквивалентной валюте(валюте продажи), обязательный-->
83 <!--@Currency код валюты, @Amount значение цены, обязательный-->
84 <EquiveFare Currency="RUB" Amount="300"/>
85 <!--Суммарная стоимость в эквивалентной валюте, необязательный-->
86 <!--@Currency код валюты, @Amount значение цены, обязательный-->
87 <TotalFare Currency="RUB" Amount="1735"/>
88 <!--Массив такс, необязательный-->
89 <Taxes>
90 <!--@CurCode код валюты, обязательный-->
91 <!--@TaxCode код таксы, обязательный-->
92 <!--@Amount сумма таксы, обязательный-->
93 <Tax CurCode="RUB" TaxCode="RU" Amount="41"/>
94 <Tax CurCode="RUB" TaxCode="YQ" Amount="779"/>
95 <Tax CurCode="RUB" TaxCode="YR" Amount="615"/>
96 </Taxes>
97 <!--Массив тарифов, необязательный-->
98 <Tariffs>
99 <!--Тариф, обязательный-->
100 <!--@Code код тарифа, обязательный-->
101 <!--@SegNum номер сегмента, к которому применён тариф, обязательный-->
102 <Tariff Code="WPROW" SegNum="1"/>
103 </Tariffs>
104 <!--Строка расчёта цены, необязательный-->
105 <FareCalc/>
106 <!--Дата и время таймлимита по выписке в формате ГГГГ-MM-DDTЧЧ:ММ:СС, обязательный-->
107 <LastTicketDateTime>2011-05-27T10:11:32</LastTicketDateTime>
108 </PassengerFare>
109 </PricingInfo>
110 <!--Комиссии, обязательный-->
111 <!--@Currency код валюты, обязательный-->
112 <Commission Currency="RUB">173.5</Commission>
113 <!--Сборы, обязательный-->
114 <!--@Currency код валюты, обязательный-->
115 <Charges Currency="RUB">0</Charges>
116 </Flight>
117 <!--Информация об агенстве, обязательный-->
118 <Agency Name="">
119 <!--Телефон агентсва, необязательный-->
120 <!--@Type - тип номера, обязательный, возможные значения:
121 M - мобильный,
122 H - домашний,
123 B - рабочий,
124 A - агенство-->
125 <Telephone Type="">
126 <!--Номер телефона, обязательный-->
127 <PhoneNumber></PhoneNumber>
128 <!--Код страны, необязательный-->
129 <CountryAccessCode></CountryAccessCode>
130 <!--Код региона/города, необязательный-->
131 <AreaCityCode></AreaCityCode>
132 </Telephone>
133 <!--Адресс агенства. Обязательный.-->
134 <Address>
135 <!--Город. Обязательный.-->
136 <City></City>
137 <!--Адрес в городе (улица, дом, корпус, офис и т.д.). Необязательный.-->
138 <StreetAddress></StreetAddress>
139 <!--Почтовый индекс. Необязательный.-->
140 <PostalCode></PostalCode>
141 <!--Код страны (RU, UA и т.п.). Необязательный.-->
142 <CountryCode></CountryCode>
143 </Address>
144 </Agency>
145 <!--Маршрут квитанция, необязательный-->
146 <!--@Encoding - кодировка, обязательный-->
147 <!--@Format - формат, обязательный-->
148 <ItinReceipts Encoding="" Format="">
149 <FareStored/>
150 <!--Список пассажиров, обязательный-->
151 <Travellers>
152 <!--@Type тип пассажира, обязательный, возможные значения:
153 ADT - взрослые,
154 CNN - дети со взрослыми,
155 UNN - дети без сопровождения взрослых,
156 INF - младенцы,
157 INS - младенцы с местом-->
158 <!--@IsContact - если true - то данный пассажир является контактным лицом, если false - то не является, контактное лицо может быть только 1, если среди пассажиров есть взрослые, то только кто-то из них может быть контактным лицом, по умолчанию false, обязательный-->
159 <!--@Num - порядковый номер пассажира , начинается с 1, обязательный-->
160 <!--@LinkedTo - номер взрослого, к которому привязан младенец/ребёнок, необязательный-->
161 <Traveller Type="ADT" IsContact="true" Num="1">
162 <!--Код типа питания, необязательный, возможные значения:
163 NONE - отсутствует
164 AVML - Азиатская вегетарианская кухня
165 BLML - Блюда щадящей диеты
166 CHML - Детское питание
167 CHPC - Детский холодный завтрак
168 СНСС - Детский горячий завтрак
169 CHHC - Детский ланч, ветчина и сыр
170 PBJS - Детский ланч, ореховое масло
171 CHMC - Детский обед макароны с сыром
172 DBML - Диабетическое питание
173 FPML - Фрукты
174 GFML - Питание без клейковины
175 HFML - Питание богатое клетчаткой
176 HNML - Индусская кухня
177 BBML - Питание для младенцев
178 KSML - Кошерная кухня
179 SMKB - Кошерный завтрак
180 SMKL - Кошерный ланч
181 SMKD - Кошерный обед
182 LPML - Малобелковое питание
183 LCML - Низкокалорийное питание
184 LFML - Низкохолестериновое питание
185 PRML - Низкопуриновое питание
186 LSML - Малосоленое питание
187 MOML - Мюсли
188 NLML - Безмолочные продукты
189 ORML - Восточная кухня
190 RVML - Сырые овощи
191 SFML - Морепродукты
192 SPML - Особое питание
193 VLML - Вегетарианское, молоко и яйца
194 VGML - Строго вегетарианское питание
195 VJML - Джайнизское вегетарианское
196 VOML - Восточное вегетарианское питание-->
197 <Meal/>
198 <!--Билет, обязательный-->
199 <!--@TickectNum - номер билета, обязательный-->
200 <Ticket TickectNum="0000777751"/>
201 <Seats>
202 <!--Место пассажира в самолёте, обязательный-->
203 <!--@Number - номер места, обязательный-->
204 <!--@Characteristic - характеристика места, необязательный-->
205 <!--@SmokingPreference - статус курения на этом месте, необязательный-->
206 <!--@SegmentNumber - номер сегмента в перелёте, обязательный-->
207 <Seat Number="" Characteristic="" SmokingPreference="" SegmentNumber=""/>
208 <!--Персональные данные, обязательный-->
209 <!--@DateOfBirth - дата рождения в формате dd.mm.yyyy (например 31.12.2000), обязательный-->
210 <!--@Gender - пол пассажира, обязательный, возможные значения:
211 M - мужской(Male)
212 F - женский(Female)-->
213 </Seats>
214 <!--Персональные данные, обязательный-->
215 <!--@DateOfBirth - дата рождения в формате dd.mm.yyyy (например 31.12.2000), обязательный-->
216 <!--@Gender - пол пассажира, обязательный, возможные значения:
217 M - мужской(Male)
218 F - женский(Female)-->
219 <PersonalInfo DateOfBirth="15.05.1975" Gender="M">
220 <!--Имя пассажира, обязательный-->
221 <FirstName>IVAN</FirstName>
222 <!--Фамилия пассажира, обязательный-->
223 <LastName>IVANOV</LastName>
224 <!--Отчество пассажира, обязательный-->
225 <MiddleName/>
226 </PersonalInfo>
227 <!--Карточка часто летающего пассажира, необязательный -->
228 <!--@OpCode - код авиакомпании, обязательный-->
229 <!--@Number - номер карточки, обязательный -->
230 <LoyaltyCard OpCode="" Number=""/>
231 <!--Контактная информация, необязательный-->
232 <ContactInfo>
233 <!--Контактный email, необязательный-->
234 <EmailID/>
235 <!--Контактный телефон, необязательный-->
236 <!--@Type - тип номера, обязательный, возможные значения:
237 M - мобильный,
238 H - домашний,
239 B - рабочий-->
240 <Telephone Type="">
241 <!--Номер телефона, обязательный-->
242 <PhoneNumber/>
243 <!--Код страны, необязательный-->
244 <CountryAccessCode/>
245 <!--Код региона/города, необязательный-->
246 <AreaCityCode/>
247 </Telephone>
248 </ContactInfo>
249 <!--Паспортные данные, обязательный-->
250 <!--@DocType - тип документа, обязательный, возможные значения:
251 Р - Паспорт
252 A – Паспорт иностранца
253 С - Внутренний гражданский паспорт
254 F – Документ заменяющий паспорт
255 М - Воинское удостоверение
256 N – Сертификат натурализации(специфичный документ США)
257 T – Док.повторного въезда, паспорт беженца
258 V – Документ для пересечения границы-->
259 <!--@DocNum - номер документа, обязательный-->
260 <!--@DocElapsedTime - Срок истечения срока действия паспорта в dd.mm.yyyy (например 31.12.2000), обязательный-->
261 <DocumentInfo DocType="P" DocNum="1234123456" DocElapsedTime="15.06.2025"/>
262 <!--информация о визе, необязательная.(Заполняется через SSR DOCO)
263 @Num - номер визы, обязательный
264 @IssueDate - дата(dd.mm.yyyy) выдачи визы, обязательный
265 @IssueCountry - страна выдачи визы, обязательный
266 @IssuePlace - место выдачи визы, обязательный
267 @BirthCountry - страна рождения(IATA код страны), необязательный
268 @BirthCity - город рождения(название), необязательный
269 -->
270 <VisaInfo/>
271 <!--Адрес прибытия, необязательный.(Заполняется через SSR DOCA)
272 Но для въезжающих в США(неграждан США) информация является обязательной. Если она не заполняется
273 при оформлении брони, то её всё равно придётся заполнить при посадке на самолёт.
274 @CountryCode - Код страны. Обязательный
275 @State - Штат или область въезда. Обязательный
276 @PostalCode - Почтовый код. Обязательный
277 @City - Город. Обязательный
278 @StreetAddress - Адрес: улица, номер дома, квартиры и тп. Обязательный
279 -->
280 <ArrAddress/>
281 <!--Информация о предпочитаемом месте. Если указаны номер ряда и номер места, то параметры @Smoking и @Location игнорируются и могут быть не указаны. Необязательный-->
282 <!--@SmokingAllowed - булевское значение, true - место для курящих, false - место для некурящих, необязательный-->
283 <!--@Location - положение места в ряде, необязательный, возможные значения:
284 W - у окна (Window)
285 M - где-то в середине ряда (Middle)
286 NPW - возле прохода (NearPassengerWay)
287 NS - нет предпочтения (NotSpecified)
288 -->
289 <!--@RowNumber - Номер ряда, строка, необязательный-->
290 <!--@PlaceNumber - Номер места, строка, необязательный-->
291 <!--@SegNumber - Номер сегмента, строка, обязательный-->
292 <PreferedPlace SmokingAllowed="" Location="" RowNumber="" PlaceNumber="" SegNumber=""/>
293 <PreferedPlace/>
294 <DocStringFormats>
295 <!--Формат паспортной строки, обязательный, возможные значения:
296 DOCS - строка формата DOCS,
297 FOID - строка формата FOID-->
298 <DocStringFormat></DocStringFormat>
299 </DocStringFormats>
300 </Traveller>
301 </Travellers>
302 </BookFlight>
303 </Response>
304 <!--Авторизация, обязательный-->
305 <!--@ClientId, идентификатор клиента, обязательный-->
306 <!--@APIKey, API ключ клиента, обязательный-->
307 <!--@Language, код языка, обязательный-->
308 <!--@Currency код валюты, обязательный-->
309 <Source>
310 <ClientId>102</ClientId>
311 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
312 <Language>RU</Language>
313 <Currency>RUB</Currency>
314 </Source>
315 </ResponseBin>
316 </ver:Ticketing>
317 </soapenv:Body>
318 </soapenv:Envelope>
Войдирование билета
Данный запрос запускается после выписки билета, если необходимо его отменить.
WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=VoidTicket
Пример запроса и ответа:
REQUEST
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:VoidTicket>
6 <RequestBin>
7 <Request>
8 <!--Запрос, обязательный-->
9 <VoidTicket>
10 <!--BookID - Ид брони в системе немо, целое число, обязательный-->
11 <BookID>20990</BookID>
12 </Request>
13 <!--Авторизация, обязательный-->
14 <!--@ClientId, идентификатор клиента, обязательный-->
15 <!--@APIKey, API ключ клиента, обязательный-->
16 <!--@Language, код языка, обязательный-->
17 <!--@Currency код валюты, обязательный-->
18 <Source>
19 <ClientId>102</ClientId>
20 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
21 <Language>RU</Language>
22 <Currency>RUB</Currency>
23 </Source>
24 </RequestBin>
25 </ver:VoidTicket>
26 </soapenv:Body>
27 </soapenv:Envelope>
28 </env:Envelope>
RESPONSE
1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
2 xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
3 <soapenv:Header/>
4 <soapenv:Body>
5 <ver:VoidTicket>
6 <ResponseBin>
7 <Response>
8 <!--Запрос, обязательный-->
9 <!--@BookID, обязательный-->
10 <VoidTicket BookID="20990">
11 <!--Result, Отмена выписки, обязательный-->
12 <!--@Sucscess, Результат отмены выписки, true или false, обязательный-->
13 <Result Success="true"/>
14 </VoidTicket>
15 </Response>
16 <!--Авторизация, обязательный-->
17 <!--@ClientId, идентификатор клиента, обязательный-->
18 <!--@APIKey, API ключ клиента, обязательный-->
19 <!--@Language, код языка, обязательный-->
20 <!--@Currency код валюты, обязательный-->
21 <Source>
22 <ClientId>102</ClientId>
23 <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
24 <Language>RU</Language>
25 <Currency>RUB</Currency>
26 </Source>
27 </ResponseBin>
28 </ver:VoidTicket>
29 </soapenv:Body>
30 </soapenv:Envelope>
Параметры, используемые в запросах
<td">строка| Имя элемента | Обязательный | Тип | Описание |
|---|---|---|---|
| BookFlight | да | сложный | Контейнер для тела запроса бронирования |
| FlightId | да | число | ИД перелёта для которого будет производится бронирование(поиск тарифных правил, проверка доступности) |
| ValidatingCompany | нет | строка | Код авиакомпании, на бланке которой будет выписываться билет |
| BookingCodes | нет | сложный | Список классов авиа перелётов для бронирования. Рекомендуется заполнять, если бронируется перелёт из результатов поиска по расписанию. |
| BookingCode | да | сложный | Класс авиа перелёта для конкретного сегмента перелёта |
| Code | да | строка | Литера класса перелёта (Двух буквенный код авиакомпании) |
| SegNumber | да | число | Номер сегмента |
| CurrencyCode | нет | строка | Трёх буквенный код валюты (обязателен для комиссии в валюте) |
| TicketTimeLimit | нет | Таймлимит выписки, формат: ГГГГ-ММ-ДДTЧЧ:мм:СС. Используется для установки своего собственного таймлимита вручную | |
| Agency | да | сложный | Информация об агентстве |
| Name | да | строка | Название агентства |
| Telephone | нет | сложный | Контактный телефон агентства |
| Type | да | строка | Тип номера, возможные значения: M - мобильный, H - домашний, B - рабочий, A - агентство |
| PhoneNumber | да | строка | Номер телефона |
| CountryAccessCode | нет | строка | Код страны |
| AreaCityCode | нет | строка | Код региона/города |
| Address | да | сложный | Адрес агентства |
| City | да | строка | Город, в котором расположено агентство |
| StreetAddress | нет | сложный | Адрес агентства в городе (улица, дом, корпус, офис и т.д.) |
| PostalCode | нет | строка | Почтовый код, индекс. |
| CountryCode | нет | строка | Код страны (RU, UA, US и т.д.) |
| Travellers | да | сложный | Контейнер для информации о пассажирах (для которых будет производится поиск перелёта, бронирование) |
| Traveller | да | сложный | Информация о пассажире |
| Type | да | строка | Тип пассажира возможные значения: ADT - взрослые, CNN - дети со взрослыми, UNN - дети без сопровождения взрослых, INF - младенцы,INS - младенцы с местом |
| IsContact | нет | булевский | Индикатор показывающий является ли данное лицо контактным, возможные значение: true - пассажир является контактным лицом, false - не является. Контактное лицо может быть только одно, если среди пассажиров есть взрослые, то только кто-то из них может быть контактным лицом. Если не указано, то по умолчанию false. |
| LinkedTo | нет | целое число | Номер взрослого, к которому привязан младенец/ребёнок |
| Num | да | число | Номер пассажира. |
| PreferedPlace | нет | сложный | Информация о предпочитаемом месте. Если указаны номер ряда и номер места, то параметры Smoking и Location игнорируются и могут быть не указаны. |
| SmokingAllowed | нет | булевский | true - место для курящих, false - место для некурящих. По умолчанию false. |
| Location | нет | строка | Расположение места, возможные значения: W - у окна (Window); M - где-то в середине ряда (Middle); NPW - возле прохода (NearPassengerWay); NS - нет предпочтения (NotSpecified). |
| RowNumber | нет | строка | Номер ряда |
| PlaceNumber | нет | строка | Номер места |
| SegNumber | да | строка | Номер сегмента |
| DocumentInfo | да | сложный | Паспортные данные |
| DocType | да | строка | Тип документа, обязательный. |
| DocNum | да | строка | Номер документа |
| CountryCode | да | строка | Страна выдачи, двух буквенный код(RU, US и т.д.) |
| DocElapsedTime | да | строка | Срок истечения срока действия паспорта в фирмате dd.mm.yyyy (например 31.12.2012) |
| VisaInfo | нет | сложный | Информация о визе |
| Num | да | строка | Номер визы |
| IssueDate | да | строка | Дата выдачи визы в формате dd.mm.yyyy |
| IssueCountry | да | строка | Страна выдачи визы |
| IssuePlace | да | строка | Место выдачи визы |
| BirthCountry | нет | строка | Страна рождения (IATA код страны) |
| BirthCity | нет | строка | Город рождения (название) |
| ArrAddress | нет | сложный | Адрес прибытия, для въезжающих в США (не граждан США) информация является обязательной. Если она не заполняется при оформлении брони, то её всё равно придётся заполнять при посадке на самолёт. |
| CountryCode | да | строка | IATA код страны |
| State | да | строка | Штат или область въезда |
| PostalCode | да | строка | Почтовый код |
| City | да | строка | Город |
| StreetAddress | да | строка | Адрес: улица, номер дома, квартиры и тп |
| DocStringFormats | нет | сложный | Список форматов строк паспортных данных, которые будут отправлены в дополнение к стандартным. |
| DocStringFormat | да | строка | Формат данных, возможные значения: DOCS - строка формата DOCS, FOID - строка формата FOID. Установка данных в формате DOCS как правило необходима для последующей выписки в BSP среде. Установка FOID - всреде ТКП. |
| PersonalInfo | да | сложный | Персональные данные пассажира |
| DateOfBirth | да | строка | Дата рождения в формате dd.mm.yyyy (например 31.12.2000) |
| Nationality | да | строка | Национальность/гражданство, двух буквенный код страны (RU, UA, US и т.д.) |
| Gender | да | строка | Пол пассажира, обязательный, возможные значения: M - мужской(Male); F - женский(Female). |
| FirstName | да | строка | Имя пассажира |
| LastName | да | строка | Фамилия пассажира |
| BMiddleName | да | строка | Отчество пассажира |
| Meal | нет | строка | Код типа питания, возможные значения: NONE - отсутствует (по умолчанию); AVML - Азиатская вегетарианская кухня; BLML - Блюда щадящей диеты; CHML - Детское питание; CHPC - Детский холодный завтрак; СНСС - Детский горячий завтрак; CHHC - Детский ланч, ветчина и сыр; PBJS - Детский ланч, ореховое масло; CHMC - Детский обед макароны с сыром; DBML - Диабетическое питание; FPML - Фрукты; GFML - Питание без клейковины; HFML - Питание богатое клетчаткой; HNML - Индусская кухня; BBML - Питание для младенцев; KSML - Кошерная кухня; SMKB - Кошерный завтрак; SMKL - Кошерный ланч; SMKD - Кошерный обед; LPML - Малобелковое питание; LCML - Низкокалорийное питание; LFML - Низкохолестериновое питание; PRML - Низкопуриновое питание; LSML - Малосоленое питание; MOML - Мюсли; NLML - Безмолочные продукты; ORML - Восточная кухня; RVML - Сырые овощи; SFML - Морепродукты; SPML - Особое питание; VLML - Вегетарианское, молоко и яйца; VGML - Строго вегетарианское питание; VJML - Джайнизское вегетарианское; VOML - Восточное вегетарианское питание. |
| LoyaltyCard | нет | сложный | Карточка часто летающего пассажира |
| OpCode | да | строка | IATA код компании авиаперевозчика |
| Number | да | строка | Номер карточки |
| ContactInfo | нет | сложный | Контактная информация для пассажира |
| EmailID | нет | строка | Контактный email |
| Telephone | нет | сложный | Контактный телефон пассажира, описание аналогично описанию телефона агентства |
| QueueNum | нет | строка | Номер очереди, в которую необходимо поместить бронирование (Специфична для поставщика). |
| CancelBook | да | сложный | Контейнер для тела запроса отмены брони |
| BookID | да | число | Номер брони, которая будет отменяться (для которой будет производится выписка, отмена выписки) |
| GetAirRules | да | сложный | Контейнер для тела запроса поиска тарифных правил |
| AirAvail | да | сложный | Контейнер для тела запроса проверки доступности перелёта |
| Ticketing | да | сложный | Контейнер для тела запроса выписки брони |
| ValCompany | нет | строка | Валидирующий перевозчик, на бланке которого выписывается билет |
| Comission | нет | сложный | Комиссия |
| Amount | нет | число с плавающей точкой | Значение комиссии в валюте, если указано, то комиссия в процентах игнорируется |
| Percent | нет | число | Комиссия в процентах |
| VoidTicket | да | сложный | Контейнер для тела запроса отмены выписки брони |
| Search | да | сложный | Контейнер для тела запроса поиска |
| ODPairs | да | сложный | Контейнер для информации о перелёте |
| Type | да | строка | Тип перелёта, возможные значения: OW - в одну сторону, RT - туда-обратно, CR - сложный маршрут |
| Direct | нет | булевский | Индикатор, указывающий какие перелёты искать, только прямые или с пересадками, возможные значения: false - с пересадками, true - только прямые. Если не указан, значение по умолчанию false. |
| AroundDates | нет | число | Включает поиск по окружным датам, количество дней +/- от даты заезда/возвращения. Применим только для типов перелёта в одну сторону(OW) и туда-обратно(RT). Возможные значения: 0, 1, 2, 3 |
| ODPair | да | сложный | Контейнер для информации о сегменте перелёта. Может повторяться 1-6 раз. Поиск по расписанию использует только первый сегмент, поиск сложных перелётов и перелётов туда и обратно не поддерживается |
| DepDate | да | строка | Дата вылета, Формат ГГГГ-MM-DDTЧЧ:ММ:СС |
| DepAirp | да | строка | Трёх буквенный код города отправления или конкретного аэропорта в городе отправления. |
| ArrAirp | да | строка | Трёх буквенный код города прибытия или конкретного аэропорта в городе прибытия. |
| Count | да | число | Число пассажиров данного типа. Общее количество пассажиров всех типов должно быть не более 9. |
| Restrictions | нет | сложный | Контейнер дополнительной информации для поиска. |
| ClassPref | нет | строка | Предпочитаемый класс перелёта, возможные значения: All - все, Economy - эконом, Business - бизнес, First - первый. Если не указан, то по умолчанию All. |
| OnlyAvail | нет | булевский | Искать только доступные, возможные значения: true - только доступные, false - все. Если не указан, то по умолчанию false. |
| AirVPrefs | нет | сложный | Обёртка для списка авиакомпаний, по которым будет или не будет проводиться поиск. |
| AirVPref | да | сложный | Информация об авиакомпании. |
| Include | нет | булевский | Индикатор, показывающий включить или исключить в результатах поиска перелёты данной авиакомпании: true - включить, false - исключить. Если не указан, то по умолчанию false. |
| IncludePrivateFare | нет | булевский | Включать приватные цены в результат или нет, возможные значения: true - включать, false - не включать. Если не указан, то по умолчанию false. |
| ServiceTypes | нет | сложный хмл | Контейнер массива используемых веб-сервисов при поиске. |
| ServiceType | нет | строка | Тип веб-сервиса(поставщика). При указании нескольких элементов ServiceType поиск будет проведён для каждого сервиса. Возможные значения: Sirena2000 - поиск в Сирене; SirenaSchedule - поиск в Сирене по расписанию; SabreLFS - поиск в Сэйбр LFS; SabreBFM - поиск в Сэйбр BFM; SabreSchedule - поиск Сэйбр по расписанию; Galileo - поиск в Галилео; AmadeusMPTBS - поиск в Амадеус. |
Параметры, используемые в ответах
| Имя элемента | Обязательный | Тип | Описание |
|---|---|---|---|
| BookFlightResult | да | сложный | Контейнер для тела ответа бронирования |
| ID | да | число | Номер бронирования в системе Немо. |
| Status | да | строка | Статус брони, возможные значения: booked - забронировано, canceled - бронь отменена, ticket - выписана; UNDEFINED - статус не определён. |
| Code | да | строка | Номер бронирования в системе поставщика (в sabre, sirena и т.д.)/код тарифного правила |
| QueryPlace | нет | сложный | Очередь, в которую помещено бронирование |
| Number | да | число | Номер очереди |
| Flight | да | сложный | Перелёт, по которому была сделана бронь (Результаты проверки доступности для перелёта) |
| Agency | да | сложный | Информация об агентстве |
| ItinReceipts | нет | сложный | Маршрут квитанция. Содержит строку в кодировки Encoding (как правило в base64), представляющую маршрут квитанцию в формате Format. |
| Encoding | да | строка | Кодировка |
| Format | да | строка | Формат |
| Travellers | да | сложный | Контейнер для информации о пассажирах |
| Traveller | да | сложный | Информация о пассажире |
| Ticket | нет | сложный | Билет пассажира. |
| TickectNum | да | строка | Номер билета |
| Seats | нет | сложный | Контейнер мест пассажира. |
| Seat | да | сложный | Место в самолёте |
| Number | да | строка | Номер места(ряд+номер в ряду) |
| Characteristic | нет | строка | Характеристика места в соответствии со стандартом EDIFACT. См справочник “Таблица характеристик мест”. |
| SmokingPreference | нет | строка | Статус курения на этом месте, если Y - место для курящих, если N - место для некурящих. |
| SegmentNumber | да | число | Номер сегмента |
| PersonalInfo | да | сложный | Личные данные |
| LoyaltyCard | нет | сложный | Карточка часто летающего пассажира |
| ContactInfo | нет | сложный | Контактная информация для пассажира |
| FareStored | нет | срока: Yes/No | Указывает установлена ли / гарантируется ли цена у поставщика. Если параметр отсутствует в ответе, то по умолчанию значение “Yes”. |
| CancelBookResult | да | сложный | Контейнер для тела ответа отмены брони |
| BookID | да | число | Номер брони, которая отменялась (Номер выписанной брони, выписка которой отменялась) |
| Result | да | сложный | Результат отмены (войдирования) |
| Success | да | булевский | Индикатор, показывающий успешно или нет прошла отмена, возможные значения: true - успешно отменена (войдирование); false - не отменена |
| GetAirRulesResult | да | сложный | Контейнер для тела ответа поиска тарифных правил |
| FlightId | да | число | Номер перелёта, для которого найдены тарифные правила (будет проводилась проверка доступности) |
| Rules | да | сложный | Контейнер для правил |
| Rule | да | сложный | Правило |
| Tarrif | да | строка | Код тарифа, для которого правило применяется |
| Name | да | строка | Имя правила |
| RuleText | да | строка | Текст правила |
| AirAvailResult | да | сложный | Контейнер для тела ответа помещения брони в очередь |
| IsAvail | да | булевский | Индикатор, показывающий доступность перелёта, возможные значения: true - доступен; false - недоступен |
| VoidTicketResult | да | сложный | Контейнер для тела ответа отмены выписки брони |
| SearchResult | нет | сложный | Контейнер тела ответа для результатов поиска. |
| Flights | да | сложный | Контейнер для перелётов |
| Flight | нет | сложный | Представляет информацию о перелёте. Отсутствует если перелётов не найдено (используется в поисковом ответе) |
| WebService | да | строка | Веб-сервис (поставщик) от которого был получен перелёт. |
| ValCompany | нет | строка | IATA код авиакомпании. Валидирующий перевозчик, на бланках которого должен выписываться билет. |
| Segments | да | сложный | Контейнер для сегментов перелёта |
| Segment | да | сложный | Представляет информацию о сегменте |
| SegNum | да | число | Номер сегмента в перелёте |
| DepAirp | да | строка | IATA код аэропорта отправления |
| DepTerminal | нет | строка | Код терминала отправления |
| ArrAirp | да | строка | IATA код аэропорта прибытия |
| ArrTerminal | нет | строка | Код терминала прибытия |
| OpAirline | да | строка | Код авиакомпании, выполняющей рейс |
| MarkAirline | да | строка | Код авиакомпании, продающей билет |
| FlightNumber | да | число | Номер рейса |
| AircraftType | да | строка | Код типа самолёта |
| DepDateTime | да | строка | Дата и время отправления, формат ГГГГ-MM-ДДTЧЧ:ММ:СС |
| ArrDateTime | да | строка | Дата и время прибытия, формат ГГГГ-MM-ДДTЧЧ:ММ:СС |
| StopNum | да | число | Число остановок |
| Meal | да | строка | Тип питания, возможные значения: UNDEFINED - неизвестно; N - Нет питания; P - Алкогольные напитки в продаже; B - Завтрак; O - Холодная еда; C - Бесплатные алкогольные напитки; K - Континтальный завтрак; D - Обед; F - Еда в продаже; G - Еда/напитки в продаже; H - Горячая еда; L - Ланч; M - Еда; R - Освежающие еда/напитки бесплатно; V - Освежающие еда/напитки за отдельную плату; S - Закуска |
| BookingCodes | да | сложный | Контейнер для классов перелёта |
| BookingCode | да | строка | Код класса перелёта. Если производится поиск по расписанию, то может встречаться несколько раз. |
| FlightTime | нет | число | Время перелёта в минутах |
| TimeZone | нет | сложный | Информация о временных зона прибытия и отправления |
| Departure | да | число | Часовой пояс отправления, UTC (смещение относительно Гринвича) |
| Arrival | да | число | Часовой пояс прибытия, UTC (смещение относительно Гринвича) |
| ETicket | да | булевский | Индикатор электронного билета, возможные значения: true - билет является электронным, false - билет не является электронным. |
| Baggage | нет | сложный | Информация о багаже |
| Measure | да | строка | Мера веса. K - килограммы, PC - сумки/клади |
| Value | да | строка | Количество багажа |
| PricingInfo | нет | сложный | Контейнер для информации о ценах. Отсутствует в случае, если производится поиск по расписанию. |
| Refundable | да | булевский | Индикатор показывающий является ли билет возвратным или нет, возможные значения: true - возвратный (нет штрафов за возврат), false - невозвратный (могут быть штрафы за возврат) |
| PassengerFare | да | сложный | Информация о ценах для конкретного типа пассажиров. |
| Quantity | да | число | Число пассажиров данного типа |
| BaseFare | да | сложный | Цена в базовой валюте(за одного пассажира) |
| EquiveFare | нет | сложный | Цена в эквивалентной валюте(за одного пассажира), при поиске цены не возвращается |
| TotalFare | нет | сложный | Полная стоимость для пассажиров данного типа включая таксы (за одного пассажира), при поиске цены не возвращается |
| Currency | да | строка | Трёх буквенный код валюты. |
| Amount | да | число с плавающей точкой | Значение стоимости. |
| Taxes | нет | сложный | Контейнер для такс, при поиске цены не возвращается |
| Tax | да | сложный | Одна такса |
| CurCode | да | строка | Трёх буквенный код валюты для таксы |
| TaxCode | да | строка | Код таксы |
| Amount | да | число с плавающей точкой | Значение таксы |
| Tariffs | да | сложный | Контейнер для тарифов |
| Tariff | да | сложный | Контейнер для одного тарифа |
| Code | да | строка | Код тарифа |
| SegNum | да | число | Номер сегмента для которого применяется тариф, если тариф применяется для всех сегментов, то возвращается 0. |
| FareCalc | нет | строка | Строка расчёта цены |
| LastTicketDateTime | да | строка | Дата и время таймлимита по выписке в формате ГГГГ-MM-ДДTЧЧ:ММ:СС. Если бронирование не будет аннулировано или выписано до этого времени, то могут быть применены штрафы. |
