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

Версия 12:18, 8 февраля 2014

Содержание

1 Агентский АПИ поиска авиабилетов и бронирования
2 Агентский АПИ выписки
3 Отмена бронирования
4 Проверка на доступность
5 Запрос на обновление заказа
6 Войдирование билета
7 Параметры, используемые в запросах
8 Параметры, используемые в ответах
9 См. также

Агентский АПИ поиска авиабилетов и бронирования

Веб-служба поиска авиабилетов

   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://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
 2    <soapenv:Header/>
 3    <soapenv:Body>
 4       <ver:CancelBook>
 5          <RequestBin>
 6             <Request>
 7 	       <!--Запрос, обязательный-->
 8                <CancelBook BookID="209901"/>
 9 	       <!--BookID - Ид брони в системе немо, целое число, обязательный-->
10 	    </Request>
11 	     <!--Авторизация, обязательный-->
12 	     <!--@ClientId, идентификатор клиента, обязательный-->
13 	     <!--@APIKey, API ключ клиента, обязательный-->
14 	     <!--@Language, код языка, обязательный-->
15 	     <!--@Currency код валюты, обязательный-->
16             <Source>
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 <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:CancelBook>
 5          <ResponseBin>	
 6             <Response>
 7 		<!--Запрос, обязательный-->
 8 		<!--@BookID - Ид брони в системе немо, целое число, обязательный-->
 9 		  <CancelBook BookID="209901">
10 		  <!--Result, Отмена брони, обязательный-->
11 		  <!--@Sucscess, Результат отмены брони, true или false, обязательный-->
12 		  <Result Success="true"/>
13 		 </CancelBook>
14 	     </Response>  
15 	     <!--Авторизация, обязательный-->
16 	     <!--@ClientId, идентификатор клиента, обязательный-->
17 	     <!--@APIKey, API ключ клиента, обязательный-->
18 	     <!--@Language, код языка, обязательный-->
19 	     <!--@Currency код валюты, обязательный-->
20             <Source>
21                <ClientId>102</ClientId>
22                <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
23                <Language>RU</Language>
24                <Currency>RUB</Currency>
25             </Source>
26          </ResponseBin>
27       </ver:CancelBook>
28    </soapenv:Body>
29 </soapenv: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://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
 2    <soapenv:Header/>
 3    <soapenv:Body>
 4       <ver:AirAvail>
 5          <RequestBin>
 6             <Request>				
 7 		<AirAvail>
 8 		    <!--Запрос, обязательный-->
 9 		    <!--FlightId ид перелёта в системе Немо, обязательный-->
10 		    <FlightId>534733</FlightId>
11 		</AirAvail>	
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:AirAvail>
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:AirAvail>
 5          <ResponseBin>	
 6             <Response>
 7 		<!--Запрос, обязательный-->
 8 		<!--@FlightId ид перелёта в системе Немо, обязательный-->
 9 		<!--@IsAvail доступность перелёта, true или false, обязательный-->
