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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(http://helpdesk.nemo.travel/issues/13715)
(→‎Формат Софи)
Строка 377: Строка 377:
 
   </payments>
 
   </payments>
 
</order_snapshot>
 
</order_snapshot>
−
 
−
</syntaxhighlight>
 
−
</div>
 
−
</div>
 
  
 
*service_fee — сбор агентский (сервисный сбор + сбор за эквайринг).
 
*service_fee — сбор агентский (сервисный сбор + сбор за эквайринг).
Строка 396: Строка 392:
 
*approval_code — код подтверждения
 
*approval_code — код подтверждения
 
*payment_prod price — сбор за эквайринг
 
*payment_prod price — сбор за эквайринг
 +
 +
</syntaxhighlight>
 +
</div>
 +
</div>
  
 
=== Выгрузка заказа для компонента «Отели» ===
 
=== Выгрузка заказа для компонента «Отели» ===

Версия 16:54, 6 октября 2014

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

Описание

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

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

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

Export.png

Настройки

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

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

  • Выгрузка одновременно и 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       <Stamp>123456789</Stamp>
  9       <BeginDateTime>2014.04.22-11:55</BeginDateTime>
 10       <EndDateTime>2014.04.22-13:25</EndDateTime>
 11       <TotalPrice>
 12          <Amount>2189</Amount>
 13          <CurrencyCode>RUB</CurrencyCode>
 14       </TotalPrice>
 15       <UserId>123</UserId>
 16       <EEUserId />
 17       <UserLogin>userLogin</UserLogin>
 18       <GroupId>122</GroupId>
 19       <UserStatus>Менеджер</UserStatus>
 20       <DateCreate>2014.03.21-13:33</DateCreate>
 21       <ExtServices>                                    //дополнительные услуги
 22          <ExtService>
 23             <Type>AeroExpress</Type>
 24             <Price>
 25                <Amount>720</Amount>
 26                <CurrencyCode>RUB</CurrencyCode>
 27             </Price>
 28          </ExtService>
 29          <ExtService>
 30             <Type>AlphaInsurance</Type>
 31             <Price>
 32                <Amount>300</Amount>
 33                <CurrencyCode>RUB</CurrencyCode>
 34             </Price>
 35             <Insurances>
 36                <Insurance>
 37                   <Number>Z694.198BC.F1234567</Number>
 38                   <Fio>IVANOV IVAN IVANOVICH</Fio>
 39                </Insurance>
 40                <Insurance>
 41                   <Number>Z694.198BC.F2345678</Number>
 42                   <Fio>PETROV PETR PETROVICH</Fio>
 43                </Insurance>
 44             </Insurances>
 45          </ExtService>
 46       </ExtServices>
 47    </Common>
 48    <Payment>
 49       <Title>Testpay</Title>
 50       <Method>Testpay</Method>
 51       <BillingId>117601216</BillingId>
 52       <Date>2014-03-21 13:38:26</Date>
 53       <CreateDate>2014-03-21 13:38:24</CreateDate>
 54       <Status>ticket</Status>
 55       <PenaltyDate />
 56       <Timelimit>2014-03-28 23:59:00</Timelimit>
 57       <PaymentCharge>                                  //сбор платежного шлюза
 58          <Amount>0</Amount>
 59          <CurrencyCode>RUB</CurrencyCode>
 60       </PaymentCharge>
 61       <Charge>                                         //общий сбор минус сбор платежного шлюза
 62          <Amount>0</Amount>
 63          <CurrencyCode>RUB</CurrencyCode>
 64       </Charge>
 65       <BaseFare>                                       //тариф
 66          <Amount>2000</Amount>
 67          <CurrencyCode>RUB</CurrencyCode>
 68       </BaseFare>
 69       <Book>                                           //тариф плюс таксы
 70          <Amount>2189</Amount>
 71          <CurrencyCode>RUB</CurrencyCode>
 72       </Book>
 73       <Penalty>
 74          <Amount>0</Amount>
 75          <CurrencyCode>RUB</CurrencyCode>
 76       </Penalty>
 77       <Total>
 78          <Amount>2189</Amount>
 79          <CurrencyCode>RUB</CurrencyCode>
 80       </Total>
 81       <Commission>
 82          <Amount>0</Amount>
 83          <CurrencyCode>RUB</CurrencyCode>
 84       </Commission>
 85       <AirlineCommission>
 86          <Amount>200</Amount>
 87          <CurrencyCode>RUB</CurrencyCode>
 88       </AirlineCommission>
 89       <PaidValue>
 90          <Amount>2189</Amount>
 91          <CurrencyCode>RUB</CurrencyCode>
 92       </PaidValue>
 93    </Payment>
 94    <Client>
 95       <LastName>Сидоров</LastName>
 96       <Name>Владимир</Name>
 97       <MiddleName>Константинович</MiddleName>
 98       <Number>1806326598</Number>
 99       <Birth>1987-05-20</Birth>
100       <Email>mail@host.com</Email>
101       <Phone>+79871234567</Phone>
102    </Client>
103    <PassengersCount>1</PassengersCount>
104    <Passengers>
105       <Passenger>
106          <nationality>RU</nationality>
107          <passenger_type>ADT</passenger_type>
108          <lastname>IVANOV</lastname>
109          <name>IVAN</name>
110          <gender>M</gender>
111          <date_of_birth>20.05.1987</date_of_birth>
112          <doc_type>C</doc_type>
113          <passport_number>1806326598</passport_number>
114          <currency_of_passport>20.03.2019</currency_of_passport>
115          <middlename />
116          <passenger_id>36801</passenger_id>
117          <email>MAIL@HOST.COM</email>
118          <Tickets>
119             <Seg>1</Seg>
120             <Num>5554659179055</Num>
121             <Date>2014-03-21 13:39:00</Date>
122          </Tickets>
123          <PriceInfo>
124             <BaseFare>
125                <Amount>2000</Amount>
126                <CurrencyCode>RUB</CurrencyCode>
127             </BaseFare>
128             <TotalFare>
129                <Amount>2189</Amount>
130                <CurrencyCode>RUB</CurrencyCode>
131             </TotalFare>
132             <Commission>
133                <Amount>0</Amount>
134                <CurrencyCode>RUB</CurrencyCode>
135             </Commission>
136             <AirlineCommission>
137                <Amount>200</Amount>
138                <CurrencyCode>RUB</CurrencyCode>
139             </AirlineCommission>
140          </PriceInfo>
141       </Passenger>
142    </Passengers>
143    <FlightType>Внутренний</FlightType>
144    <OrderInfo>
145       <Info>
146          <Company>Аэрофлот - Российские авиалинии</Company>
147          <CompanyCode>SU</CompanyCode>
148          <StartDate>2014.04.22</StartDate>
149          <StartTime>11:55</StartTime>
150          <StartDayOfWeek>Tuesday</StartDayOfWeek>
151          <FlightNumber>0014 (SU0014)</FlightNumber>
152          <StartAirportCode>SVO</StartAirportCode>
153          <StartAirportName>Шереметьево, Москва</StartAirportName>
154          <StartCountry>Россия</StartCountry>
155          <StartCountryCode>RU</StartCountryCode>
156          <EndAirportCode>LED</EndAirportCode>
157          <EndAirportName>Санкт-Петербург, Пулково</EndAirportName>
158          <EndCountry>Россия</EndCountry>
159          <EndCountryCode>RU</EndCountryCode>
160          <Time>1:30</Time>
161          <Equip>
162             <Name>Airbus 320</Name>
163             <Type>320</Type>
164          </Equip>
165          <ClassType>economy</ClassType>
166          <ClassTypeCode>N</ClassTypeCode>
167          <Meal>L</Meal>
168       </Info>
169    </OrderInfo>
170    <Remarks>Debit</Remarks>
171 </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="189" fare="2000" origin="MOW" service_fee="0" form_owner="SU" validating_carrier="SU" destination="LED" comission="0" stamp="92354802">
 9             <air_seg segment_id="0" carrier="SU" flight_number="0014" op_carrier="SU" departure_datetime="2014-04-22 11:55:00" arrival_datetime="2014-04-22 13:25:00" departure_airport="SVO" arrival_airport="LED" fare_basis="NPXOWRF" />
10          </air_ticket_prod>
11       </product>
12       <product>
13          <service_prod prod_id="1" provider_type="AeroExpress" price="720" ext_id="15624" />
14       </product>
15       <product>
16          <service_prod prod_id="2" provider_type="AlphaInsurance" offer_type="alpha_insurance" ext_id="Z694.198BC.F1234567" 
17           price="150" count="1" psgr_id="0" />
18       </product>
19    </products>
20    <reservations>
21       <reservation crs="SABRE" rloc="MHKPTF" />
22    </reservations>
23    <passengers>
24       <passenger doc_number="1806326598" psgr_id="0" doc_country="RU" psgr_type="A" doc_type="C" birth_date="1987-05-20" name="IVAN" gender="M" first_name="IVANOV" />
25    </passengers>
26    <travel_docs>
27       <travel_doc>
28          <!--@issuingAgent - ид пользователя, создавшего заказ.-->
29          <air_ticket_doc tkt_oper="TKT" tkt_number="5554659179055" tkt_date="2014-03-21 13:39:00" prod_id="0" psgr_id="0" issuingAgent="68462"/>
30       </travel_doc>
31    </travel_docs>
32    <payments>
33       <payment pay_id="117601216" pay_oper="PAY" pay_time="2014-03-21 13:38:26" psp_code="011" psp_name="Testpay" psp_pay_id="" amount="2189" fop="CA" />
34    </payments>
35 </order_snapshot>
36 
37 *service_fee — сбор агентский (сервисный сбор + сбор за эквайринг).
38 *ord_id — идентификатор заказа в НЕМО
39 *corp_ord_id — PNR из ГДС
40 *site — идентификатор агентства в Немо
41 *payment pay_id — номер биллинга Немо.
42 *pay_system — код платежной системы
43 **SB — для сбербанка
44 **ES — для Рапиды
45 **UNT — для Юнителлера
46 *cardholder — держатель карты.
47 *expire_date — срок действия карты, у тех ПШ, что не приходит в ответе — пустой.
48 *card_number — номер карты, в формате: 415481XXXXXX1734
49 *approval_code — код подтверждения
50 *payment_prod price — сбор за эквайринг

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

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

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

Элемент Описание Допустимые значения
Common Общая информация по заказу. Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, 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.
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-виде.

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

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

Порядок пользования сервисом:

  1. Перейти в личный кабинет
  2. В адресной строке браузера к текущему адресу дописать параметр &exportxml. Должен получиться адрес вида: 
    http://DOMAIN/index.php?go=poffice/table&exportxml
  3. После обновления страницы под блоком фильтров должна появиться кнопка «Экспортировать в 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_userId пользователячисловые
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]«Штрафы»выбранные даты

См. также

Источник — https://support.nemo.travel/index.php?title=Выгрузка_заказов&oldid=6203