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

Версия 21:09, 30 октября 2014

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

Содержание

1 Описание
- 1.1 Процесс выгрузки
2 Настройки
3 Форматы выгрузки заказов
4 Пакетный экспорт заказов
- 4.1 Экспорт заказов под авторизованным пользователем (в личном кабинете)
- 4.2 Экспорт заказов под неавторизованным пользователем (под «гостем»)
  - 4.2.1 Параметры экспорта заказов
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="810" 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 — сбор за эквайринг

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

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

Формат Софи

 1 <?xml version="1.0" encoding="UTF-8"?>
 2     <header currency="RUB" time_gmt="2014-10-24 12:09:35" time="2014-10-24 16:09:35" ord_id="996424" corp_ord_id="FHHUWQ" site="80691"/>
 3   <customer email="e.pogodina@mute-lab.com" phone="XXXX2212" name="" corp_code="87349"/>
 4   <products>
 5     <product>
 6       <air_ticket_prod prod_id="0" psg_type="A" title="Москва - Екатеринбург" taxes="1280" fare="4600" origin="MOW" service_fee="810" form_owner="NN" validating_carrier="NN" destination="SVX" comission="230">
 7         <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"/>
 8       </air_ticket_prod>
 9     </product>
10     <product>
11       <service_prod prod_id="1" provider_type="AeroExpress" price="360" ext_id="92334"/>
12     </product>
13     <product>
14       <service_prod prod_id="2" provider_type="AlphaInsurance" offer_type="alpha_insurance" ext_id="Z694.198BC.F2754382" price="150" count="1" psgr_id="0"/>
15     </product>
16     <product>
17       <payment_prod price="100.35"/>
18     </product>
19   </products>
20   <reservations>
21     <reservation crs="SABRE" rloc="FHHUWQ"/>
22   </reservations>
23   <passengers>
24     <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"/>
25   </passengers>
26   <travel_docs>
27     <travel_doc>
28       <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"/>
29     </travel_doc>
30   </travel_docs>
31   <payments>
32     <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"/>
33   </payments>
34 </order_snapshot>

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

Для компонента «ЖД» доступна выгрузка заказов в формате 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 будут содержать нули.

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

Сервис выгрузки заказов позволяет экспортировать интересующие выборки по заказам в формате 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]	«Штрафы»	выбранные даты

См. также

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

Версия 21:09, 30 октября 2014

Содержание

Описание

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

Настройки

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

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

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

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

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

Формат Nemo

Формат Софи

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

Формат Софи

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

Формат Nemo

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

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

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

Параметры экспорта заказов

См. также

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты