Изменения

Перейти к навигации Перейти к поиску

Выгрузка заказов

1353 байта добавлено, 15:21, 2 октября 2021
Выгрузка заказа для компонента «Авиабилеты»
{{Attention|
*Выгрузка заказа в формате СОФИ при синхронизации произойдет , только если в заказе произошли изменения.
*Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.}}
** '''''<!--Выгрузка заказов--> Nemo''''' — внутренний формат системы {{NameSystem}}, доступен по умолчанию.
** '''''<!--Выгрузка заказов--> Софи''''' — дополнительный формат, становится доступным при включении модуля '''«Выгрузка заказов Софи»'''.
** '''''Nemo Backoffice''''' - возможность экспорта заказов в формате JSON, который предоставляет более полный и актуальный объем данных, использует международные стандарты формата данных, является усовершенствованной версией протокола экспорта данных в формате Nemo.
<!--* '''Url скрипта для выгрузки в выбранном формате''' — URL, на который будет производиться выгрузка данных. -->
* '''Адрес для отправки нотификаций об изменении заказа''' — если задан, то при получении изменений в ходе актуализации отправляется GET-запрос на данный адрес ('''Пример''' ''http://127.0.0.1/?booking_id=ORDER_ID&nemo_id=NEMO_CONNECT_ORDER_ID&locator=LOCATOR''). Формат значения поддерживает переменные '''LOCATOR''', '''ORDER_ID''', '''NEMO_CONNECT_ORDER_ID''' - ('''LOCATOR''' - идентификатор услуги в системе поставщика услуг, '''ORDER_ID''' - идентификатор заказа в системе NEMO, '''NEMO_CONNECT_ORDER_ID''' - идентификатор заказа в системе NEMO Connect).
* '''Url скрипта для выгрузки в формате Nemo''' — URL, на который будет производиться выгрузка данных.
* '''Url скрипта для выгрузки в формате СОФИ''' — URL, на который будет производиться выгрузка данных.
Cистема {{NameSystem}} отправляет файлы выгрузки на указанный в этом поле http-адрес через POST-запрос (см. https://ru.wikipedia.org/wiki/POST_(HTTP) ). Скрипт для обработки получаемых данных должен быть написан на стороне самого клиента. Задача скрипта - принять данные и корректно их обработать. Все данные, которые можно получить через браузер, также можно получить и альтернативными программными средствами (автоматизируя процесс выгрузки). Рекомендуется к использованию библиотека CURL (см. https://ru.wikipedia.org/wiki/CURL) Готовые примеры скриптов сотрудники {{NameSystem}} не предоставляют.<br>Если у субагента указан свой Url скрипта для выгрузки, отличный от URL корневого агенства, то выгрузка по заказам этого субагента будет идти на оба адреса. Главный агент получает информацию по всем заказам всех субагентов, субагент получает выгрузку только своих заказов.<br/> <!-- <span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Указание отдельного URL скрипта для выгрузки для субагентов доступно только для формата Nemo.</span> -->
* '''Адрес для выгрузки в Nemo Backoffice''' — URL, на который будет производиться выгрузка данных.
* '''Ключ безопасности для выгрузки в Nemo Backoffice''' — значение, которое задается самостоятельно агентством на стороне принимающего запрос сервера.
* '''Код сайта в системе Софи''' — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в {{NameSystem}}. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства. <!-- <br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Необходимо заполнить поля '''"Url стороннего скрипта для XML уведомлений"''' и '''"Код сайта в системе Софи"''', которые становятся доступными только при переключении '''"Типа выгрузки"''' в значение '''"Выгрузка заказов Софи"''', а также поле '''"Url стороннего скрипта для XML уведомлений"''' для типа выгрузки '''"Nemo"'''.</span>-->
* '''Повторная отправка в случае неудачи''' — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
* '''Список адресов для уведомлений (разделяется запятыми)''' — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
* '''Экспортировать после оплаты''' — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа.<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Доступно только (поддерживается для формата выгрузки в формате Nemoи Backoffice).</span>
* '''Экспортировать код доступа к заказу''' — настройка включает отображение кода доступа в выгрузке.
* '''Отправлять нотификацию о необходимости установки кода валидатора в реквизитах''' — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
* '''E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах'''
* '''Временная зона для дат''' - настройка позволяет менять временную зону в выгрузке Софи. [[Файл:Временная зона для дат.jpg|500px|thumb|right|Настройка "Временная зона для дат"]]
** '''Использовать временную зону системных настроек''', через которую будет использоваться часовой пояс указанный в "Настройках системы".
** '''Использовать временную зону реквизитов''' - часовой пояс подтягивается индивидуально от каждого пакета реквизитов подключения к ГДС.** '''Выбрать другую временную зону''' дает возможность выбирать временную зону, независимо от других настроек.
== Форматы выгрузки заказов ==
Система поддерживает выгрузку заказов в форматах '''''Nemo''''', '''''Софи''''' и '''''СофиJSON'''''. Рекомендуется использовать функционал выгрузки JSON.
=== Компоненты, поддерживающие выгрузку заказов ===
! style="font-weight: bold;" | Формат Nemo
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66FF6666;" | +
! style="background-color: #99FF66;" | +
|-
! style="font-weight: bold;" | Формат JSON
! style="background-color: #99FF66;" | +
! style="background-color: #FF666699FF66;" | +! style="background-color: #FF666699FF66;" | +
|}
! scope="col" style="width: 100px;" | Аннуляция<sup>***</sup>
! scope="col" style="width: 100px;" | Обмен/Возврат<sup>****</sup>
! scope="col" style="width: 100px;" | Импорт PNR<sup>*****</sup>
|-
! style="font-weight: bold;" | Формат Nemo
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #FF6666;" | −
|-
! style="font-weight: bold;" | Формат JSON
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! scope="col" style="width: 100px;" | Аннуляция
|-
! style="font-weight: bold;" | Формат NemoJSON
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
|-
! style="font-weight: bold;" | Формат Nemo
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
|-
! style="font-weight: bold;" | Формат JSON
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
|}
&#42;&#160; Выгрузка заказа в формате Nemo при оплате произойдет , только если включена настройка '''''«Экспортировать после оплаты»''''' в разделе '''«Заказы»''' → '''«Выгрузка заказов»'''.<br/>
&#42;&#42; Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.<br/>
&#42;&#42;&#42;&#160; Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.<br/>
&#42;&#42;&#42;&#42;&#160; Выгрузка заказа при обмене или возврате произойдет при завершении работы с заявкой (при пропуске импорта PNR).<br/>&#42;&#42;&#42;&#42;&#42;&#160; Выгрузка заказа при импорте PNR в рамках работы модуля [[Импорт PNR]].
=== Статусы выгрузки заказа ===
<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.</span>
Ремарка ''<Remarks>Debit</Remarks>'' является не обязательной, означает что заказ был оплачен с помощью способа оплаты «Депозит»«Баланс компании»;если же заказ был оплачен с использованием депозитного кредита, и депозит баланс ушел в минус даже на 1 руб., то будет ''<Remarks>Credit</Remarks>''.
Элемент ''<TotalFare>'' возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.
Формат поддерживает возможность передачи нескольких номеров электронных билетов на одного пассажира (в том числе войдированных и аннулированных).
 
Если требуется выгружать EMD на услуги а/к, необходимо использовать в работе Формат JSON.
</div>
</div>
*no_conj_tickets – число дополнительных билетов (отображается при количестве сегментов более 4 включительно);
*surface_seg - передача наземного участка (в том случае, если аэропорт прилета одного сегмента не совпадает с аэропортом вылета следующего);
*supplier - номер PCC (подтягивается в том случае, если указан в реквизитах подключения);*time_gmt - время GMT;*time - дата и время отправки информации в Софи (МСК);*corp_code - код корпоративного клиента;*email - адрес электронной почты клиента;*phone - номер телефона клиента;*psg_type - категория пассажира в виде буквы: A - adult, C - child, I - infant;*title - краткое описание маршрута;*form_owner - владелец бланка IATA код АК;*validating_carrier - валидирующий перевозчик;*prod_id - идентификатор продукта;*taxes - таксы;*fare - стоимость тарифа;*origin/destination - пункт отправления/назначения;*segment_id - идентификатор сегмента в air_ticket_prod, соответствующего услуге;*carrier - маркетинговый перевозчик;*flight_number - номер рейса;*op_carrier - оперирующий перевозчик;*departure_datetime — дата, время вылета;*arrival_datetime — дата, время прибытия;*departure_airport — аэропорт вылета;*arrival_airport — аэропорт прибытия;*fare_basis - код тарифа;*amount - стоимость таксы;*code - код таксы;*departure_datetime — дата, время отправления;*cartype - тип вагона;*crs - код системы бронирования (поставщика);*doc_number — номер документа;*psgr_id — номер пассажира;*doc_country - гражданство;*psgr_type - категория пассажира;*doc_type -тип документа, удостоверяющего личность;*birth_date — дата рождения пассажира;*name — имя пассажира;*gender — пол пассажира;*first_name — фамилия пасажира;*issuingAgent - идентификатор пользователя, выписавшего билет;*pay_time — дата, время оплаты*psp_code - код платежной системы, через которую сделана оплата;*psp_pay_id - идентификатор платежа в платежной системе;*amount - сумма оплаты;*fop - форма оплаты.
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 
==== Формат JSON ====
<div class="mw-collapsible-content">
=== Выгрузка заказа для компонента «Отели» ===
Для компонента '''«Отели»''' доступна выгрузка заказов в формате форматах Nemoи/или JSON.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Формат Nemo JSON ====
<div class="mw-collapsible-content">
см. https://docs.nemo.travel/ru/hotels/hotelsbackoffice</div></div> === Выгрузка заказа для компонента «ЖД» ===Для компонента '''«ЖД»''' доступна выгрузка заказов в форматах Nemo и/или JSON. <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Формат Nemo ====<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><?xml version="1.0" encoding="UTF-8"?>
<PNR>
<Common>
<id>263462123456</id> <Type>HOTELSTRAINS</Type> <Service>ACADEMUFS</Service> <Locator>302865564345987</Locator> <BeginDateTime>2014.04.1526-00:0015</BeginDateTime> <EndDateTime>2014.04.1626-0013:0033</EndDateTime> <TicketingDateTime>2014.06.06-15:10</TicketingDateTime> <VoidDateTime>2014.06.07-14:19</VoidDateTime>
<TotalPrice>
<Amount>195057505.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</TotalPrice>
<UserId>123</UserId>
<EEUserId />
<UserLogin>userLoginmikhalevtur</UserLogin> <GroupId>332122</GroupId>
<UserStatus>Менеджер</UserStatus>
<DateCreate>2014.0304.2124-1615:1103</DateCreate>
</Common>
<Payment>
<StatusTitle>Testpay</Title> <Method>Testpay</Method> <BillingId>booked117603370</StatusBillingId> <PenaltyDateDate>2014.-04.13-0024 15:10:12</Date> <CreateDate>2014-06-06 15:10:00</CreateDate> <Status>cancelled</Status> <PenaltyDate/> <Timelimit>2014-04-13 0024 15:0018:0001</Timelimit>
<Charge>
<Amount>052278</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Charge>
<Book>
<Amount>19505227.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Book>
<CurrencyCode>RUB</CurrencyCode>
</Penalty>
<TotalAgencyChargeForRefund>
<Amount>100</Amount>
<CurrencyCode>RUB</CurrencyCode>
</TotalAgencyChargeForRefund>
<Total>
<Amount>195057505.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Total>
<Commission>
<Amount>112</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Commission>
<PaidValue>
<Amount>0</Amount>
<Passengers>
<Passenger>
<name>Владимир</name>
<middlename>Константинович</middlename>
<phone>
<country />
<city />
<number>+79271031610</number>
<expansion />
</phone>
<email>mlsdsar@gmail.com</email>
<nationality>RU</nationality>
<lastnamepassenger_type>IVANOVADT</lastnamepassenger_type> <namelastname>IVANСидоров</namelastname> </Passengerdoc_type> C</Passengersdoc_type> <Infopassport_number>1806326598</passport_number> <Namepassenger_id>Интурист1</Name> <Citypassenger_id> <Codegender>34M</Codegender> <Namedate_of_birth>Великий Новгород20.04.1984</Namedate_of_birth> </CityTotalPrice> 28752.9<Location /TotalPrice> <StarRatingFarePrice>32613.9</StarRatingFarePrice> <DaysCharge>226139</DaysCharge> <NightsRefundMoney>18649.3</NightsRefundMoney> <CheckInDateChargeForRefund>2014.04.15100</CheckInDateChargeForRefund> <CheckOutDateTicketNumber>2014.04.1674944708487545</CheckOutDateTicketNumber> <CheckInTimeSeatNumber>14:00033</CheckInTimeSeatNumber> <CheckOutTimeHasSeat>12:00true</CheckOutTimeHasSeat> <OnRequest>false</OnRequestPassenger> </InfoPassenger> <Roomsnationality> RU<Room/nationality> <Namemiddlename>Двухместный стандарт (две кровати)Константинович</Namemiddlename> <Typepassenger_type>SNGLADT</Typepassenger_type> <FareIdlastname>1Сидоров</FareIdlastname> <name>Иван</Roomname> <doc_type>C</Roomsdoc_type> <Farespassport_number> 1806326554<Fare/passport_number> <Idpassenger_id>12</Idpassenger_id> <Pricegender> M<Amount>1950</Amount/gender> <CurrencyCodedate_of_birth>RUB05.04.1984</CurrencyCodedate_of_birth> <TotalPrice>28752.9</PriceTotalPrice> <MealsFarePrice>Завтрак "Шведский стол",Отсутствует2613.9</MealsFarePrice> <DescriptionCharge>Одноместный26139</DescriptionCharge> <TicketNumber /Fare> <SeatNumber>034</FaresSeatNumber> <HasSeat>true<CancelCharges/HasSeat> <Charge/Passenger> <DateFrom/Passengers>2014.04.13-00:00 </DateFromInfo> <DateTotrainNumber>2014.04.15-00:00<098ХА</DateTotrainNumber> <Amount>1488 <trainName /Amount> <CurrencyCodedepartureStation>RUBМОСКВА КАЗ</CurrencyCodedepartureStation> </ChargearrivalStation> КАЗАНЬ ПАС</CancelChargesarrivalStation> <ModifyCharges /trainCategory> 1<ModificationMethods/trainCategory> <MethodbeginStation>MOD_PASS_NAMESМосква</MethodbeginStation> <MethodendStation>MOD_DATESКазань</MethodendStation> </ModificationMethodsstartDate>2014-04-26 00:15:00</PNRstartDate> </syntaxhighlight></divendDate>2014-04-26 13:33:00</endDate> <timeInRoad>47880</divtimeInRoad> <carNumber>8</carNumber>=== Выгрузка заказа для компонента «ЖД» ===Для компонента '''«ЖД»''' доступна выгрузка заказов в формате Nemo. <carType>4</carType> <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px"choosenSeats> <type>==== Формат Nemo ==== <div class="mw-collapsible-content"lower>1</lower> </type> <syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"type> <?xml version="upper>1.0" encoding="UTF-8"?></upper> <PNR/type> <Commontype> <idlower_side>1234560</idlower_side> <Type/type>TRAINS</Type <type> <Serviceupper_side>UFS0</Serviceupper_side> <Locator>64345987 </Locatortype> <BeginDateTimetype>2014.04.26-00:15 <undefined>0</undefined> </BeginDateTimetype> <EndDateTime/choosenSeats>2014.04.26-13:33 <choosenRange> <start>0</EndDateTimestart> <TicketingDateTimeend>2014.06.06-15:100</TicketingDateTimeend> <VoidDateTime>2014.06.07-14:19</VoidDateTimechoosenRange> <TotalPriceserviceClass> <Amount>57505В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.8</AmountserviceClass> <CurrencyCode/Info>RUB</CurrencyCodePNR> </TotalPricesyntaxhighlight> <UserId>123</UserId> <EEUserId />'''Элемент PNR''' <UserLogin>mikhalevtur</UserLogin>Элемент '''PNR''' — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия. <GroupId>122</GroupId>{| style="width: 800px" class="wikitable" <UserStatus>Менеджер</UserStatus>|- <DateCreate>2014.04.24-15:03</DateCreate>! scope="col" width="200" | Элемент </! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Common> <Payment>| Общая информация по заказу. <Title>Testpay</Title> <Method>Testpay</Method> <BillingId>117603370</BillingId>| Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreate. <Date>2014|-04-24 15:10:12</Date> <CreateDate>2014-06-06 15:10:00</CreateDate>| Payment| Информация о стоимости, штрафах, статусе заказа.| Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValue.|- <Status>cancelled</Status>| Client <PenaltyDate />| Информация о заказчике. <Timelimit>2014-04| Элементы Name, MiddleName, Number, Birth, Email, Phone.|-24 15:18:01</Timelimit> <Charge>| Passengers <Amount>52278</Amount>| Записи о пассажирах. <CurrencyCode>RUB</CurrencyCode>| Элементы Passenger. </Charge>|- <Book>| Info <Amount>5227| Типовая информация по заказу в контексте услуги.8</Amount> <CurrencyCode>RUB</CurrencyCode> </Book>| Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass.|}  <Penalty>'''Элемент Common''' <Amount>0</Amount>{| style="width: 800px" class="wikitable" <CurrencyCode>RUB</CurrencyCode>|- </Penalty>! scope="col" width="200" | Элемент <TotalAgencyChargeForRefund>! scope="col" width="300" | Описание <Amount>100</Amount>! scope="col" width="300" | Допустимые значения <CurrencyCode>RUB</CurrencyCode>|- </TotalAgencyChargeForRefund>| id <Total>| Номер заказа в {{NameSystem}}. <Amount>57505| Число. Пример: 268281.|-| Type| Тип услуги.| Строка: Пример: FLIGHTS.8<br/Amount> Допустимые значения: <CurrencyCodeul>RUB</CurrencyCodeli> FLIGHTS — авиа,</Totalli> <PaidValueli> <Amount>0HOTELS — отели,</Amountli> <CurrencyCodeli>RUBTRAINS — ЖД.</CurrencyCodeli> </PaidValueul> </Payment>|- <Client>| Service <LastName>Сидоров</LastName>| Поставщик услуги.| Строка. Пример: UFS. <Name>Владимир</Name>|- <MiddleName>Константинович</MiddleName>| Locator| Идентификатор в системе поставщика. <Number>1806326598</Number>| Число. Пример: 65525140. <Birth>1987|-05-20</Birth> <Email>mail@host| BeginDateTime| Дата и время отправления первого сегмента.com</Email> <Phone>+79871234567</Phone>| Дата и время. Пример: 2014.03.06-00:15. </Client>|- <Passengers>| EndDateTime <Passenger>| Дата и время прибытия последнего сегмента. <name>Владимир</name>| Дата и время. Пример: 2014.03.06-13:33.|- <middlename>Константинович</middlename>| TicketingDateTime| Дата и время выписки билета. <phone>| Дата и время. Пример: 2014.10.17-17:23 <country />|- <city />| VoidDateTime <number>+79271031610</number>| Дата и время возврата билета. <expansion />| Дата и время. Пример: 2014.10.17-17:23 </phone>|-| TotalPrice <email>mlsdsar@gmail| Общая стоимость заказа.com</email> <nationality>RU</nationality>| Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимости. <passenger_type>ADT</passenger_type>|-| UserId <lastname>Сидоров</lastname>| Идентификатор пользователя в системе {{NameSystem}}, оформившего заказ. <doc_type>C</doc_type>| Число. Пример: 123.|- <passport_number>1806326598</passport_number>| UserLogin <passenger_id>1</passenger_id> <gender>M</gender>| Логин пользователя в системе {{NameSystem}}, оформившего заказ. <date_of_birth>20| Строка.04Пример: userLogin.1984</date_of_birth> <TotalPrice>28752|-| GroupId| Идентификатор группы пользователя в системе {{NameSystem}}, оформившего заказ.9</TotalPrice> <FarePrice>2613| Число.9</FarePrice>Пример: 122.|- <Charge>26139</Charge>| UserStatus <RefundMoney>8649| Тип пользователя в системе {{NameSystem}}.3</RefundMoney> <ChargeForRefund>100</ChargeForRefund>| Строка. Пример: Менеджер.|-| DateCreate <TicketNumber>74944708487545</TicketNumber>| Дата и время резервирования в системе поставщика. <SeatNumber>033</SeatNumber> <HasSeat>true</HasSeat> </Passenger> <Passenger> <nationality>RU</nationality> <middlename>Константинович</middlename> <passenger_type>ADT</passenger_type> <lastname>Сидоров</lastname> <name>Иван</name> <doc_type>C</doc_type> <passport_number>1806326554</passport_number> <passenger_id>2</passenger_id> <gender>M</gender> <date_of_birth>05.04.1984</date_of_birth> <TotalPrice>28752.9</TotalPrice> <FarePrice>2613.9</FarePrice> <Charge>26139</Charge> <TicketNumber /> <SeatNumber>034</SeatNumber> <HasSeat>true</HasSeat> </Passenger> </Passengers> <Info> <trainNumber>098ХА</trainNumber> <trainName /> <departureStation>МОСКВА КАЗ</departureStation> <arrivalStation>КАЗАНЬ ПАС</arrivalStation> <trainCategory>1</trainCategory> <beginStation>Москва</beginStation> <endStation>Казань</endStation> <startDate>2014-04-26 00:15:00</startDate> <endDate>2014-04-26 13:33:00</endDate> <timeInRoad>47880</timeInRoad> <carNumber>8</carNumber> <carType>4</carType> <choosenSeats> <type> <lower>1</lower> </type> <type> <upper>1</upper> </type> <type> <lower_side>0</lower_side> </type> <type> <upper_side>0</upper_side> </type> <type> <undefined>0</undefined> </type> </choosenSeats> <choosenRange> <start>0</start> <end>0</end> </choosenRange> <serviceClass>В стоимость входит | Дата и время. Пример: 2014.03.05- постельное белье. Наличие установки кондиционирования воздуха не гарантировано.</serviceClass> </Info>15:08</PNR></syntaxhighlight>|}
'''Элемент PNRTotalPrice'''Элемент '''PNR''' — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CommonAmount| Общая информация по заказуНоминал.| Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreateЧисло. Пример: 1884.
|-
| PaymentCurrencyCode| Информация о стоимости, штрафах, статусе заказа.| Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValueВалюта.|Строка (Код ISO 4217 alfa-| Client| Информация о заказчике.| Элементы Name, MiddleName, Number, Birth, Email, Phone3).|-| Passengers| Записи о пассажирах.| Элементы Passenger.|-| Info| Типовая информация по заказу в контексте услуги.| Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClassПример: RUB.
|}
'''Элемент CommonPayment'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| idTitle| Номер заказа в {{NameSystem}}Название платежного шлюза<sup>*</sup>.| ЧислоСтрока. Пример: 268281Testpay.
|-
| TypeMethod| Тип услугиформы оплаты<sup>*</sup>.| Строка: . Пример: FLIGHTS.<br/>Допустимые значения: <ul><li>FLIGHTS — авиа,</li><li>HOTELS — отели,</li><li>TRAINS — ЖДTestpay.</li></ul>
|-
| ServiceBillingId| Поставщик услугиИдентификатор транзакции {{NameSystem}}.| Строка. Пример: UFS117603370.
|-
| LocatorDate| Идентификатор в системе поставщикаДата и время оплаты платежной транзакции {{NameSystem}}.| ЧислоСтрока. Пример: 655251402014-04-24 15:10:12.
|-
| BeginDateTimeCreateDate| Дата и время отправления первого сегментасоздания платежной транзакции {{NameSystem}}.| Дата и времяСтрока. Пример: 2014.03.-06-06 15:10:00:15.
|-
| EndDateTimeStatus| Дата и время прибытия последнего сегментаСтатус заказа в системе {{NameSystem}}.| Дата и времяСтрока. Пример: 2014booked.03.06-13<br/>Допустимые значения:33.|-<ul><li>pending — в ожидании,</li><li>booked — зарезервирован,</li>| TicketingDateTime<li>ticket — выписан,</li>| Дата и время выписки билета<li>cancelled — отменен.</li>| Дата и время. Пример: 2014.10.17-17:23</ul>
|-
| VoidDateTimePenaltyDate| Дата и время возврата билетанаступления штрафных санкций.| Дата и время. Пример: 2014.10.17-1703-05 15:23:40.
|-
| TotalPriceTimelimit| Общая стоимость Таймлимит на оплату и подтверждение заказа.| Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимостиДата и время. Пример: 2014-03-05 15:23:40.
|-
| UserIdCharge| Идентификатор пользователя в системе {{NameSystem}}, оформившего заказСбор агентства.| ЧислоСм. Пример: 123элемент Common.TotalPrice.
|-
| UserLoginBook| Логин пользователя в системе {{NameSystem}}, оформившего заказТариф.| СтрокаСм. Примерэлемент Common.TotalPrice.|-| Penalty| Штраф. <br/><span style="background-color:#fff0f5;">'''<span style="color: userLogin#ff0000;">Внимание!</span>''' На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.</span>| См. элемент Common.TotalPrice.
|-
| GroupIdTotalAgencyChargeForRefund| Идентификатор группы пользователя в системе {{NameSystem}}, оформившего заказОбщий сбор агентства за возврат.| ЧислоСм. Пример: 122элемент Common.TotalPrice.
|-
| UserStatusTotal| Тип пользователя в системе {{NameSystem}}Общая стоимость.| СтрокаСм. Пример: Менеджерэлемент Common.TotalPrice.
|-
| DateCreatePaidValue| Дата и время резервирования в системе поставщикаОплачено.| Дата и времяСм. Пример: 2014элемент Common.03TotalPrice.05-15:08
|}
<sup>*</sup> — список возможный платежных шлюзов:<br/>Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney. '''Элемент TotalPriceClient'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| AmountName| НоминалФамилия и имя заказчика.| ЧислоСтрока. Пример: 1884Иванов Иван.
|-
| CurrencyCodeMiddleName| ВалютаОтчество заказчика.| Строка (Код ISO 4217 alfa-3). Пример: RUBИванович.|} '''Элемент Payment'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | ЭлементNumber! scope="col" width="300" | ОписаниеСерия и номер документа.! scope="col" width="300" | Допустимые значенияСтрока. Пример: 1806123456.
|-
| TitleBirth| Название платежного шлюза<sup>*</sup>Дата рождения заказчика.| СтрокаДата. Пример: Testpay1984-06-30.
|-
| MethodEmail| Тип формы оплаты<sup>*</sup>Адрес электронной почты заказчика.| Строка. Пример: Testpayclient@host.com.
|-
| BillingIdPhone| Идентификатор транзакции {{NameSystem}}Номер телефона заказчика.| Строка. Пример: 117603370.+74951234567|} '''Элемент Passenger'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | DateЭлемент! scope="col" width="300" | Дата и время оплаты платежной транзакции {{NameSystem}}.Описание! scope="col" width="300" | Строка. Пример: 2014-04-24 15:10:12.Допустимые значения
|-
| CreateDatelastname| Дата и время создания платежной транзакции {{NameSystem}}Фамилия пассажира.| Строка. Пример: 2014Сидоров.|-06| name| Имя пассажира.| Строка. Пример: Владимир.|-06 15:10| middlename| Отчество пассажира.| Строка. Пример:00Константинович.
|-
| Statusdoc_type| Статус заказа в системе {{NameSystem}}Тип документа.| Строка. Пример: bookedC.<br/>Допустимые значения:
<ul>
<li>pending C в ожидании,Российский паспорт</li><li>booked P зарезервирован,Заграничный паспорт</li><li>ticket A выписан,Иностранный документ</li><li>cancelled S отменен.Паспорт моряка</li><li>M — Военный билет</li><li>B — Свидетельство о рождении</li>
</ul>
|-
| PenaltyDatepassport_number| Дата Серия и время наступления штрафных санкцийномер документа.| Дата и времяСтрока. Пример: 2014-03-05 15:23:401806123456.
|-
| Timelimitgender| Таймлимит на оплату и подтверждение заказаПол пассажира.| Дата и времяСтрока. Пример: 2014-03-05 15M.<br/>Допустимые значения:23:40.<ul><li>M — мужской</li><li>F — женский</li></ul>
|-
| Chargedate_of_birth| Сбор агентстваДата рождения пассажира.| СмДата. элемент CommonПример: 20.TotalPrice05.1987.
|-
| Booknationality| ТарифГражданство пассажира.| СмСтрока (ISO 3166-1 Alpha-2). элемент Common.TotalPriceПример: RU.
|-
| Penaltypassenger_type| ШтрафТип пассажира. | Строка. Пример: ADT.<br/>Допустимые значения:<ul><li>ADT — взрослый</li><li>CLD — ребенок до 10 лет<sup>*, **</sup><span style="background-color:#fff0f5;"/li><li>'''INF — ребенок до 5 лет<span style="color:#ff0000;"sup>Внимание!*, ***</spansup>''' На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.</spanli>| См. элемент Common.TotalPrice.</ul>
|-
| TotalAgencyChargeForRefundpassenger_id| Общий сбор агентства за возвратПорядковый номер пассажира в заказе.| СмЧисло. элемент Common.TotalPriceПример: 2.
|-
| TotalTotalPrice| Общая стоимостьбилета со сборами для данного пассажира.| СмЧисло. элемент Common.TotalPriceПример: 1934.
|-
| PaidValueFarePrice| ОплаченоСтоимость по тарифу тарифу.| СмЧисло. элемент Common.TotalPrice.|} <sup>*</sup> — список возможный платежных шлюзовПример:<br/>Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney1884'''Элемент Client'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | ЭлементCharge! scope="col" width="300" | ОписаниеСбор агентства.! scope="col" width="300" | Допустимые значенияЧисло. Пример: 50.
|-
| NameRefundMoney| Фамилия и имя заказчикаСумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.| СтрокаЧисло. Пример: Иванов Иван1643.
|-
| MiddleNameChargeForRefund| Отчество заказчикаCбор агентства за возврат.| СтрокаЧисло. Пример: Иванович100.
|-
| NumberTicketNumber| Серия и номер документаНомер билета.| СтрокаЧисло. Пример: 180612345673944708472624.
|-
| BirthSeatNumber| Дата рождения заказчикаНомер места.| Датачисло. Пример: 1984-06-3021.
|-
| EmailTariffType| Адрес электронной почты заказчикаНаименование тарифа.| Строка. Пример: client@host.comПОЛНЫЙ.
|-
| PhoneHasSeat| Номер телефона заказчикаЗанимает ли пассажир отдельное место.| СтрокаДопустимые значения:<ul><li>true — с местом,</li><li>false — без места. Пример: +74951234567</li></ul>
|}
<sup>*</sup> — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки. <sup>**</sup> — Нижний и верхний пределы определяются видом сообщения:* от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. <sup>***</sup> — Верхний предел определяется видом сообщения:* до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. '''Элемент Passenger'''{| style="width: 800px" class="wikitable"|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| lastnametrainNumber| Фамилия пассажираНомер поезда.| Строка. Пример: Сидоров098ХА.
|-
| nametrainName| Имя пассажирафирменного поезда. Приходит от поставщика.| Строка. Пример: ВладимирРоссия.
|-
| middlenamedepartureStation| Отчество Станция отправления пассажира.| Строка. Пример: КонстантиновичМОСКВА КАЗ.|-| arrivalStation| Станция прибытия пассажира.| Строка. Пример: КАЗАНЬ ПАС.
|-
| doc_typetrainCategory| Тип документапоезда.| СтрокаЧисло. Пример: C1.<br/>Допустимые значения:
<ul>
<li>C 0 Российский паспортнеизвестный тип поезда</li><li>P 1 Заграничный паспортскорый поезд</li><li>A 2 Иностранный документфирменный поезд</li><li>S 3 Паспорт морякаскоростной поезд</li><li>M 4 Военный билет</li><li>B — Свидетельство о рождениифирменный скоростной поезд</li>
</ul>
|-
| passport_numberbeginStation| Серия и номер документаНачальная станция в маршруте поезда.| Строка. Пример: 1806123456. Казань
|-
| genderendStation| Пол пассажираКонечная станция в маршруте поезда.| Строка. Пример: M.<br/>Допустимые значения:<ul><li>M — мужской</li><li>F — женский</li></ul>Москва
|-
| date_of_birthstartDate| Дата рождения и время отправления со станции отправления пассажира.| Датаи время. Пример: 20.05.19872014-03-06 00:15:00.
|-
| nationalityendDate| Гражданство Дата и время прибытия со станции отправления пассажира.| Строка (ISO 3166Дата и время. Пример: 2014-1 Alpha03-2). Пример06 13:33: RU00.
|-
| passenger_typetimeInRoad| Время в пути от станции отправления до станции прибытия пассажира.| Число (секунд). Пример: 47880.|-| carNumber| Номер вагона.| Число. Пример: 7.|-| carType| Тип пассажиравагона.| СтрокаЧисло. Пример: ADT1.<br/>Допустимые значения:
<ul>
<li>ADT — взрослый1 - общий вагон</li><li>CLD — ребенок до 10 лет2 - сидячий вагон<sup/li><li>*, **3 - плацкарта</supli><li>4 - купе</li><li>INF — ребенок до 5 лет- люкс</li><supli>*, ***6 - мягкий</supli><li>7 - неизвестный тип</li>
</ul>
|-
| passenger_idchoosenSeats| Порядковый номер пассажира в заказеЭлемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.| Число. Пример: 2Элементы type.
|-
| TotalPricechoosenRange| Общая стоимость билета со сборами для данного пассажираВыбранный диапазон мест в вагоне.| Число. Пример: 1934Элементы start, end.
|-
| FarePriceserviceClass| Стоимость по тарифу тарифуОписание услуг. Приходит от поставщика.| ЧислоТекст. Пример: 1884В стоимость входит - постельное белье.Наличие установки кондиционирования воздуха не гарантировано.|} '''Элемент type'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | ChargeЭлемент! scope="col" width="300" | Сбор агентства.Описание! scope="col" width="300" | Число. Пример: 50.Допустимые значения
|-
| RefundMoneylower| Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возвратКоличество нижних мест.| Число. Пример: 16431.
|-
| ChargeForRefundupper| Cбор агентства за возвратКоличество верхних мест.| Число. Пример: 1000.
|-
| TicketNumberlower_side| Номер билетаКоличество нижних боковых мест.| Число. Пример: 739447084726241.
|-
| SeatNumberupper_side| Номер местаКоличество верхних боковых мест.| числоЧисло. Пример: 211.
|-
| TariffTypeundefined| Наименование тарифаКоличество мест неопределенного типа.| СтрокаЧисло. Пример: ПОЛНЫЙ0.|-| HasSeat| Занимает ли пассажир отдельное место.| Допустимые значения:<ul><li>true — с местом,</li><li>false — без места.</li></ul>
|}
<sup>*</sup> — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки. <sup>**</sup> — Нижний и верхний пределы определяются видом сообщения:* от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. <sup>***</sup> — Верхний предел определяется видом сообщения:* до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. '''Элемент PassengerchoosenRange'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Допустимые значения
|-
| trainNumberstart| Номер поездаНачало выбранного диапазон мест в вагоне<sup>*</sup>.| СтрокаЧисло. Пример: 098ХА4.
|-
| trainNameend| Имя фирменного поезда. Приходит от поставщика.| Строка. Пример: Россия.|-| departureStation| Станция отправления пассажира.| Строка. Пример: МОСКВА КАЗ.|-| arrivalStation| Станция прибытия пассажира.| Строка. Пример: КАЗАНЬ ПАС.|-| trainCategory| Тип поезда.| Число. Пример: 1.<br/>Допустимые значения:<ul><li>0 — неизвестный тип поезда</li>Конец выбранного диапазон мест в вагоне<lisup>1 — скорый поезд*</lisup><li>2 — фирменный поезд</li><li>3 — скоростной поезд</li><li>4 — фирменный скоростной поезд</li></ul>|-| beginStation| Начальная станция в маршруте поезда.| Строка. Пример: Казань|-| endStation| Конечная станция в маршруте поезда.| Строка. Пример: Москва|-| startDate| Дата и время отправления со станции отправления пассажира.| Дата и время. Пример: 2014-03-06 00:15:00.|-| endDate| Дата и время прибытия со станции отправления пассажира.| Дата и время. Пример: 2014-03-06 13:33:00. |-| timeInRoad| Время в пути от станции отправления до станции прибытия пассажира.| Число (секунд). Пример: 4788017.|-| carNumber| Номер вагона.| Число. Пример: 7.|-| carType| Тип вагона.| Число. Пример: 1.<br/>Допустимые значения:}<ul><lisup>1 - общий вагон*</lisup><li>2 - сидячий вагон</li><li>3 - плацкарта</li><li>4 - купе</li><li>5 - люкс</li><li>6 - мягкий</li><li>7 - неизвестный тип</li></ul>|-| choosenSeats| Элемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.| Элементы type.|-| choosenRange| Выбранный — Если диапазон не был зада пользователем на этапе выбора мест в вагоне.| Элементы , то поля start, и endбудут содержать нули.|-| serviceClass| Описание услуг. Приходит от поставщика.| Текст. Пример: В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.|} '''Элемент type'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| lower| Количество нижних мест.| Число. Пример: 1.|-| upper| Количество верхних мест.| Число. Пример: 0.|-| lower_side| Количество нижних боковых мест.| Число. Пример: 1.|-| upper_side| Количество верхних боковых мест.| Число. Пример: 1.|-| undefined| Количество мест неопределенного типа.| Число. Пример: 0.|}
'''Элемент choosenRange'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| start| Начало выбранного диапазон мест в вагоне<sup>*</sup>.| Число. Пример: 4.|-| end| Конец выбранного диапазон мест в вагоне<sup>*</supdiv>.| Число. Пример: 17.|} <sup>*</supdiv> — Если диапазон не был зада пользователем на этапе выбора мест, то поля start и end будут содержать нули.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Формат JSON ====
<div class="mw-collapsible-content">
см. http://docs.nemo.travel/ru/nemo-backoffice-api/json_api/order_export
</div>
</div>

Навигация

'