10 		<AirAvail FlightId="534733" IsAvail="true"/>				
11 	    </Response>
12 	    <!--Авторизация, обязательный-->
13 	    <!--@ClientId, идентификатор клиента, обязательный-->
14 	    <!--@APIKey, API ключ клиента, обязательный-->
15 	    <!--@Language, код языка, обязательный-->
16 	    <!--@Currency код валюты, обязательный-->
17             <Source>
18                <ClientId>102</ClientId>
19                <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
20                <Language>RU</Language>
21                <Currency>RUB</Currency>
22             </Source>
23          </ResponseBin>
24       </ver:AirAvail>
25    </soapenv:Body>
26 </soapenv: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://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
  2    <soapenv:Header/>
  3    <soapenv:Body>   
  4       <ver:UpdateBook>
  5          <RequestBin>
  6             <Request>
  7                <!--Запрос, обязательный-->
  8                <UpdateBook>
  9                     <!--BookID Id заказа в системе Немо, обязательный-->
 10                   <BookID>234567</BookID>
 11                </UpdateBook>
 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:UpdateBook>
 26    </soapenv:Body>
 27 </soapenv:Envelope>
 28 </syntaxhightlight>
 29 
 30 == Чтение тарифных правил ==
 31 '''Чтение тарифных правил''' - это запрос, который отправляется после того, как пользователь на результатах поиска выбрал перелет и нажал «Забронировать». При помощи него Nemo получает информацию от поставщика о возвратности/невозвратности тарифов, а так же иную полезную информацию, которая доступна пользователю на странице подтверждения бронировании по клику на названии тарифного правила.
 32 
 33 WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=GetAirRules
 34 
 35 '''Пример запроса и ответа:'''
 36 
 37 '''REQUEST'''
 38 <syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 39 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
 40    <soapenv:Header/>
 41    <soapenv:Body>   
 42       <ver:GetAirRules> 
 43          <RequestBin>
 44             <Request>
 45 		<!--Запрос, обязательный-->
 46 		<GetAirRules>
 47 		<!--FlightId ид перелёта в системе Немо, обязательный-->
 48 		<FlightId>531846</FlightId>
 49 		</GetAirRules>
 50 	    </Request>
 51 		<!--Авторизация, обязательный-->
 52 		<!--@ClientId, идентификатор клиента, обязательный-->
 53 		<!--@APIKey, API ключ клиента, обязательный-->
 54 		<!--@Language, код языка, обязательный-->
 55 		<!--@Currency код валюты, обязательный-->
 56             <Source>
 57                <ClientId>102</ClientId>
 58                <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
 59                <Language>RU</Language>
 60                <Currency>RUB</Currency>
 61             </Source>
 62          </RequestBin>
 63       </ver:GetAirRules>
 64    </soapenv:Body>
 65 </soapenv:Envelope>
 66 </syntaxhightlight>
 67 
 68 '''RESPONSE'''
 69 
 70 <syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 71 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
 72    <soapenv:Header/>
 73    <soapenv:Body>
 74       <ver:GetAirRules>
 75          <ResponseBin>	
 76             <Response>
 77 				<!--Запрос, обязательный-->
 78 				<GetAirRules>
 79 				<!--FlightId ид перелёта в системе Немо, обязательный-->
 80 				<FlightId>531846</FlightId>
 81 					<!--Rules Правила перелета, обязательный-->
 82 					<Rules>
 83 						<!--@Code код правила, обязательный-->
 84 						<!--@Tarrif название тарифа, обязательный-->
 85 						<!--@Name название правила, обязательный-->
 86 						<Rule Code="6" Tarrif="VSSOW" Name="MINIMUM STAY">
 87 						<!--Текст правила, обязательный-->
 88 							<RuleText>No Minimum Stay</RuleText>
 89 						</Rule>
 90 						<Rule Code="7" Tarrif="VSSOW" Name="MAXIMUM STAY">
 91 							<RuleText>No Maximum Stay</RuleText>
 92 						</Rule>
 93 						<Rule Code="5" Tarrif="VSSOW" Name="ADVANCE RESERVATIONS/TICKETING">
 94 							<RuleText>Advanced reservations anytime Advanced ticketing departure time - 0  Advanced ticketing reservation time - 24 hours</RuleText>
 95 						</Rule>
 96 						<Rule Code="2" Tarrif="VSSOW" Name="DAY/TIME">
 97 							<RuleText>Most restrictive ticketing date 20110524</RuleText>
 98 						</Rule>
 99 						<Rule Code="12" Tarrif="VSSOW" Name="SURCHARGES">
