Выгрузка заказов
Выгрузка заказов — это экспорт данных заказа или заказов для различных компонентов системы Nemo.
Содержание
- 1 Описание
- 2 Настройки
- 3 Форматы выгрузки заказов
- 4 Пакетный экспорт заказов
- 5 См. также
Описание
Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.
Процесс выгрузки
Схематично процесс выгрузки заказов представлен на блок-схеме.
Настройки
На странице настроек выгрузки заказов доступны следующие опции:
- Выгрузка одновременно и 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. |
500 | Любая внутренняя ошибка сервера. |
Выгрузка заказа для компонента «Авиабилеты»
Для компонента «Авиабилеты» доступна выгрузка заказов в форматах Nemo и/или Софи (при включенном модуле «Выгрузка заказов Софи»).
Формат Nemo
1 <?xml version="1.0" encoding="UTF-8"?>
2 <PNR>
3 <Common>
4 <id>263440</id>
5 <Type>FLIGHTS</Type>
6 <Service>SABRE</Service>
7 <Locator>MHKPTF</Locator>
8 <ExternalId>1234567</ExternalId> <!-- Внешний идентификатор --!>
9 <Stamp>123456789</Stamp>
10 <BeginDateTime>2014.04.22-11:55</BeginDateTime>
11 <EndDateTime>2014.04.22-13:25</EndDateTime>
12 <TotalPrice>
13 <Amount>2189</Amount>
14 <CurrencyCode>RUB</CurrencyCode>
15 </TotalPrice>
16 <UserId>123</UserId>
17 <EEUserId />
18 <UserLogin>userLogin</UserLogin>
19 <GroupId>122</GroupId>
20 <UserStatus>Менеджер</UserStatus>
21 <DateCreate>2014.03.21-13:33</DateCreate>
22 <ExtServices> <!-- Дополнительные услуги -->
23 <ExtService>
24 <Type>AeroExpress</Type>
25 <Price>
26 <Amount>720</Amount>
27 <CurrencyCode>RUB</CurrencyCode>
28 </Price>
29 </ExtService>
30 <ExtService>
31 <Type>AlphaInsurance</Type>
32 <Price>
33 <Amount>300</Amount>
34 <CurrencyCode>RUB</CurrencyCode>
35 </Price>
36 <Insurances>
37 <Insurance>
38 <Number>Z694.198BC.F1234567</Number>
39 <Fio>IVANOV IVAN IVANOVICH</Fio>
40 </Insurance>
41 <Insurance>
42 <Number>Z694.198BC.F2345678</Number>
43 <Fio>PETROV PETR PETROVICH</Fio>
44 </Insurance>
45 </Insurances>
46 </ExtService>
47 </ExtServices>
48 </Common>
49 <Payment>
50 <Title>Testpay</Title>
51 <Method>Testpay</Method>
52 <BillingId>117601216</BillingId>
53 <Date>2014-03-21 13:38:26</Date>
54 <CreateDate>2014-03-21 13:38:24</CreateDate>
55 <Status>ticket</Status>
56 <PenaltyDate />
57 <Timelimit>2014-03-28 23:59:00</Timelimit>
58 <PaymentCharge> <!-- Сбор платежного шлюза -->
59 <Amount>0</Amount>
60 <CurrencyCode>RUB</CurrencyCode>
61 </PaymentCharge>
62 <Charge> <!-- Общий сбор минус сбор платежного шлюза -->
63 <Amount>0</Amount>
64 <CurrencyCode>RUB</CurrencyCode>
65 </Charge>
66 <BaseFare> <!-- Тариф -->
67 <Amount>2000</Amount>
68 <CurrencyCode>RUB</CurrencyCode>
69 </BaseFare>
70 <Book> <!-- Тариф плюс таксы -->
71 <Amount>2189</Amount>
72 <CurrencyCode>RUB</CurrencyCode>
73 </Book>
74 <Penalty>
75 <Amount>0</Amount>
76 <CurrencyCode>RUB</CurrencyCode>
77 </Penalty>
78 <Total>
79 <Amount>2189</Amount>
80 <CurrencyCode>RUB</CurrencyCode>
81 </Total>
82 <Commission>
83 <Amount>0</Amount>
84 <CurrencyCode>RUB</CurrencyCode>
85 </Commission>
86 <AirlineCommission>
87 <Amount>200</Amount>
88 <CurrencyCode>RUB</CurrencyCode>
89 </AirlineCommission>
90 <PaidValue>
91 <Amount>2189</Amount>
92 <CurrencyCode>RUB</CurrencyCode>
93 </PaidValue>
94 </Payment>
95 <Client>
96 <LastName>Сидоров</LastName>
97 <Name>Владимир</Name>
98 <MiddleName>Константинович</MiddleName>
99 <Number>1806326598</Number>
100 <Birth>1987-05-20</Birth>
101 <Email>mail@host.com</Email>
102 <Phone>+79871234567</Phone>
103 </Client>
104 <PassengersCount>1</PassengersCount>
105 <Passengers>
106 <Passenger>
107 <nationality>RU</nationality>
108 <passenger_type>ADT</passenger_type>
109 <lastname>IVANOV</lastname>
110 <name>IVAN</name>
111 <gender>M</gender>
112 <date_of_birth>20.05.1987</date_of_birth>
113 <doc_type>C</doc_type>
114 <passport_number>1806326598</passport_number>
115 <currency_of_passport>20.03.2019</currency_of_passport>
116 <middlename />
117 <passenger_id>36801</passenger_id>
118 <email>MAIL@HOST.COM</email>
119 <Tickets>
120 <Seg>1</Seg>
121 <Num>5554659179055</Num>
122 <Date>2014-03-21 13:39:00</Date>
123 </Tickets>
124 <PriceInfo>
125 <BaseFare>
126 <Amount>2000</Amount>
127 <CurrencyCode>RUB</CurrencyCode>
128 </BaseFare>
129 <TotalFare>
130 <Amount>2189</Amount>
131 <CurrencyCode>RUB</CurrencyCode>
132 </TotalFare>
133 <Commission>
134 <Amount>0</Amount>
135 <CurrencyCode>RUB</CurrencyCode>
136 </Commission>
137 <AirlineCommission>
138 <Amount>200</Amount>
139 <CurrencyCode>RUB</CurrencyCode>
140 </AirlineCommission>
141 </PriceInfo>
142 </Passenger>
143 </Passengers>
144 <FlightType>Внутренний</FlightType>
145 <OrderInfo>
146 <Info>
147 <Company>Аэрофлот - Российские авиалинии</Company>
148 <CompanyCode>SU</CompanyCode>
149 <StartDate>2014.04.22</StartDate>
150 <StartTime>11:55</StartTime>
151 <StartDayOfWeek>Tuesday</StartDayOfWeek>
152 <FlightNumber>0014 (SU0014)</FlightNumber>
153 <StartAirportCode>SVO</StartAirportCode>
154 <StartAirportName>Шереметьево, Москва</StartAirportName>
155 <StartCountry>Россия</StartCountry>
156 <StartCountryCode>RU</StartCountryCode>
157 <EndAirportCode>LED</EndAirportCode>
158 <EndAirportName>Санкт-Петербург, Пулково</EndAirportName>
159 <EndCountry>Россия</EndCountry>
160 <EndCountryCode>RU</EndCountryCode>
161 <Time>1:30</Time>
162 <Equip>
163 <Name>Airbus 320</Name>
164 <Type>320</Type>
165 </Equip>
166 <ClassType>economy</ClassType>
167 <ClassTypeCode>N</ClassTypeCode>
168 <Meal>L</Meal>
169 </Info>
170 </OrderInfo>
171 <Remarks>Debit</Remarks>
172 </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="2014-03-21 09:39:47" time="2014-03-21 13:39:47" ord_id="263440" site="332" />
4 <customer email="mail@host.com" phone="XXXX4567" name="Сидоров В. К." corp_code="332" />
5 <products>
6 <product>
7 <!--@stamp - валидатор. Парсится из заказа(Сирена и Галилео). Если получить из ГДС не удалось, то передаётся валидатор, настроенный в реквизитах подключения к ГДС.-->
8 <air_ticket_prod prod_id="0" psg_type="A" title="Москва - Екатеринбург" taxes="1280" fare="4600" origin="MOW" service_fee="300" form_owner="NN" validating_carrier="NN" destination="SVX" comission="0" stamp="92354802">>
9 <air_seg segment_id="0" carrier="NN" flight_number="131" op_carrier="NN" departure_datetime="2014-12-13 21:15:00" arrival_datetime="2014-12-14 01:35:00" departure_airport="DME" arrival_airport="SVX" fare_basis="VIMOW"/>
10 </air_ticket_prod>
11 </product>
12 <product>
13 <service_prod prod_id="1" provider_type="AeroExpress" price="360" ext_id="92334"/>
14 </product>
15 <product>
16 <service_prod prod_id="2" provider_type="AlphaInsurance" offer_type="alpha_insurance" ext_id="Z694.198BC.F2754382" price="150" count="1" psgr_id="0"/>
17 </product>
18 <product>
19 <payment_prod price="100.35"/>
20 </product>
21 </products>
22 <reservations>
23 <reservation crs="SABRE" rloc="FHHUWQ"/>
24 </reservations>
25 <passengers>
26 <passenger doc_number="4512666316" psgr_id="0" doc_country="RU" psgr_type="A" doc_type="C" birth_date="1989-01-01" name="ELENA" gender="F" first_name="POGODINA"/>
27 </passengers>
28 <travel_docs>
29 <travel_doc>
30 <air_ticket_doc tkt_oper="TKT" tkt_number="8235871987637" tkt_date="2014-10-24 16:09:31" prod_id="0" psgr_id="0" issuingAgent="87350"/>
31 </travel_doc>
32 </travel_docs>
33 <payments>
34 <payment pay_id="117726950" pay_oper="PAY" pay_time="2014-10-24 16:09:04" psp_code="024" psp_name="Rapida" psp_pay_id="" pay_system="ES" amount="6790.35" fop="CA"/>
35 </payments>
36 </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 — сбор за эквайринг
Выгрузка доп.услуг для компонента «Авиа»
Для компонента «Авиабилеты» доступна выгрузка доп.услуг (Альфастрахования и Аэроэкспресса) в формате Софи.
Формат Софи
</syntaxhighlight>
Выгрузка заказа для компонента «ЖД»
Для компонента «ЖД» доступна выгрузка заказов в формате 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 будут содержать нули.
Пакетный экспорт заказов
Сервис выгрузки заказов позволяет экспортировать интересующие выборки по заказам в формате XML. Например, можно выбрать все заказы по дате бронирования и получить информацию по ним в XML-виде.
Экспорт заказов под авторизованным пользователем (в личном кабинете)
Порядок пользования сервисом:
- Перейти в личный кабинет
- В адресной строке браузера к текущему адресу дописать параметр &exportxml. Должен получиться адрес вида:
http://DOMAIN/index.php?go=poffice/table&exportxml
- После обновления страницы под блоком фильтров должна появиться кнопка «Экспортировать в XML». При ее нажатии на странице появляется предложение сохранить в XML-файл выборку отфильтрованных заказов.
Пользователь может произвести выгрузку только своих заказов.
Экспорт заказов под неавторизованным пользователем (под «гостем»)
В Nemo существует возможность получить выборку заказов под неавторизованным пользователем («гостем»). Для этого необходимо выполнить запрос вида:
http://DOMAIN/index.php?go=export_xml_key/search&параметры экспорта&xmlKey=ХХХ
где
- host — доменное имя сайта, с которого необходимо сделать экспорт;
- параметры поиска — параметры, по которым следует сделать экспорт;
- xmlKey — ключ, который задается в разделе «Администрирование» → «Настройки системы» → «Ключ безопасности для сервиса выставления оплаты и получения XML выгрузки».
Параметры экспорта заказов
Название | Описание | Возможные значения |
---|---|---|
service | Поставщик | GALILEO, SABRE, SIRENA2000, GTA, MIKI, SERHS, DOTW, HOTELBEDS и т.д. |
type | Компонент | FLIGHTS, HOTELS и т.д. |
set_user | Id пользователя | числовые |
status | статус бронирования | booked - забронирован, cancelled - аннулирован, ticket - выписан, waiting - в работе (только для компонента «Отели»), pending confirmation - ожидает подтверждения (только для «отелей»). Для выборки заказов с любым статусом - этот параметр нужно не указывать. |
payment | Статус оплаты | 1 - не оплачен, 2 - частично оплачен, 3 - оплачен. |
document | Статус загрузки документа | 1 - документ не загружался, 2 - документ загружался |
book_date[from], book_date[to] | «Забронировано» | выбранные даты |
date_begin[from], date_begin[to] | «Начало» | выбранные даты |
update_date[from], update_date[to] | «Изменен» | выбранные даты |
autocancel_date[from], autocancel_date[to] | «Истекает» | выбранные даты |
penalty[from], penalty[to] | «Штрафы» | выбранные даты |