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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Отмена бронирования)
(Отмена бронирования)
Строка 73: Строка 73:
 
'''RESPONSE'''
 
'''RESPONSE'''
 
<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://tst.nemo-ibe.com/nemoflights/?version%3D1.0%26for%3DVoidTicket">
+
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://trunk.mlsd.ru/nemoflights/?version%3D1.0%26for%3DCancelBook" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header/>
+
   <SOAP-ENV:Body>
   <soapenv:Body>
+
       <ns1:CancelBookResponse>
       <ver:CancelBook>
+
         <ResponseBin>
         <ResponseBin>
 
 
             <Response>
 
             <Response>
<!--Запрос, обязательный-->
+
              <!--BookID - Ид брони в системе немо, целое число-->
<!--@BookID - Ид брони в системе немо, целое число, обязательный-->
+
              <CancelBook BookID="260646">
<CancelBook BookID="209901">
+
                  <!--Result, Отмена брони-->
  <!--Result, Отмена брони, обязательный-->
+
                  <!--Sucscess, Результат отмены брони, true или false-->
  <!--@Sucscess, Результат отмены брони, true или false, обязательный-->
+
                  <Result Success="true"/>
  <Result Success="true"/>
+
              </CancelBook>
</CancelBook>
+
               <Requisites/>
    </Response> 
+
               <RequestType xsi:nil="true"/>
    <!--Авторизация, обязательный-->
+
               <UserID xsi:nil="true"/>
    <!--@ClientId, идентификатор клиента, обязательный-->
+
               <Errors xsi:nil="true"/>
    <!--@APIKey, API ключ клиента, обязательный-->
+
             </Response>
    <!--@Language, код языка, обязательный-->
 
    <!--@Currency код валюты, обязательный-->
 
            <Source>
 
               <ClientId>102</ClientId>
 
               <APIKey>7F48365D42B73307C99C12A578E92B36</APIKey>
 
               <Language>RU</Language>
 
               <Currency>RUB</Currency>
 
             </Source>
 
 
         </ResponseBin>
 
         </ResponseBin>
       </ver:CancelBook>
+
       </ns1:CancelBookResponse>
   </soapenv:Body>
+
   </SOAP-ENV:Body>
</soapenv:Envelope>
+
</SOAP-ENV:Envelope>
 
</syntaxhighlight>
 
</syntaxhighlight>
  

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


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

   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://trunk.mlsd.ru/nemoflights/?version%3D1.0%26for%3DCancelBook">
 2    <soapenv:Header/>
 3    <soapenv:Body>
 4       <ver:CancelBook>
 5          <RequestBin>
 6             <Request>
 7                <!--Запрос, обязательный-->
 8                <CancelBook BookID="260646"/>
 9                <!--BookID - Ид брони в системе немо, целое число, обязательный-->
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://trunk.mlsd.ru/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://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>

Чтение тарифных правил

Чтение тарифных правил - это запрос, который отправляется после того, как пользователь на результатах поиска выбрал перелет и нажал «Забронировать». При помощи него 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ЧЧ:ММ:СС. Если бронирование не будет аннулировано или выписано до этого времени, то могут быть применены штрафы.

См. также