Выгрузка заказов: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Формат Nemo)
(Процесс выгрузки)
Строка 9: Строка 9:
  
 
[[Файл:Export.png]]
 
[[Файл:Export.png]]
 +
 +
{{Attention|
 +
*Выгрузка заказа в формате СОФИ при синхронизации произойдет только если в заказе произошли изменения.
 +
*Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.}}
  
 
== Настройки ==  
 
== Настройки ==  

Версия 16:23, 3 февраля 2017

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

Описание

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

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

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

Export.png

Внимание!

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

Настройки

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

На странице настроек выгрузки заказов доступны следующие опции:

  • Выгрузка одновременно и 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 - код Валидатора в ПСС, берется из настроек Немо, если в настройках он не указан, то не передается.
  • 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. В случае, если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), это возможно сделать, выгружая заказы за определенные периоды.

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

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



См. также