Выгрузка заказов
Выгрузка заказов — это экспорт данных заказа или заказов для различных компонентов системы Nemo.
Содержание
Описание
Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.
Процесс выгрузки
Схематично процесс выгрузки заказов представлен на блок-схеме.
Настройки
На странице настроек выгрузки заказов доступны следующие опции:
- Выгрузка одновременно и Nemo, и Софи — настройка позволяет производить экспорт данных одновременно в двух форматах.
Внимание! Опция доступна только для компонента «Авиабилеты», при включенном модуле «Выгрузка заказов Софи». - Тип выгрузки — настройка определяет один из доступных форматов выгрузки заказов:
- Выгрузка заказов Nemo — внутренний формат системы Nemo, доступен по умолчанию.
- Выгрузка заказов Софи — дополнительный формат, становится доступным при включении модуля «Выгрузка заказов Софи».
- Url стороннего скрипта для XML уведомлений — URL, на который будет производиться выгрузка данных.
- Код сайта в системе Софи — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в Немо. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства.
Внимание! Необходимо заполнить поля "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>AeroExpress</Type>
29 <Price>
30 <Amount>1440</Amount>
31 <CurrencyCode>RUB</CurrencyCode>
32 </Price>
33 </ExtService>
34 <ExtService>
35 <Type>AlphaInsurance</Type>
36 <Price>
37 <Amount>480</Amount>
38 <CurrencyCode>RUB</CurrencyCode>
39 </Price>
40 <Insurances>
41 <Insurance>
42 <Number>Z694.198TEST.2765282</Number>
43 <Fio>IVANOV IVAN</Fio>
44 </Insurance>
45 <Insurance>
46 <Number>Z694.198TEST.2765283</Number>
47 <Fio>PETROV PETR</Fio>
48 </Insurance>
49 </Insurances>
50 </ExtService>
51 </ExtServices>
52 </Common>
53 <Payment>
54 <Title>Testpay</Title>
55 <Method>Testpay</Method>
56 <BillingId>117607091</BillingId>
57 <Date>2014-12-09 15:00:39</Date>
58 <CreateDate>2014-12-09 15:00:34</CreateDate>
59 <Status>ticket</Status>
60 <PenaltyDate/>
61 <Timelimit>2014-12-10 14:59:55</Timelimit>
62 <PaymentCharge> <!-- Сбор платежного шлюза -->
63 <Amount>313.8</Amount>
64 <CurrencyCode>RUB</CurrencyCode>
65 </PaymentCharge>
66 <Charge> <!-- Общий сбор минус сбор платежного шлюза -->
67 <Amount>1920</Amount>
68 <CurrencyCode>RUB</CurrencyCode>
69 </Charge>
70 <BaseFare> <!-- Тариф -->
71 <Amount>1600</Amount>
72 <CurrencyCode>RUB</CurrencyCode>
73 </BaseFare>
74 <Book> <!-- Тариф плюс таксы -->
75 <Amount>8540</Amount>
76 <CurrencyCode>RUB</CurrencyCode>
77 </Book>
78 <Penalty>
79 <Amount>0</Amount>
80 <CurrencyCode>RUB</CurrencyCode>
81 </Penalty>
82 <Total>
83 <Amount>10773.8</Amount>
84 <CurrencyCode>RUB</CurrencyCode>
85 </Total>
86 <Commission>
87 <Amount>0</Amount>
88 <CurrencyCode>RUB</CurrencyCode>
89 </Commission>
90 <PaidValue>
91 <Amount>10773.8</Amount>
92 <CurrencyCode>RUB</CurrencyCode>
93 </PaidValue>
94 </Payment>
95 <Client>
96 <LastName/>
97 <Name>SIDOROV PETR</Name>
98 <MiddleName/>
99 <Number/>
100 <Birth/>
101 <Email>mail@host.com</Email>
102 <Phone>+74950000000</Phone>
103 </Client>
104 <PassengersCount>2</PassengersCount>
105 <Passengers>
106 <Passenger>
107 <passenger_type>ADT</passenger_type>
108 <lastname>IVANOV</lastname>
109 <name>IVAN</name>
110 <gender>F</gender>
111 <date_of_birth>12.12.1987</date_of_birth>
112 <doc_type>C</doc_type>
113 <passport_number>1234567890</passport_number>
114 <currency_of_passport>24.03.2023</currency_of_passport>
115 <middlename/>
116 <passenger_id>37667</passenger_id>
117 <nationality>RU</nationality>
118 <email>mail@host.com</email>
119 <Tickets>
120 <Active>0</Active>
121 <Seg/>
122 <Num>5553984070962</Num>
123 <Date>2014-12-09 16:01:00</Date>
124 </Tickets>
125 <Tickets>
126 <Active>1</Active>
127 <Seg/>
128 <Num>5553984070964</Num>
129 <Date>2014-12-09 16:03:00</Date>
130 </Tickets>
131 <PriceInfo>
132 <BaseFare>
133 <Amount>800</Amount>
134 <CurrencyCode>RUB</CurrencyCode>
135 </BaseFare>
136 <TotalFare>
137 <Amount>4270</Amount>
138 <CurrencyCode>RUB</CurrencyCode>
139 </TotalFare>
140 <Commission>
141 <Amount>0</Amount>
142 <CurrencyCode>RUB</CurrencyCode>
143 </Commission>
144 <AirlineCommission>
145 <Amount>0</Amount>
146 <CurrencyCode>RUB</CurrencyCode>
147 </AirlineCommission>
148 </PriceInfo>
149 </Passenger>
150 <Passenger>
151 <passenger_type>ADT</passenger_type>
152 <doc_type>C</doc_type>
153 <middlename/>
154 <passenger_id>37668</passenger_id>
155 <lastname>PETROV</lastname>
156 <name>PETR</name>
157 <gender>M</gender>
158 <date_of_birth>20.12.1984</date_of_birth>
159 <passport_number>1234567899</passport_number>
160 <currency_of_passport>20.12.2029</currency_of_passport>
161 <nationality>RU</nationality>
162 <email>mail@host.com</email>
163 <Tickets>
164 <Active>0</Active>
165 <Seg/>
166 <Num>5553984070963</Num>
167 <Date>2014-12-09 16:01:00</Date>
168 </Tickets>
169 <Tickets>
170 <Active>1</Active>
171 <Seg/>
172 <Num>5553984070965</Num>
173 <Date>2014-12-09 16:03:00</Date>
174 </Tickets>
175 <PriceInfo>
176 <BaseFare>
177 <Amount>800</Amount>
178 <CurrencyCode>RUB</CurrencyCode>
179 </BaseFare>
180 <TotalFare>
181 <Amount>4270</Amount>
182 <CurrencyCode>RUB</CurrencyCode>
183 </TotalFare>
184 <Commission>
185 <Amount>0</Amount>
186 <CurrencyCode>RUB</CurrencyCode>
187 </Commission>
188 <AirlineCommission>
189 <Amount>0</Amount>
190 <CurrencyCode>RUB</CurrencyCode>
191 </AirlineCommission>
192 </PriceInfo>
193 </Passenger>
194 </Passengers>
195 <FlightType>Внутренний</FlightType>
196 <OrderInfo>
197 <Info>
198 <Company>Аэрофлот - Российские авиалинии</Company>
199 <CompanyCode>SU</CompanyCode>
200 <OperatingCompanyCode>FV</OperatingCompanyCode>
201 <StartDate>2014.12.18</StartDate>
202 <StartTime>10:45</StartTime>
203 <StartDayOfWeek>Thursday</StartDayOfWeek>
204 <FlightNumber>6128 (FV6128)</FlightNumber>
205 <StartAirportCode>VKO</StartAirportCode>
206 <StartAirportName>Внуково, Москва</StartAirportName>
207 <StartCountry>Россия</StartCountry>
208 <StartCountryCode>RU</StartCountryCode>
209 <EndAirportCode>LED</EndAirportCode>
210 <EndAirportName>Санкт-Петербург, Пулково</EndAirportName>
211 <EndCountry>Россия</EndCountry>
212 <EndCountryCode>RU</EndCountryCode>
213 <Time>1:30</Time>
214 <Equip>
215 <Name>Airbus 319</Name>
216 <Type>319</Type>
217 </Equip>
218 <ClassType>economy</ClassType>
219 <ClassTypeCode>R</ClassTypeCode>
220 <Meal/>
221 </Info>
222 <Info>
223 <Company>Аэрофлот - Российские авиалинии</Company>
224 <CompanyCode>SU</CompanyCode>
225 <OperatingCompanyCode>FV</OperatingCompanyCode>
226 <StartDate>2014.12.25</StartDate>
227 <StartTime>15:10</StartTime>
228 <StartDayOfWeek>Thursday</StartDayOfWeek>
229 <FlightNumber>6153 (FV6153)</FlightNumber>
230 <StartAirportCode>LED</StartAirportCode>
231 <StartAirportName>Санкт-Петербург, Пулково</StartAirportName>
232 <StartCountry>Россия</StartCountry>
233 <StartCountryCode>RU</StartCountryCode>
234 <EndAirportCode>VKO</EndAirportCode>
235 <EndAirportName>Внуково, Москва</EndAirportName>
236 <EndCountry>Россия</EndCountry>
237 <EndCountryCode>RU</EndCountryCode>
238 <Time>1:30</Time>
239 <Equip>
240 <Name>Airbus 319</Name>
241 <Type>319</Type>
242 </Equip>
243 <ClassType>economy</ClassType>
244 <ClassTypeCode>R</ClassTypeCode>
245 <Meal/>
246 </Info>
247 </OrderInfo>
248 <Remarks>Debit</Remarks>
249 </PNR>
Ремарка <Remarks>Debit</Remarks> является не обязательной, означает что заказ был оплачен с помощью способа оплаты «Депозит»; если же заказ был оплачен с использованием депозитного кредита, и депозит ушел в минус даже на 1 руб., то будет <Remarks>Credit</Remarks>.
Элемент <TotalFare> возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.
Элемент <CreateDate> в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.
Формат поддерживает возможность передачи нескольких номеров электронных билетов на одного пассажира (в том числе войдированных и аннулированных).
Формат Софи
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" 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 — для Юнителлера
- 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);
Выгрузка заказа для компонента «Отели»
Для компонента «Отели» доступна выгрузка заказов в формате 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. Допустимые значения:
|
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. Допустимые значения:
|
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. |
Адрес электронной почты заказчика. | Строка. Пример: client@host.com. | |
Phone | Номер телефона заказчика. | Строка. Пример: +74951234567 |
Элемент Passenger
Элемент | Описание | Допустимые значения |
---|---|---|
lastname | Фамилия пассажира. | Строка. Пример: Сидоров. |
name | Имя пассажира. | Строка. Пример: Владимир. |
middlename | Отчество пассажира. | Строка. Пример: Константинович. |
doc_type | Тип документа. | Строка. Пример: C. Допустимые значения:
|
passport_number | Серия и номер документа. | Строка. Пример: 1806123456. |
gender | Пол пассажира. | Строка. Пример: M. Допустимые значения:
|
date_of_birth | Дата рождения пассажира. | Дата. Пример: 20.05.1987. |
nationality | Гражданство пассажира. | Строка (ISO 3166-1 Alpha-2). Пример: RU. |
passenger_type | Тип пассажира. | Строка. Пример: ADT. Допустимые значения:
|
passenger_id | Порядковый номер пассажира в заказе. | Число. Пример: 2. |
TotalPrice | Общая стоимость билета со сборами для данного пассажира. | Число. Пример: 1934. |
FarePrice | Стоимость по тарифу тарифу. | Число. Пример: 1884. |
Charge | Сбор агентства. | Число. Пример: 50. |
RefundMoney | Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат. | Число. Пример: 1643. |
ChargeForRefund | Cбор агентства за возврат. | Число. Пример: 100. |
TicketNumber | Номер билета. | Число. Пример: 73944708472624. |
SeatNumber | Номер места. | число. Пример: 21. |
TariffType | Наименование тарифа. | Строка. Пример: ПОЛНЫЙ. |
HasSeat | Занимает ли пассажир отдельное место. | Допустимые значения:
|
* — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки.
** — Нижний и верхний пределы определяются видом сообщения:
- от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
- от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
- от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.
*** — Верхний предел определяется видом сообщения:
- до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
- до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
- до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.
Элемент Passenger
Элемент | Описание | Допустимые значения |
---|---|---|
trainNumber | Номер поезда. | Строка. Пример: 098ХА. |
trainName | Имя фирменного поезда. Приходит от поставщика. | Строка. Пример: Россия. |
departureStation | Станция отправления пассажира. | Строка. Пример: МОСКВА КАЗ. |
arrivalStation | Станция прибытия пассажира. | Строка. Пример: КАЗАНЬ ПАС. |
trainCategory | Тип поезда. | Число. Пример: 1. Допустимые значения:
|
beginStation | Начальная станция в маршруте поезда. | Строка. Пример: Казань |
endStation | Конечная станция в маршруте поезда. | Строка. Пример: Москва |
startDate | Дата и время отправления со станции отправления пассажира. | Дата и время. Пример: 2014-03-06 00:15:00. |
endDate | Дата и время прибытия со станции отправления пассажира. | Дата и время. Пример: 2014-03-06 13:33:00. |
timeInRoad | Время в пути от станции отправления до станции прибытия пассажира. | Число (секунд). Пример: 47880. |
carNumber | Номер вагона. | Число. Пример: 7. |
carType | Тип вагона. | Число. Пример: 1. Допустимые значения:
|
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. Например, можно выбрать все заказы по дате бронирования и получить информацию по ним в XML-виде.
Экспорт заказов под авторизованным пользователем (в личном кабинете)
Порядок пользования сервисом:
- Перейти в личный кабинет
- В адресной строке браузера к текущему адресу дописать параметр &exportxml. Должен получиться адрес вида:
http://DOMAIN/index.php?go=poffice/table&exportxml
- После обновления страницы под блоком фильтров должна появиться кнопка «Экспортировать в XML». При ее нажатии на странице появляется предложение сохранить в XML-файл выборку отфильтрованных заказов.
Выгружаются только заказы выбранного пользователя/компании с учетом примененных параметров фильтра.
Пользователь может произвести выгрузку только своих заказов.
Запрос на выгрузку данных по заказам, будет отображен в системе логирования, с XML файлом содержащим данные выгрузки.