100 							<RuleText>No surcharges</RuleText>
101 						</Rule>
102 						<Rule Code="16" Tarrif="VSSOW" Name="PENALTIES">
103 							<RuleText>Condition: If Itinerary is changed requiring reissue of ticket. Amount -  Condition: If canceled. Amount -</RuleText>
104 						</Rule>
105 						<Rule Code="0" Tarrif="VSSOW" Name="APPLICATION AND OTHER CONDITIONS">
106 							<RuleText>Application and other conditions  
107 			rule - 304/ut23                                                
108 			unless otherwise specified                                     
109 			one way instant purchase fare                                  
110 			 application                                                   
111 			   area                                                        
112 				 these fares apply                                         
113 				 within russia.                                            
114 			   class of service                                            
115 				 these fares apply for economy class service.              
116 			   types of transportation                                     
117 				 this rule governs one-way fares.                          
118 				 fares governed by this rule can be used to create         
119 				 one-way journeys.                                         
120 			 capacity limitations                                          
121 			   the carrier shall limit the number of passengers carried    
122 			   on any one flight at fares governed by this rule and such   
123 			   fares will not necessarily be available on all flights.     
124 			   the number of seats which the carrier shall make            
125 			   available on a given flight will be determined by the       
126 			   carriers best judgment
127 							</RuleText>
128 						</Rule>
129 						<Rule Code="4" Tarrif="VSSOW" Name="FLIGHT APPLICATION">
130 							<RuleText>Flight application                                         
131 			unless otherwise specified                                     
132 			  the fare component must be on                                
133 				  one or more of the following                             
134 					any ut flight.</RuleText>
135 						</Rule>
136 						<Rule Code="5" Tarrif="VSSOW" Name="ADVANCE RES/TICKETING">
137 							<RuleText>Advance res/ticketing                                      
138 			unless otherwise specified                                     
139 			  reservations are required for all sectors.                   
140 			  ticketing must be completed within 24 hours after            
141 			  reservations are made.</RuleText>
142 						</Rule>
143 						<Rule Code="8" Tarrif="VSSOW" Name="STOPOVERS">
144 							<RuleText>Stopovers                                                  
145 			unless otherwise specified                                     
146 			  unlimited stopovers permitted.</RuleText>
147 						</Rule>
148 						<Rule Code="9" Tarrif="VSSOW" Name="TRANSFERS">
149 							<RuleText>Transfers                                                  
150 			unless otherwise specified                                     
151 			  unlimited transfers permitted on the pricing unit            
152 				fare break and embedded surface sectors permitted on the   
153 				 fare component.
154 							</RuleText>
155 						</Rule>
156 						<Rule Code="10" Tarrif="VSSOW" Name="PERMITTED COMBINATIONS">
157 							<RuleText>Permitted combinations                                     
158 			unless otherwise specified                                     
159 			   single/double open jaws/round trips/circle trips not        
160 			   permitted.                                                  
161 			   add-ons not permitted.                                      
162 			  end-on-end                                                   
163 				end-on-end combinations permitted with ut fares.           
164 				validate all fare components.                              
165 			   provided -                                                  
166 				 combinations are with any one way fare for carrier ut.</RuleText>
167 						</Rule>
168 						<Rule Code="15" Tarrif="VSSOW" Name="SALES RESTRICTIONS">
169 							<RuleText>Sales restrictions                                         
170 			unless otherwise specified                                     
171 			  tickets must be issued on ut.
172 							</RuleText>
173 						</Rule>
174 						<Rule Code="16" Tarrif="VSSOW" Name="PENALTIES">
175 							<RuleText>Penalties                                                  
176 			unless otherwise specified                                     
177 			  cancellations                                                
178 				cancellations permitted for cancel/no-show/refund.         
179 					 note -                                                
180 					  -full refund if ticket is presented for the refund   
181 					  more than 24hrs before departure time shown on the   
182 					  flight coupon.                                       
183 					  -refund the fare paid less 25 percent if ticket is   
184 					  presented for the refund less than 24hrs before      
185 					  departure time shown on the flight coupon or after   
186 					  departure time shown on the flight coupon/no-show/   
187 					  ---------------------                                
188 					  refund of unused fees and taxes permitted            
189 					  ---------------------                                
190 					  penalties waived in case of involuntary refund       
191 					  ---------------------                                
192 					  refund permitted at any time within one year from    
193 					  the day of original ticket issue.                    
194 			  changes                                                      
195 				changes permitted.                                         
196 					 note -                                                
197 					  permitted upon payment to any higher applicable      
198 					  ow fare. the difference in fares has to be           
199 					  collected.                                           
200 					  ----------------                                     
201 					  changes permitted if the ticket is presented for     
202 					  the change within 1 month from the date of           
203 					  departure shown on the original flight coupon.       
204 			  involuntary changes                                          
205 				involuntary changes permitted.
206 							</RuleText>
207 						</Rule>
208 						<Rule Code="17" Tarrif="VSSOW" Name="HIP/MILEAGE EXCEPTIONS">
209 							<RuleText>Hip/mileage exceptions                                     
210 			unless otherwise specified                                     
211 					 note -                                                
212 					  higher intermediate rule applies.                    
213 			unless otherwise specified                                     
214 					 note -                                                
215 					  higher intermediate rule applies.
216 							</RuleText>
217 						</Rule>
218 						<Rule Code="19" Tarrif="VSSOW" Name="CHILDREN DISCOUNTS">
219 							<RuleText>Children discounts                                         
220 			within russia
221 							</RuleText>
222 						</Rule>
223 						<Rule Code="6" Tarrif="VSSOW" Name="PENALTIES">
224 							<RuleText>Penalties                                                  
225 			unless otherwise specified                                     
226 			  cancellations                                                
227 				cancellations permitted for cancel/no-show/refund.         
228 					 note -                                                
229 					  -full refund if ticket is presented for the refund   
230 					  more than 24hrs before departure time shown on the   
231 					  flight coupon.                                       
232 					  -refund the fare paid less 25 percent if ticket is   
233 					  presented for the refund less than 24hrs before      
234 					  departure time shown on the flight coupon or after   
235 					  departure time shown on the flight coupon/no-show/   
236 					  ---------------------                                
237 					  refund of unused fees and taxes permitted            
238 					  ---------------------                                
239 					  penalties waived in case of involuntary refund       
240 					  ---------------------                                
241 					  refund permitted at any time within one year from    
242 					  the day of original ticket issue.                    
243 			  changes                                                      
244 				changes permitted.                                         
245 					 note -                                                
246 					  permitted upon payment to any higher applicable      
247 					  ow fare. the difference in fares has to be           
248 					  collected.                                           
249 					  ----------------                                     
250 					  changes permitted if the ticket is presented for     
251 					  the change within 1 month from the date of           
252 					  departure shown on the original flight coupon.       
253 			  involuntary changes                                          
254 				involuntary changes permitted.                             
255 			17. hip/mileage exceptions                                     
256 			unless otherwise specified                                     
257 					 note -                                                
258 					  higher intermediate rule applies.                    
259 			unless otherwise specified                                     
260 					 note -                                                
261 					  higher intermediate rule applies.                    
262 			19. children discounts                                         
263 			within russia                                                  
264 			  accompanied child 2-11 - charge 67 percent of the fare.      
265 					ticket designator - cn and percent of discount.        
266 					 note -                                                
267 					  discount applies if the number of children is 6      
268 					  or less                                              
269 					  -----------------------------------------------      
270 					  unaccompanied children not permitted                 
271 			  or - 1st and each additional group child 2-11 - charge 95    
272 					 percent of the fare.                                  
273 						 ticket designator - cn and percent of discount.   
274 					 note -                                                
275 					  discount applies if the number of children in the    
276 					  group is more than 6. group required to travel       
277 					  together for the entire pricing unit.                
278 					  -------------                                        
279 					  unaccompanied children not permitted                 
280 			  or - 1st infant under 2 without a seat - no charge           
281 						 ticket designator - in and percent of discount    
282 			  or - 2nd and each additional infant under 2 without a        
283 					 seat- charge 67 percent of the fare.                  
284 						 ticket designator - cn and percent of discount    
285 			  or - infant under 2 with a seat - charge 67 percent of the   
286 					 fare.                                                 
287 						 ticket designator - cn and percent of discount.   
288 					 note -                                                
289 					  unaccompanied infants not permitted
290 								</RuleText>
291 							</Rule>
292 							<Rule Code="20" Tarrif="VSSOW" Name="TOUR CONDUCTOR DISCOUNTS">
293 								<RuleText>Tour conductor discounts                                   
294 			unless otherwise specified                                     
295 					 note -                                                
296 					  tour conductor discounts not permitted.
297 								</RuleText>
298 							</Rule>
299 							<Rule Code="21" Tarrif="VSSOW" Name="AGENT DISCOUNTS">
300 								<RuleText>Agent discounts                                            
301 			unless otherwise specified                                     
302 					 note -                                                
303 					  agent discounts not permitted.
304 								</RuleText>
305 							</Rule>
306 							<Rule Code="22" Tarrif="VSSOW" Name="ALL OTHER DISCOUNTS">
307 								<RuleText>All other discounts                                        
308 			unless otherwise specified                                     
309 					 note -                                                
310 					  not permitted.
311 								</RuleText>
312 							</Rule>
313 						</Rules>
314 					</GetAirRules>
315 			</Response>
316 			<!--Авторизация, обязательный-->
317 			<!--@ClientId, идентификатор клиента, обязательный-->
318 			<!--@APIKey, API ключ клиента, обязательный-->
319 			<!--@Language, код языка, обязательный-->
320 			<!--@Currency код валюты, обязательный-->
321             <Source>
322                <ClientId>102</ClientId>
323                <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
324                <Language>RU</Language>
325                <Currency>RUB</Currency>
326             </Source>
327          </ResponseBin>
328       </ver:AirAvail>
329    </soapenv:Body>
330 </soapenv:Envelope>
331 </syntaxhightlight>
332 
333 == Запрос на выписку ==
334 Данный запрос запускается после оплаты заказа, может быть запущен как в ручную - пользователем, у которого есть на это права, так и автоматически при использовании соответствующей опции. Выписать неоплаченный заказ через Nemo возможности нет. При запуске запроса на выписку также запускается процесс обновления заказа, в ходе которого сверяется цена и остальные параметры заказа, а также проверяется его актуальность. Заказы, с истекшим таймлимитом выписаны через Nemo быть не могут.
335 
336 WSDL: http://sys.nemo-ibe.com/nemoflights/wsdl.php?for=Ticketing
337 
338 
339 '''Примеры запроса и ответа:'''
340 
341 '''REQUEST'''
342 
343 <syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
344 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DTicketing">
345    <soapenv:Header/>
346    <soapenv:Body>
347       <ver:Ticketing>
348          <RequestBin>
349             <Request>
350 	        <!--Запрос, обязательный-->
351 		<Ticketing>		
352 		<BookID>21032</BookID>
353 		<!--Валидирующий перевозчик (тот кто выписывает билет), необязательный-->		
354 		<ValCompany></ValCompany>
355 		<!--Комиссии, указывается или в валюте, или в процентах, для валюты обязательным является код валюты.
356 		Если указана и в валюте и в процентах, то у поставщика комиссия устанавливается в валюте.-->
357 		<!--@Amount - комиссия в валюте-->
358 		<!--@Percent - комиссия в процентах-->
359 		<!--@CurrencyCode - код валюты комиссии-->
360 		<!--Optional:-->
361 		<Comission Amount="" Percent="" CurrencyCode=""/>		
362 		</Ticketing>
363 	    </Request>  
364             <!--Авторизация, обязательный-->
365 		<!--@ClientId, идентификатор клиента, обязательный-->
366 		<!--@APIKey, API ключ клиента, обязательный-->
367 		<!--@Language, код языка, обязательный-->
368 		<!--@Currency код валюты, обязательный-->
369             <Source>
370                <ClientId>102</ClientId>
371                <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
372                <Language>RU</Language>
373                <Currency>RUB</Currency>
374             </Source>
375          </RequestBin>
376       </ver:Ticketing>
377    </soapenv:Body>
378 </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ЧЧ:ММ:СС. Если бронирование не будет аннулировано или выписано до этого времени, то могут быть применены штрафы.

См. также

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

Версия 12:18, 8 февраля 2014

Содержание

Агентский АПИ поиска авиабилетов и бронирования

Агентский АПИ выписки

Отмена бронирования

Проверка на доступность

Запрос на обновление заказа

Войдирование билета

Параметры, используемые в запросах

Параметры, используемые в ответах

См. также

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты