Выгрузка заказов

Выгрузка заказов — это экспорт данных заказа или заказов для различных компонентов системы Nemo.

Описание

Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.

Процесс выгрузки

Схематично процесс выгрузки заказов представлен на блок-схеме.

Внимание!

• Выгрузка заказа в формате СОФИ при синхронизации произойдет только если в заказе произошли изменения.
• Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.

Настройки

Настройка процесса выгрузки заказов для авиабилетов

Настройки выгрузки заказов доступны в разделе Настройки системы → Интеграция → Выгрузка заказов.

• Выгрузка одновременно и Nemo, и Софи — настройка позволяет производить экспорт данных одновременно в двух форматах.
  Внимание! Опция доступна только для компонента «Авиабилеты», при включенном модуле «Выгрузка заказов Софи».
• Тип выгрузки — настройка определяет один из доступных форматов выгрузки заказов:
  • Выгрузка заказов Nemo — внутренний формат системы Nemo, доступен по умолчанию.
  • Выгрузка заказов Софи — дополнительный формат, становится доступным при включении модуля «Выгрузка заказов Софи».
• Url скрипта для выгрузки в выбранном формате — URL, на который будет производиться выгрузка данных. Cистема Nemo отправляет файлы выгрузки на указанный в этом поле http-адрес через POST-запрос (см. https://ru.wikipedia.org/wiki/POST_(HTTP)). Скрипт для обработки получаемых данных должен быть написан на стороне самого клиента. Задача скрипта - принять данные и корректно их обработать. Все данные, которые можно получить через браузер, также можно получить и альтернативными программными средствами (автоматизируя процесс выгрузки). Рекомендуется к использованию библиотека CURL (см. https://ru.wikipedia.org/wiki/CURL) Готовые примеры скриптов сотрудники Nemo не предоставляют.
  Если у субагента указан свой Url скрипта для выгрузки, отличный от URL корневого агенства, то выгрузка по заказам этого субагента будет идти на оба адреса. Главный агент получает информацию по всем заказам всех субагентов, субагент получает выгрузку только своих заказов.
  Внимание! Указание отдельного URL скрипта для выгрузки для субагентов доступно только для формата Nemo.
• Код сайта в системе Софи — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в Немо. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства.
  Внимание! Необходимо заполнить поля "Url стороннего скрипта для XML уведомлений" и "Код сайта в системе Софи", которые становятся доступными только при переключении "Типа выгрузки" в значение "Выгрузка заказов Софи", а также поле "Url стороннего скрипта для XML уведомлений" для типа выгрузки "Nemo".
• Повторная отправка в случае неудачи — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
• Список адресов для уведомлений (разделяется запятыми) — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
• Экспортировать после оплаты — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа.
  Внимание! Доступно только для формата Nemo.
• Экспортировать код доступа к заказу — настройка включает отображение кода доступа в выгрузке.
• Отправлять нотификацию о необходимости установки кода валидатора в реквизитах — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
• E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах
• Временная зона для дат - настройка позволяет менять временную зону в выгрузке Софи.
  

  Настройка "Временная зона для дат"
  • Использовать временную зону системных настроек, через которую будет использоваться часовой пояс указанный в "Настройках системы".
  • Использовать временную зону реквизитов - часовой пояс подтягивается индивидуально от каждого пакета реквизитов подключения к ГДС.
  • Выбрать другую временную зону дает возможность выбирать временную зону, независимо от других настроек.

Форматы выгрузки заказов

Система поддерживает выгрузку заказов в форматах Nemo и Софи.

Компоненты, поддерживающие выгрузку заказов

	Авиабилеты	Отели	ЖД
Формат Nemo	+	+	+
Формат Софи	+	−	−

События, поддерживающие выгрузку заказов

Авиабилеты	Бронирование	Оплата*	Синхронизация**	Выписка	Войдирование	Аннуляция***
Формат Nemo	+	+	+	+	+	+
Формат Софи	−	−	+	+	+	+

Отели	Бронирование	Оплата*	Синхронизация**	Выписка	Войдирование	Аннуляция
Формат Nemo	+	+	+	−	войдирование отсутствует	+

ЖД	Бронирование	Оплата	Синхронизация**	Выписка	Войдирование	Аннуляция
Формат Nemo	+	+	+	+	+	+

*  Выгрузка заказа в формате немо при оплате произойдет только если включена настройка «Экспортировать после оплаты» в разделе «Заказы» → «Выгрузка заказов».
** Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.
***  Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.

Статусы выгрузки заказа

Коды статусов выгрузки заказа соответствуют кодам состояния HTTP. Фактически указывается последний полученный код состояния HTTP, полученный при выгрузке данных по адресу, указанному в настройках выгрузки. Коды относятся к серверу, на который происходит выгрузка заказов.

Код	Описание
0	Неизвестный ответ. Адрес для выгрузки не доступен.
200	OK — успешный запрос.
301	Запрошенный документ был окончательно перенесен на новый URI, указанный в поле Location заголовка.
403	Сервер понял запрос, но он отказывается его выполнять из-за ограничений в доступе для клиента к указанному ресурсу.
404	Сервер понял запрос, но не нашёл соответствующего ресурса по указанному URI.
422	Unprocessable Entity — сервер успешно принял запрос, может работать с указанным видом данных, в теле запроса XML-документ имеет верный синтаксис, но имеется какая-то логическая ошибка, из-за которой невозможно произвести операцию над ресурсом.
500	Любая внутренняя ошибка сервера.

Выгрузка заказа для компонента «Авиабилеты»

Для компонента «Авиабилеты» доступна выгрузка заказов в форматах Nemo и/или Софи (при включенном модуле «Выгрузка заказов Софи»).

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3   <Common>
  4     <id>277749</id>
  5     <Type>FLIGHTS</Type>
  6     <Service>SABRE</Service>
  7     <Locator>SQLJNK</Locator>
  8     <ExternalId>1234567</ExternalId> <!-- Внешний идентификатор -->
  9     <Stamp>123456789</Stamp>
 10     <UtmSource>100</UtmSource> <!-- Источник перехода -->
 11     <BeginDateTime>2014.12.18-10:45</BeginDateTime>
 12     <EndDateTime>2014.12.25-16:40</EndDateTime>
 13     <TicketingDateTime>2014.12.09-15:02</TicketingDateTime>
 14     <VoidDateTime/>
 15     <TotalPrice>
 16       <Amount>10773.8</Amount>
 17       <CurrencyCode>RUB</CurrencyCode>
 18     </TotalPrice>
 19     <UserId>2964</UserId>
 20     <EEUserId/>
 21     <UserLogin>userLogin</UserLogin>
 22     <GroupId>2963</GroupId>
 23     <CompanyId>2963</CompanyId>
 24     <UserStatus>Менеджер</UserStatus>
 25     <DateCreate>2014.12.09-14:59</DateCreate>
 26     <ExtServices> <!-- Дополнительные услуги -->
 27       <ExtService>
 28         <Type>ServicePack</Type> <!-- Сервисные пакеты -->
 29         <Price>
 30           <Amount>200</Amount>
 31           <CurrencyCode>RUB</CurrencyCode>
 32         </Price>
 33       </ExtService>
 34       <ExtService>
 35         <Type>AeroExpress</Type>
 36         <Price>
 37           <Amount>1440</Amount>
 38           <CurrencyCode>RUB</CurrencyCode>
 39         </Price>
 40       </ExtService>
 41       <ExtService>
 42         <Type>AlphaInsurance</Type>
 43         <Price>
 44           <Amount>480</Amount>
 45           <CurrencyCode>RUB</CurrencyCode>
 46         </Price>
 47         <Insurances>
 48           <Insurance>
 49             <Number>Z694.198TEST.2765282</Number>
 50             <Fio>IVANOV IVAN</Fio>
 51           </Insurance>
 52           <Insurance>
 53             <Number>Z694.198TEST.2765283</Number>
 54             <Fio>PETROV PETR</Fio>
 55           </Insurance>
 56         </Insurances>
 57       </ExtService>
 58     </ExtServices>
 59   </Common>
 60   <Payment>
 61     <Title>Testpay</Title>
 62     <Method>Testpay</Method>
 63     <BillingId>117607091</BillingId>
 64     <Date>2014-12-09 15:00:39</Date>
 65     <CreateDate>2014-12-09 15:00:34</CreateDate>
 66     <Status>ticket</Status>
 67     <PenaltyDate/>
 68     <Timelimit>2014-12-10 14:59:55</Timelimit>
 69     <PaymentCharge> <!-- Сбор платежного шлюза -->
 70       <Amount>313.8</Amount>
 71       <CurrencyCode>RUB</CurrencyCode>
 72     </PaymentCharge>
 73     <Charge> <!-- Общий сбор минус сбор платежного шлюза -->
 74       <Amount>1920</Amount>
 75       <CurrencyCode>RUB</CurrencyCode>
 76     </Charge>
 77     <BaseFare> <!-- Тариф -->
 78       <Amount>1600</Amount>
 79       <CurrencyCode>RUB</CurrencyCode>
 80     </BaseFare>
 81     <Book> <!-- Тариф плюс таксы -->
 82       <Amount>8540</Amount>
 83       <CurrencyCode>RUB</CurrencyCode>
 84     </Book>
 85     <Penalty>
 86       <Amount>0</Amount>
 87       <CurrencyCode>RUB</CurrencyCode>
 88     </Penalty>
 89     <Total>
 90       <Amount>10773.8</Amount>
 91       <CurrencyCode>RUB</CurrencyCode>
 92     </Total>
 93     <Commission>
 94       <Amount>0</Amount>
 95       <CurrencyCode>RUB</CurrencyCode>
 96     </Commission>
 97     <PaidValue>
 98       <Amount>10773.8</Amount>
 99       <CurrencyCode>RUB</CurrencyCode>
100     </PaidValue>
101   </Payment>
102   <Client>
103     <LastName/>
104     <Name>SIDOROV PETR</Name>
105     <MiddleName/>
106     <Number/>
107     <Birth/>
108     <Email>mail@host.com</Email>
109     <Phone>+74950000000</Phone>
110   </Client>
111   <PassengersCount>2</PassengersCount>
112   <Passengers>
113     <Passenger>
114       <passenger_type>ADT</passenger_type>
115       <lastname>IVANOV</lastname>
116       <name>IVAN</name>
117       <gender>F</gender>
118       <date_of_birth>12.12.1987</date_of_birth>
119       <doc_type>C</doc_type>
120       <passport_number>1234567890</passport_number>
121       <currency_of_passport>24.03.2023</currency_of_passport>
122       <middlename/>
123       <passenger_id>37667</passenger_id>
124       <nationality>RU</nationality>
125       <email>mail@host.com</email>
126       <Tickets>
127         <Active>0</Active>
128         <Seg/>
129         <Num>5553984070962</Num>
130         <Date>2014-12-09 16:01:00</Date>
131       </Tickets>
132       <Tickets>
133         <Active>1</Active>
134         <Seg/>
135         <Num>5553984070964</Num>
136         <Date>2014-12-09 16:03:00</Date>
137       </Tickets>
138       <PriceInfo>
139         <BaseFare>
140           <Amount>800</Amount>
141           <CurrencyCode>RUB</CurrencyCode>
142         </BaseFare>
143         <TotalFare>
144           <Amount>4270</Amount>
145           <CurrencyCode>RUB</CurrencyCode>
146         </TotalFare>
147         <Commission>
148           <Amount>0</Amount>
149           <CurrencyCode>RUB</CurrencyCode>
150         </Commission>
151         <AirlineCommission>
152           <Amount>0</Amount>
153           <CurrencyCode>RUB</CurrencyCode>
154         </AirlineCommission>
155       </PriceInfo>
156     </Passenger>
157     <Passenger>
158       <passenger_type>ADT</passenger_type>
159       <doc_type>C</doc_type>
160       <middlename/>
161       <passenger_id>37668</passenger_id>
162       <lastname>PETROV</lastname>
163       <name>PETR</name>
164       <gender>M</gender>
165       <date_of_birth>20.12.1984</date_of_birth>
166       <passport_number>1234567899</passport_number>
167       <currency_of_passport>20.12.2029</currency_of_passport>
168       <nationality>RU</nationality>
169       <email>mail@host.com</email>
170       <Tickets>
171         <Active>0</Active>
172         <Seg/>
173         <Num>5553984070963</Num>
174         <Date>2014-12-09 16:01:00</Date>
175       </Tickets>
176       <Tickets>
177         <Active>1</Active>
178         <Seg/>
179         <Num>5553984070965</Num>
180         <Date>2014-12-09 16:03:00</Date>
181       </Tickets>
182       <PriceInfo>
183         <BaseFare>
184           <Amount>800</Amount>
185           <CurrencyCode>RUB</CurrencyCode>
186         </BaseFare>
187         <TotalFare>
188           <Amount>4270</Amount>
189           <CurrencyCode>RUB</CurrencyCode>
190         </TotalFare>
191         <Commission>
192           <Amount>0</Amount>
193           <CurrencyCode>RUB</CurrencyCode>
194         </Commission>
195         <AirlineCommission>
196           <Amount>0</Amount>
197           <CurrencyCode>RUB</CurrencyCode>
198         </AirlineCommission>
199       </PriceInfo>
200     </Passenger>
201   </Passengers>
202   <FlightType>Внутренний</FlightType>
203   <Marker/>
204   <BookingCode>4R72Z4</BookingCode> 
205   <OrderInfo>
206     <Info>
207       <Company>Аэрофлот - Российские авиалинии</Company>
208       <CompanyCode>SU</CompanyCode>
209       <OperatingCompanyCode>FV</OperatingCompanyCode>
210       <StartDate>2014.12.18</StartDate>
211       <StartTime>10:45</StartTime>
212       <StartDayOfWeek>Thursday</StartDayOfWeek>
213       <FlightNumber>6128 (FV6128)</FlightNumber>
214       <StartAirportCode>VKO</StartAirportCode>
215       <StartAirportName>Внуково, Москва</StartAirportName>
216       <StartCountry>Россия</StartCountry>
217       <StartCountryCode>RU</StartCountryCode>
218       <EndAirportCode>LED</EndAirportCode>
219       <EndAirportName>Санкт-Петербург, Пулково</EndAirportName>
220       <EndCountry>Россия</EndCountry>
221       <EndCountryCode>RU</EndCountryCode>
222       <Time>1:30</Time>
223       <Equip>
224         <Name>Airbus 319</Name>
225         <Type>319</Type>
226       </Equip>
227       <ClassType>economy</ClassType>
228       <ClassTypeCode>R</ClassTypeCode>
229       <Meal/>
230     </Info>
231     <Info>
232       <Company>Аэрофлот - Российские авиалинии</Company>
233       <CompanyCode>SU</CompanyCode>
234       <OperatingCompanyCode>FV</OperatingCompanyCode>
235       <StartDate>2014.12.25</StartDate>
236       <StartTime>15:10</StartTime>
237       <StartDayOfWeek>Thursday</StartDayOfWeek>
238       <FlightNumber>6153 (FV6153)</FlightNumber>
239       <StartAirportCode>LED</StartAirportCode>
240       <StartAirportName>Санкт-Петербург, Пулково</StartAirportName>
241       <StartCountry>Россия</StartCountry>
242       <StartCountryCode>RU</StartCountryCode>
243       <EndAirportCode>VKO</EndAirportCode>
244       <EndAirportName>Внуково, Москва</EndAirportName>
245       <EndCountry>Россия</EndCountry>
246       <EndCountryCode>RU</EndCountryCode>
247       <Time>1:30</Time>
248       <Equip>
249         <Name>Airbus 319</Name>
250         <Type>319</Type>
251       </Equip>
252       <ClassType>economy</ClassType>
253       <ClassTypeCode>R</ClassTypeCode>
254       <Meal/>
255     </Info>
256   </OrderInfo>
257   <Remarks>Debit</Remarks>
258   <Returns> <!-- Блок с заявками на возврат -->
259     <Return>
260       <ExpertUserId>2411</ExpertUserId>
261       <Id>458463</Id>
262       <Price>
263         <Amount>-5997.17</Amount> <!-- Сумма к возврату, рассчитанная в заявке на возврат -->
264         <CurrencyCode>RUB</CurrencyCode>
265       </Price>
266       <PassengersData>
267         <Data>
268           <PassengerNum>2</PassengerNum>
269           <SegmentNums>
270             <SegmentNum>1</SegmentNum>
271             <SegmentNum>2</SegmentNum>
272           </SegmentNums>
273         </Data>
274       </PassengersData>
275       <IsFull>0</IsFull>
276       <IsCompelled>0</IsCompelled>
277     </Return>
278   </Returns>
279   <Exchanges>  <!-- Блок с заявками на обмен -->
280     <Exchange>
281       <ExpertUserId>2411</ExpertUserId>
282       <Id>458480</Id>
283       <Price>
284         <Amount>2279.06</Amount>  <!-- Сумма к доплате, рассчитанная в заявке на обмен -->
285         <CurrencyCode>RUB</CurrencyCode>
286       </Price>
287       <Text>Причина создания заявки</Text>
288     </Exchange>
289   </Exchanges>
290 </PNR>

Внимание! В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.

Ремарка <Remarks>Debit</Remarks> является не обязательной, означает что заказ был оплачен с помощью способа оплаты «Депозит»; если же заказ был оплачен с использованием депозитного кредита, и депозит ушел в минус даже на 1 руб., то будет <Remarks>Credit</Remarks>.

Элемент <TotalFare> возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.

Элемент <CreateDate> в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.

Блок <Returns> и <Exchanges> содержит данные по заявкам на обмен и/или возврат, которые привязаны к заказу. В выгрузку попадает информация только о выполненных заявках на обмен и/или возврат. Важно учесть, что сумма к возврату по заявке указана со знаком «-», а сумма к доплате идет без дополнительных знаков.

Формат поддерживает возможность передачи нескольких номеров электронных билетов на одного пассажира (в том числе войдированных и аннулированных).

Формат Софи

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <order_snapshot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 3   <header currency="RUB" time_gmt="2015-01-13 08:10:54" time="2015-01-13 12:10:54" ord_id="279307" corp_ord_id="MKQFBZ" site="2806"/>
 4   <customer email="cepogilixe@lackmail.net" phone="XXXX9048" name="" corp_code="2806"/>
 5   <products>
 6     <product>
 7      <!--@stamp - валидатор. Парсится из заказа(Сирена и Галилео). Если получить из ГДС не удалось, то передаётся валидатор, настроенный в реквизитах подключения к ГДС.-->
 8       <air_ticket_prod prod_id="0" psg_type="A" title="Москва - Ленинград" taxes="1776" fare="400" crs_taxes="63.49" crs_fare="107" origin="MOW" service_fee="100" form_owner="SU" validating_carrier="SU"supplier="RM5G" destination="LED" comission="0.4" stamp="92354802">
 9         <air_seg segment_id="0" carrier="SU" flight_number="6128" op_carrier="FV" departure_datetime="2015-01-16 10:45:00" arrival_datetime="2015-01-16 12:15:00" departure_airport="VKO" arrival_airport="LED" fare_basis="RPROWRF"/>
10       </air_ticket_prod>
11     </product>
12     <product>
13       <ral_ticket_prod rsrv_id="2496500" prod_id="200" origin="Киевский вокзал" destination="Внуково, Москва" departure_datetime="2015-01-16 06:45:00" cartype="standart" fare="360"/>
14     </product>
15     <product>
16       <service_prod price="200" main_ticket_prod_id="200" prod_id="400" psgr_id="0" offer_type="Cервисные пакеты"/>
17     </product>
18     <product>
19       <service_prod prod_id="300" provider_type="INSURANCE" provider_id="AlphaInsurance" offer_type="Название программы страхования" ext_id="Z694.198TEST.2774397" price="100" count="1" psgr_id="0"/>
20     </product>
21     <product>
22       <payment_prod price="123"/>
23     </product>
24   </products>
25   <reservations>
26     <reservation rsrv_id="279307" crs="SABRE" rloc="MKQFBZ"crs_currency="EUR" crs_currency_rate="45"/>
27     <reservation rsrv_id="2496500" crs="AeroExpress" rloc="218812"/>
28   </reservations>
29   <passengers>
30     <passenger doc_number="1234567890" psgr_id="0" doc_country="RU" psgr_type="A" doc_type="C" birth_date="1990-01-04" name="IVAN" gender="M" first_name="IVANOV"/>
31   </passengers>
32   <travel_docs>
33     <travel_doc>
34       <air_ticket_doc tkt_oper="TKT" tkt_number="5555871998698" tkt_date="2015-01-13 12:10:50" prod_id="0" psgr_id="0" issuingAgent="2807"/>
35     </travel_doc>
36     <travel_doc>
37       <aex_doc rsrv_id="2496500" prod_id="200" psgr_id="0" tkt_oper="TKT" tkt_date="2015-01-13 12:10:54" tkt_number="394612"/>
38     </travel_doc>
39     <travel_doc>
40       <insur_doc main_prod_id="0" prod_id="300" psgr_id="0" tkt_oper="TKT" tkt_date="2015-01-13 12:10:54" tkt_number="Z694.198TEST.2774397"/>
41     </travel_doc>
42   </travel_docs>
43   <payments>
44     <payment pay_id="117607839" pay_oper="PAY" pay_time="2015-01-13 12:09:52" psp_code="024" psp_name="Rapida" psp_pay_id="" pay_system="ES" amount="2859" fop="CA"/>
45   </payments>
46 </order_snapshot>

Внимание! В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.

• service_fee — сбор агентский (только сервисный сбор, не включает в себя сбор за эквайринг), отображается только на первом билете (отдельно для каждого пассажира).
• comission - комиссия АК
• stamp - код Валидатора в PCC, берется из настроек Немо, если в настройках он не указан, то не передается.
• ord_id — идентификатор заказа в НЕМО
• corp_ord_id — PNR из ГДС
• site — идентификатор агентства в Немо
• payment pay_id — номер биллинга Немо.
• pay_system — код платежной системы
  • SB — для сбербанка
  • ES — для Рапиды
  • UNT — для Юнителлера
• psp_name — отображает разделение суммы сбора платежного шлюза и цены билета
  • Uniteller — оплата Юнителлер (банк)
  • Uniteller_GDS — оплата через GDS-процессинг (Юнителлер)
• cardholder — держатель карты.
• expire_date — срок действия карты, у тех ПШ, что не приходит в ответе — пустой.
• card_number — номер карты, в формате: 415481XXXXXX1734
• approval_code — код подтверждения.
• payment_prod price — сбор за эквайринг.
• main_ticket_prod_id - id билета в выгрузке, формируется как смещение для авиабилетов (200) + id пассажира;
• prod_id - id сервисного пакета в выгрузке, формируется как смещение (400) + номер по порядку;
• tkt_number - номер полиса для пассажира;
• tkt_date - дата и время операции;
• tkt_oper - тип операции (TKT - выписка/CANX - отмена выписки, аннуляция).
• provider_type - тип поставщика (INSURANCE).
• provider_id - AlphaInsurance;
• offer_type - название полиса;
• price - цена полиса для пассажира;
• rloc - номер заказа у поставщика;
• currency - основная валюта сайта (валюта расчетов, валюта оплаты);
• crs_currency - валюта расчетов с поставщиком (c ГДС);
• crs_currency_rate - курс валюты поставщика;
• no_conj_tickets – число дополнительных билетов (отображается при количестве сегментов более 4 включительно);
• surface_seg - передача наземного участка (в том случае, если аэропорт прилета одного сегмента не совпадает с аэропортом вылета следующего);
• supplier - номер PCC (подтягивается в том случае, если указан в реквизитах подключения).

Выгрузка заказа для компонента «Отели»

Для компонента «Отели» доступна выгрузка заказов в формате Nemo.

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3    <Common>
  4       <id>263462</id>
  5       <Type>HOTELS</Type>
  6       <Service>ACADEM</Service>
  7       <Locator>3028655</Locator>
  8       <BeginDateTime>2014.04.15-00:00</BeginDateTime>
  9       <EndDateTime>2014.04.16-00:00</EndDateTime>
 10       <TotalPrice>
 11          <Amount>1950</Amount>
 12          <CurrencyCode>RUB</CurrencyCode>
 13       </TotalPrice>
 14       <UserId>123</UserId>
 15       <EEUserId />
 16       <UserLogin>userLogin</UserLogin>
 17       <GroupId>332</GroupId>
 18       <UserStatus>Менеджер</UserStatus>
 19       <DateCreate>2014.03.21-16:11</DateCreate>
 20    </Common>
 21    <Payment>
 22       <Status>booked</Status>
 23       <PenaltyDate>2014.04.13-00:00</PenaltyDate>
 24       <Timelimit>2014-04-13 00:00:00</Timelimit>
 25       <Charge>
 26          <Amount>0</Amount>
 27          <CurrencyCode>RUB</CurrencyCode>
 28       </Charge>
 29       <Book>
 30          <Amount>1950</Amount>
 31          <CurrencyCode>RUB</CurrencyCode>
 32       </Book>
 33       <Penalty>
 34          <Amount>0</Amount>
 35          <CurrencyCode>RUB</CurrencyCode>
 36       </Penalty>
 37       <Total>
 38          <Amount>1950</Amount>
 39          <CurrencyCode>RUB</CurrencyCode>
 40       </Total>
 41       <Commission>
 42          <Amount>112</Amount>
 43          <CurrencyCode>RUB</CurrencyCode>
 44       </Commission>
 45       <PaidValue>
 46          <Amount>0</Amount>
 47          <CurrencyCode>RUB</CurrencyCode>
 48       </PaidValue>
 49    </Payment>
 50    <Client>
 51       <LastName>Сидоров</LastName>
 52       <Name>Владимир</Name>
 53       <MiddleName>Константинович</MiddleName>
 54       <Number>1806326598</Number>
 55       <Birth>1987-05-20</Birth>
 56       <Email>mail@host.com</Email>
 57       <Phone>+79871234567</Phone>
 58    </Client>
 59    <Passengers>
 60       <Passenger>
 61          <nationality>RU</nationality>
 62          <lastname>IVANOV</lastname>
 63          <name>IVAN</name>
 64       </Passenger>
 65    </Passengers>
 66    <Info>
 67       <Name>Интурист</Name>
 68       <City>
 69          <Code>34</Code>
 70          <Name>Великий Новгород</Name>
 71       </City>
 72       <Location />
 73       <StarRating>3</StarRating>
 74       <Days>2</Days>
 75       <Nights>1</Nights>
 76       <CheckInDate>2014.04.15</CheckInDate>
 77       <CheckOutDate>2014.04.16</CheckOutDate>
 78       <CheckInTime>14:00</CheckInTime>
 79       <CheckOutTime>12:00</CheckOutTime>
 80       <OnRequest>false</OnRequest>
 81    </Info>
 82    <Rooms>
 83       <Room>
 84          <Name>Двухместный стандарт (две кровати)</Name>
 85          <Type>SNGL</Type>
 86          <FareId>1</FareId>
 87       </Room>
 88    </Rooms>
 89    <Fares>
 90       <Fare>
 91          <Id>1</Id>
 92          <Price>
 93             <Amount>1950</Amount>
 94             <CurrencyCode>RUB</CurrencyCode>
 95          </Price>
 96          <Meals>Завтрак "Шведский стол",Отсутствует</Meals>
 97          <Description>Одноместный</Description>
 98       </Fare>
 99    </Fares>
100    <CancelCharges>
101       <Charge>
102          <DateFrom>2014.04.13-00:00</DateFrom>
103          <DateTo>2014.04.15-00:00</DateTo>
104          <Amount>1488</Amount>
105          <CurrencyCode>RUB</CurrencyCode>
106       </Charge>
107    </CancelCharges>
108    <ModifyCharges />
109    <ModificationMethods>
110       <Method>MOD_PASS_NAMES</Method>
111       <Method>MOD_DATES</Method>
112    </ModificationMethods>
113 </PNR>

Выгрузка заказа для компонента «ЖД»

Для компонента «ЖД» доступна выгрузка заказов в формате Nemo.

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3    <Common>
  4       <id>123456</id>
  5       <Type>TRAINS</Type>
  6       <Service>UFS</Service>
  7       <Locator>64345987</Locator>
  8       <BeginDateTime>2014.04.26-00:15</BeginDateTime>
  9       <EndDateTime>2014.04.26-13:33</EndDateTime>
 10       <TicketingDateTime>2014.06.06-15:10</TicketingDateTime>
 11       <VoidDateTime>2014.06.07-14:19</VoidDateTime>
 12       <TotalPrice>
 13          <Amount>57505.8</Amount>
 14          <CurrencyCode>RUB</CurrencyCode>
 15       </TotalPrice>
 16       <UserId>123</UserId>
 17       <EEUserId />
 18       <UserLogin>mikhalevtur</UserLogin>
 19       <GroupId>122</GroupId>
 20       <UserStatus>Менеджер</UserStatus>
 21       <DateCreate>2014.04.24-15:03</DateCreate>
 22    </Common>
 23    <Payment>
 24       <Title>Testpay</Title>
 25       <Method>Testpay</Method>
 26       <BillingId>117603370</BillingId>
 27       <Date>2014-04-24 15:10:12</Date>
 28       <CreateDate>2014-06-06 15:10:00</CreateDate>
 29       <Status>cancelled</Status>
 30       <PenaltyDate />
 31       <Timelimit>2014-04-24 15:18:01</Timelimit>
 32       <Charge>
 33          <Amount>52278</Amount>
 34          <CurrencyCode>RUB</CurrencyCode>
 35       </Charge>
 36       <Book>
 37          <Amount>5227.8</Amount>
 38          <CurrencyCode>RUB</CurrencyCode>
 39       </Book>
 40       <Penalty>
 41          <Amount>0</Amount>
 42          <CurrencyCode>RUB</CurrencyCode>
 43       </Penalty>
 44       <TotalAgencyChargeForRefund>
 45          <Amount>100</Amount>
 46          <CurrencyCode>RUB</CurrencyCode>
 47       </TotalAgencyChargeForRefund>
 48       <Total>
 49          <Amount>57505.8</Amount>
 50          <CurrencyCode>RUB</CurrencyCode>
 51       </Total>
 52       <PaidValue>
 53          <Amount>0</Amount>
 54          <CurrencyCode>RUB</CurrencyCode>
 55       </PaidValue>
 56    </Payment>
 57    <Client>
 58       <LastName>Сидоров</LastName>
 59       <Name>Владимир</Name>
 60       <MiddleName>Константинович</MiddleName>
 61       <Number>1806326598</Number>
 62       <Birth>1987-05-20</Birth>
 63       <Email>mail@host.com</Email>
 64       <Phone>+79871234567</Phone>
 65    </Client>
 66    <Passengers>
 67       <Passenger>
 68          <name>Владимир</name>
 69          <middlename>Константинович</middlename>
 70          <phone>
 71             <country />
 72             <city />
 73             <number>+79271031610</number>
 74             <expansion />
 75          </phone>
 76          <email>mlsdsar@gmail.com</email>
 77          <nationality>RU</nationality>
 78          <passenger_type>ADT</passenger_type>
 79          <lastname>Сидоров</lastname>
 80          <doc_type>C</doc_type>
 81          <passport_number>1806326598</passport_number>
 82          <passenger_id>1</passenger_id>
 83          <gender>M</gender>
 84          <date_of_birth>20.04.1984</date_of_birth>
 85          <TotalPrice>28752.9</TotalPrice>
 86          <FarePrice>2613.9</FarePrice>
 87          <Charge>26139</Charge>
 88          <RefundMoney>8649.3</RefundMoney>
 89          <ChargeForRefund>100</ChargeForRefund>
 90          <TicketNumber>74944708487545</TicketNumber>
 91          <SeatNumber>033</SeatNumber>
 92          <HasSeat>true</HasSeat>
 93       </Passenger>
 94       <Passenger>
 95          <nationality>RU</nationality>
 96          <middlename>Константинович</middlename>
 97          <passenger_type>ADT</passenger_type>
 98          <lastname>Сидоров</lastname>
 99          <name>Иван</name>
100          <doc_type>C</doc_type>
101          <passport_number>1806326554</passport_number>
102          <passenger_id>2</passenger_id>
103          <gender>M</gender>
104          <date_of_birth>05.04.1984</date_of_birth>
105          <TotalPrice>28752.9</TotalPrice>
106          <FarePrice>2613.9</FarePrice>
107          <Charge>26139</Charge>
108          <TicketNumber />
109          <SeatNumber>034</SeatNumber>
110          <HasSeat>true</HasSeat>
111       </Passenger>
112    </Passengers>
113    <Info>
114       <trainNumber>098ХА</trainNumber>
115       <trainName />
116       <departureStation>МОСКВА КАЗ</departureStation>
117       <arrivalStation>КАЗАНЬ ПАС</arrivalStation>
118       <trainCategory>1</trainCategory>
119       <beginStation>Москва</beginStation>
120       <endStation>Казань</endStation>
121       <startDate>2014-04-26 00:15:00</startDate>
122       <endDate>2014-04-26 13:33:00</endDate>
123       <timeInRoad>47880</timeInRoad>
124       <carNumber>8</carNumber>
125       <carType>4</carType>
126       <choosenSeats>
127          <type>
128             <lower>1</lower>
129          </type>
130          <type>
131             <upper>1</upper>
132          </type>
133          <type>
134             <lower_side>0</lower_side>
135          </type>
136          <type>
137             <upper_side>0</upper_side>
138          </type>
139          <type>
140             <undefined>0</undefined>
141          </type>
142       </choosenSeats>
143       <choosenRange>
144          <start>0</start>
145          <end>0</end>
146       </choosenRange>
147       <serviceClass>В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.</serviceClass>
148    </Info>
149 </PNR>

Элемент PNR Элемент PNR — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.

Элемент	Описание	Допустимые значения
Common	Общая информация по заказу.	Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreate.
Payment	Информация о стоимости, штрафах, статусе заказа.	Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValue.
Client	Информация о заказчике.	Элементы Name, MiddleName, Number, Birth, Email, Phone.
Passengers	Записи о пассажирах.	Элементы Passenger.
Info	Типовая информация по заказу в контексте услуги.	Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass.

Элемент Common

Элемент	Описание	Допустимые значения
id	Номер заказа в Немо.	Число. Пример: 268281.
Type	Тип услуги.	Строка: Пример: FLIGHTS. Допустимые значения: FLIGHTS — авиа, HOTELS — отели, TRAINS — ЖД.
Service	Поставщик услуги.	Строка. Пример: UFS.
Locator	Идентификатор в системе поставщика.	Число. Пример: 65525140.
BeginDateTime	Дата и время отправления первого сегмента.	Дата и время. Пример: 2014.03.06-00:15.
EndDateTime	Дата и время прибытия последнего сегмента.	Дата и время. Пример: 2014.03.06-13:33.
TicketingDateTime	Дата и время выписки билета.	Дата и время. Пример: 2014.10.17-17:23
VoidDateTime	Дата и время возврата билета.	Дата и время. Пример: 2014.10.17-17:23
TotalPrice	Общая стоимость заказа.	Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимости.
UserId	Идентификатор пользователя в системе Немо, оформившего заказ.	Число. Пример: 123.
UserLogin	Логин пользователя в системе Немо, оформившего заказ.	Строка. Пример: userLogin.
GroupId	Идентификатор группы пользователя в системе Немо, оформившего заказ.	Число. Пример: 122.
UserStatus	Тип пользователя в системе Немо.	Строка. Пример: Менеджер.
DateCreate	Дата и время резервирования в системе поставщика.	Дата и время. Пример: 2014.03.05-15:08

Элемент TotalPrice

Элемент	Описание	Допустимые значения
Amount	Номинал.	Число. Пример: 1884.
CurrencyCode	Валюта.	Строка (Код ISO 4217 alfa-3). Пример: RUB.

Элемент Payment

Элемент	Описание	Допустимые значения
Title	Название платежного шлюза*.	Строка. Пример: Testpay.
Method	Тип формы оплаты*.	Строка. Пример: Testpay.
BillingId	Идентификатор транзакции Немо.	Строка. Пример: 117603370.
Date	Дата и время оплаты платежной транзакции Немо.	Строка. Пример: 2014-04-24 15:10:12.
CreateDate	Дата и время создания платежной транзакции Немо.	Строка. Пример: 2014-06-06 15:10:00.
Status	Статус заказа в системе Немо.	Строка. Пример: booked. Допустимые значения: pending — в ожидании, booked — зарезервирован, ticket — выписан, cancelled — отменен.
PenaltyDate	Дата и время наступления штрафных санкций.	Дата и время. Пример: 2014-03-05 15:23:40.
Timelimit	Таймлимит на оплату и подтверждение заказа.	Дата и время. Пример: 2014-03-05 15:23:40.
Charge	Сбор агентства.	См. элемент Common.TotalPrice.
Book	Тариф.	См. элемент Common.TotalPrice.
Penalty	Штраф. Внимание! На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.	См. элемент Common.TotalPrice.
TotalAgencyChargeForRefund	Общий сбор агентства за возврат.	См. элемент Common.TotalPrice.
Total	Общая стоимость.	См. элемент Common.TotalPrice.
PaidValue	Оплачено.	См. элемент Common.TotalPrice.

^* — список возможный платежных шлюзов:
Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney.

Элемент Client

Элемент	Описание	Допустимые значения
Name	Фамилия и имя заказчика.	Строка. Пример: Иванов Иван.
MiddleName	Отчество заказчика.	Строка. Пример: Иванович.
Number	Серия и номер документа.	Строка. Пример: 1806123456.
Birth	Дата рождения заказчика.	Дата. Пример: 1984-06-30.
Email	Адрес электронной почты заказчика.	Строка. Пример: client@host.com.
Phone	Номер телефона заказчика.	Строка. Пример: +74951234567

Элемент Passenger

Элемент	Описание	Допустимые значения
lastname	Фамилия пассажира.	Строка. Пример: Сидоров.
name	Имя пассажира.	Строка. Пример: Владимир.
middlename	Отчество пассажира.	Строка. Пример: Константинович.
doc_type	Тип документа.	Строка. Пример: C. Допустимые значения: C — Российский паспорт P — Заграничный паспорт A — Иностранный документ S — Паспорт моряка M — Военный билет B — Свидетельство о рождении
passport_number	Серия и номер документа.	Строка. Пример: 1806123456.
gender	Пол пассажира.	Строка. Пример: M. Допустимые значения: M — мужской F — женский
date_of_birth	Дата рождения пассажира.	Дата. Пример: 20.05.1987.
nationality	Гражданство пассажира.	Строка (ISO 3166-1 Alpha-2). Пример: RU.
passenger_type	Тип пассажира.	Строка. Пример: ADT. Допустимые значения: ADT — взрослый CLD — ребенок до 10 лет*, ** INF — ребенок до 5 лет*, ***
passenger_id	Порядковый номер пассажира в заказе.	Число. Пример: 2.
TotalPrice	Общая стоимость билета со сборами для данного пассажира.	Число. Пример: 1934.
FarePrice	Стоимость по тарифу тарифу.	Число. Пример: 1884.
Charge	Сбор агентства.	Число. Пример: 50.
RefundMoney	Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.	Число. Пример: 1643.
ChargeForRefund	Cбор агентства за возврат.	Число. Пример: 100.
TicketNumber	Номер билета.	Число. Пример: 73944708472624.
SeatNumber	Номер места.	число. Пример: 21.
TariffType	Наименование тарифа.	Строка. Пример: ПОЛНЫЙ.
HasSeat	Занимает ли пассажир отдельное место.	Допустимые значения: true — с местом, false — без места.

^* — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки.

^** — Нижний и верхний пределы определяются видом сообщения:

• от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
• от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
• от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.

^*** — Верхний предел определяется видом сообщения:

• до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
• до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
• до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.

Элемент Passenger

Элемент	Описание	Допустимые значения
trainNumber	Номер поезда.	Строка. Пример: 098ХА.
trainName	Имя фирменного поезда. Приходит от поставщика.	Строка. Пример: Россия.
departureStation	Станция отправления пассажира.	Строка. Пример: МОСКВА КАЗ.
arrivalStation	Станция прибытия пассажира.	Строка. Пример: КАЗАНЬ ПАС.
trainCategory	Тип поезда.	Число. Пример: 1. Допустимые значения: 0 — неизвестный тип поезда 1 — скорый поезд 2 — фирменный поезд 3 — скоростной поезд 4 — фирменный скоростной поезд
beginStation	Начальная станция в маршруте поезда.	Строка. Пример: Казань
endStation	Конечная станция в маршруте поезда.	Строка. Пример: Москва
startDate	Дата и время отправления со станции отправления пассажира.	Дата и время. Пример: 2014-03-06 00:15:00.
endDate	Дата и время прибытия со станции отправления пассажира.	Дата и время. Пример: 2014-03-06 13:33:00.
timeInRoad	Время в пути от станции отправления до станции прибытия пассажира.	Число (секунд). Пример: 47880.
carNumber	Номер вагона.	Число. Пример: 7.
carType	Тип вагона.	Число. Пример: 1. Допустимые значения: 1 - общий вагон 2 - сидячий вагон 3 - плацкарта 4 - купе 5 - люкс 6 - мягкий 7 - неизвестный тип
choosenSeats	Элемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.	Элементы type.
choosenRange	Выбранный диапазон мест в вагоне.	Элементы start, end.
serviceClass	Описание услуг. Приходит от поставщика.	Текст. Пример: В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.

Элемент type

Элемент	Описание	Допустимые значения
lower	Количество нижних мест.	Число. Пример: 1.
upper	Количество верхних мест.	Число. Пример: 0.
lower_side	Количество нижних боковых мест.	Число. Пример: 1.
upper_side	Количество верхних боковых мест.	Число. Пример: 1.
undefined	Количество мест неопределенного типа.	Число. Пример: 0.

Элемент choosenRange

Элемент	Описание	Допустимые значения
start	Начало выбранного диапазон мест в вагоне*.	Число. Пример: 4.
end	Конец выбранного диапазон мест в вагоне*.	Число. Пример: 17.

^* — Если диапазон не был зада пользователем на этапе выбора мест, то поля start и end будут содержать нули.

Пакетный экспорт заказов в формате Nemo

Сервис выгрузки заказов позволяет экспортировать необходимые выборки по заказам в формате XML, XLS(X). Например, можно выбрать заказы по дате бронирования и получить информацию по ним в нужном формате. Экспорт в формате XLS(X) единовременно выгружает не более 1000 заказов. Если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), то нужно выгружать заказы за последовательные периоды.

При выгрузке данных по заказам в формате XLS(X) ценовые параметры конвертируются в валюту агентства по курсам, зафиксированным на момент оплаты конкретного заказа.

Панель выгрузки всегда доступна для менеджеров и экспертов.

Экспорт заказов под авторизованным пользователем (в личном кабинете)

Фильтры пакетного экспорта заказов в личном кабинете

Псевдоссылка Показать панель экспорта раскрывает форму, позволяющую экспортировать заказы в файл формат XML, XLS или XLSX.

Выгружаются заказы выбранного пользователя/компании и принадлежащих к ним субагентов/пользователей с учетом примененных параметров фильтра.

Запрос на выгрузку данных по заказам отобразится в системе логирования с XML файлом, содержащим данные выгрузки.

Для экспорта отложенных заказов в формате XLS(X) нужно в фильтрах заказов установить параметр «Статус бронирования» в значение «Отложен».

В данный момент установлен лимит на количество выгружаемых единовременно заказов, равный 1000. В случае, если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), это возможно сделать, выгружая заказы за определенные периоды.

Повторная выгрузка заказов

Если выгрузка заказа прошла неуспешно, в системе предусмотрена возможность выгрузить его повторно. Для этого менеджеру агентства необходимо на странице проблемного заказа перейти в раздел «Служебная информация», где расположена ссылка «Выгрузить заказ повторно», после нажатия на которую заказ будет выгружен повторно.

Причем в случае, если в разделе настроек Настройки системы → Интеграция → Выгрузка заказов включена настройка Выгрузка одновременно и Nemo и Софи, повторная выгрузка будет выполнена и в формате Nemo, и в формате СОФИ.

Также, доступна повторная выгрузка заказов через Личный кабинет. Для этого разделе «Заказы», для нужного заказа в колонке «Действия» требуется нажать на ссылку «Выгрузить заказ повторно».

См. также

• Пользователь
• Авторизованный пользователь
• Агентство
• Заказы
• Бронирование
• Аннуляция
• Выписка
• Войдирование
• Список кодов состояния HTTP.