Изменения

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

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

932 байта добавлено, 16:01, 22 февраля 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, на который будет производиться выгрузка данных.
* '''Код сайта в системе Софи''' — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в {{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.
*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">==== Формат 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">
<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>
<passenger_type>ADT</passenger_type> <lastname>IVANOVСидоров</lastname> <namedoc_type>C</doc_type> <passport_number>1806326598</passport_number> <passenger_id>1</passenger_id> <gender>M</gender> <date_of_birth>20.04.1984</date_of_birth> <TotalPrice>28752.9</TotalPrice> <FarePrice>2613.9</FarePrice> <Charge>26139</Charge> <RefundMoney>8649.3</RefundMoney> <ChargeForRefund>100</ChargeForRefund> <TicketNumber>74944708487545</TicketNumber> <SeatNumber>033</SeatNumber> <HasSeat>IVANtrue</nameHasSeat>
</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>
<NametrainNumber>Интурист098ХА</NametrainNumber> <City> <Code>34<trainName /Code> <NamedepartureStation>Великий НовгородМОСКВА КАЗ</NamedepartureStation> </CityarrivalStation> КАЗАНЬ ПАС<Location /arrivalStation> <StarRatingtrainCategory>31</StarRatingtrainCategory> <DaysbeginStation>2Москва</DaysbeginStation> <NightsendStation>1Казань</NightsendStation> <CheckInDatestartDate>2014.-04.-26 00:15:00</CheckInDatestartDate> <CheckOutDateendDate>2014.-04.16-26 13:33:00</CheckOutDateendDate> <CheckInTimetimeInRoad>14:0047880</CheckInTimetimeInRoad> <CheckOutTimecarNumber>12:008</CheckOutTimecarNumber> <OnRequestcarType>false4</OnRequestcarType> </InfochoosenSeats> <Roomstype> <Roomlower>1</lower> <Name>Двухместный стандарт (две кровати)</Nametype> <Type>SNGL</Typetype> <FareIdupper>1</FareIdupper> </Roomtype> </Roomstype> <Fareslower_side> 0<Fare/lower_side> <Id>1</Idtype> <Pricetype> <Amountupper_side>19500</Amountupper_side> <CurrencyCode>RUB </CurrencyCodetype> </Pricetype> <Mealsundefined>Завтрак "Шведский стол",Отсутствует0</Mealsundefined> <Description>Одноместный</Descriptiontype> </Fare> </Fares> <CancelChargeschoosenSeats> <ChargechoosenRange> <DateFromstart>2014.04.13-00:000</DateFromstart> <DateToend>2014.04.15-00:000</DateTo> <Amount>1488</Amount> <CurrencyCode>RUB</CurrencyCodeend> </Charge> </CancelCharges> <ModifyCharges /> <ModificationMethodschoosenRange> <MethodserviceClass>MOD_PASS_NAMESВ стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.</Method> <Method>MOD_DATES</MethodserviceClass> </ModificationMethodsInfo></PNR></syntaxhighlight></div></div>'''Элемент PNR''' === Выгрузка заказа для компонента «ЖД» ===Для компонента Элемент '''«ЖД»PNR''' доступна выгрузка заказов в формате Nemo— Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.  <div class{| style="toccolours mw-collapsible mw-collapsedwidth: 800px" styleclass="width:1000pxwikitable">==== Формат Nemo ====|-<div class! scope="mw-collapsible-contentcol"><syntaxhighlight langwidth="xml200" line enclose| Элемент! scope="divcol" stylewidth="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;300">| Описание<?xml version! scope="1.0col" encodingwidth="UTF-8300"?>| Допустимые значения<PNR>|- <| Common> <| Общая информация по заказу.| Элементы id>123456</id> <, Type>TRAINS</Type> <, Service>UFS</Service> <, Locator>64345987</Locator> <, BeginDateTime>2014.04.26-00:15</BeginDateTime> <, EndDateTime>2014.04.26-13:33</EndDateTime> <, TicketingDateTime>2014.06.06-15:10</TicketingDateTime> <VoidDateTime>2014.06.07-14:19</VoidDateTime> <, TotalPrice> <Amount>57505.8</Amount> <CurrencyCode>RUB</CurrencyCode> </TotalPrice> <, UserId>123</UserId> <, EEUserId /> <, UserLogin>mikhalevtur</UserLogin> <, GroupId>122</GroupId> <, UserStatus>Менеджер</UserStatus> <, DateCreate>2014.04.24|-15:03</DateCreate> </Common> <| Payment> <Title>Testpay</Title> <Method>Testpay</Method> <BillingId>117603370</BillingId> <Date>2014-04-24 15:10:12</Date> <CreateDate>2014-06-06 15:10:00</CreateDate>| Информация о стоимости, штрафах, статусе заказа. <| Элементы Status>cancelled</Status> <, PenaltyDate /> <, Timelimit>2014-04-24 15:18:01</Timelimit> <, Charge> <Amount>52278</Amount> <CurrencyCode>RUB</CurrencyCode> </Charge> <, Book> <Amount>5227, Penalty, Total, PaidValue.8</Amount> <CurrencyCode>RUB</CurrencyCode>|- </Book>| Client <Penalty>| Информация о заказчике. <Amount>0</Amount>| Элементы Name, MiddleName, Number, Birth, Email, Phone. <CurrencyCode>RUB</CurrencyCode>|- </Penalty>| Passengers <TotalAgencyChargeForRefund>| Записи о пассажирах. <Amount>100</Amount>| Элементы Passenger. <CurrencyCode>RUB</CurrencyCode>|- </TotalAgencyChargeForRefund>| Info <Total>| Типовая информация по заказу в контексте услуги. <Amount>57505| Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass.8</Amount> <CurrencyCode>RUB</CurrencyCode>|} </Total> <PaidValue>'''Элемент Common''' <Amount>0</Amount>{| style="width: 800px" class="wikitable" <CurrencyCode>RUB</CurrencyCode>|- </PaidValue>! scope="col" width="200" | Элемент </Payment>! scope="col" width="300" | Описание <Client>! scope="col" width="300" | Допустимые значения <LastName>Сидоров</LastName>|- <Name>Владимир</Name>| id <MiddleName>Константинович</MiddleName>| Номер заказа в {{NameSystem}}. <Number>1806326598</Number>| Число. Пример: 268281. <Birth>1987|-05-20</Birth> <Email>mail@host| Type| Тип услуги.com</Email> <Phone>+79871234567| Строка: Пример: FLIGHTS.<br/Phone> Допустимые значения: </Clientul> <Passengersli> <Passenger> <name>ВладимирFLIGHTS — авиа,</nameli> <middlenameli>КонстантиновичHOTELS — отели,</middlenameli> <phoneli> TRAINS — ЖД.<country /li> <city /ul> <number>+79271031610</number>|- <expansion />| Service </phone>| Поставщик услуги. <email>mlsdsar@gmail| Строка. Пример: UFS.com</email> <nationality>RU</nationality>|- <passenger_type>ADT</passenger_type>| Locator <lastname>Сидоров</lastname>| Идентификатор в системе поставщика. <doc_type>C</doc_type>| Число. Пример: 65525140. <passport_number>1806326598</passport_number>|- <passenger_id>1</passenger_id>| BeginDateTime <gender>M</gender>| Дата и время отправления первого сегмента. <date_of_birth>20| Дата и время. Пример: 2014.0403.1984</date_of_birth> <TotalPrice>2875206-00:15.9</TotalPrice> <FarePrice>2613.9</FarePrice>|- <Charge>26139</Charge>| EndDateTime <RefundMoney>8649| Дата и время прибытия последнего сегмента.3</RefundMoney> <ChargeForRefund>100</ChargeForRefund>| Дата и время. Пример: 2014.03.06-13:33. <TicketNumber>74944708487545</TicketNumber>|- <SeatNumber>033</SeatNumber>| TicketingDateTime <HasSeat>true</HasSeat>| Дата и время выписки билета. </Passenger>| Дата и время. Пример: 2014.10.17-17:23 <Passenger>|- <nationality>RU</nationality>| VoidDateTime <middlename>Константинович</middlename>| Дата и время возврата билета. <passenger_type>ADT</passenger_type>| Дата и время. Пример: 2014.10.17-17:23 <lastname>Сидоров</lastname>|- <name>Иван</name>| TotalPrice <doc_type>C</doc_type>| Общая стоимость заказа. <passport_number>1806326554</passport_number>| Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимости. <passenger_id>2</passenger_id>|- <gender>M</gender>| UserId <date_of_birth>05| Идентификатор пользователя в системе {{NameSystem}}, оформившего заказ.04| Число.1984</date_of_birth> <TotalPrice>28752Пример: 123.9</TotalPrice> <FarePrice>2613.9</FarePrice>|- <Charge>26139</Charge>| UserLogin <TicketNumber />| Логин пользователя в системе {{NameSystem}}, оформившего заказ. <SeatNumber>034</SeatNumber>| Строка. Пример: userLogin. <HasSeat>true</HasSeat>|- </Passenger>| GroupId </Passengers>| Идентификатор группы пользователя в системе {{NameSystem}}, оформившего заказ. <Info>| Число. Пример: 122. <trainNumber>098ХА</trainNumber>|- <trainName />| UserStatus <departureStation>МОСКВА КАЗ</departureStation>| Тип пользователя в системе {{NameSystem}}. <arrivalStation>КАЗАНЬ ПАС</arrivalStation>| Строка. Пример: Менеджер. <trainCategory>1</trainCategory>|- <beginStation>Москва</beginStation>| DateCreate <endStation>Казань</endStation>| Дата и время резервирования в системе поставщика. <startDate>| Дата и время. Пример: 2014.03.05-04-26 00:15:00</startDate>08 <endDate>2014-04-26 13:33:00</endDate>|} <timeInRoad>47880</timeInRoad> <carNumber>8</carNumber>'''Элемент TotalPrice''' <carType>4</carType>{| style="width: 800px" class="wikitable" <choosenSeats>|- <type>! scope="col" width="200" | Элемент <lower>1</lower>! scope="col" width="300" | Описание </type>! scope="col" width="300" | Допустимые значения <type>|- <upper>1</upper>| Amount </type>| Номинал. <type>| Число. Пример: 1884. <lower_side>0</lower_side>|- </type>| CurrencyCode <type>| Валюта. <upper_side>0</upper_side> </type> <type> <undefined>0</undefined> </type> </choosenSeats> <choosenRange> <start>0</start> <end>0</end> </choosenRange> <serviceClass>В стоимость входит | Строка (Код ISO 4217 alfa- постельное белье3). Наличие установки кондиционирования воздуха не гарантированоПример: RUB.</serviceClass> </Info></PNR></syntaxhighlight>|}
'''Элемент PNRPayment'''Элемент '''PNR''' — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CommonTitle| Общая информация по заказуНазвание платежного шлюза<sup>*</sup>.| Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreateСтрока. Пример: Testpay.|-| Method| Тип формы оплаты<sup>*</sup>.| Строка. Пример: Testpay.
|-
| PaymentBillingId| Информация о стоимости, штрафах, статусе заказаИдентификатор транзакции {{NameSystem}}.| Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValueСтрока. Пример: 117603370.
|-
| ClientDate| Информация о заказчикеДата и время оплаты платежной транзакции {{NameSystem}}.| Элементы Name, MiddleName, Number, Birth, Email, PhoneСтрока. Пример: 2014-04-24 15:10:12.
|-
| PassengersCreateDate| Записи о пассажирахДата и время создания платежной транзакции {{NameSystem}}.| Элементы PassengerСтрока. Пример: 2014-06-06 15:10:00.
|-
| InfoStatus| Типовая информация по заказу Статус заказа в контексте услугисистеме {{NameSystem}}.| Элементы trainNumberСтрока. Пример: booked.<br/>Допустимые значения: <ul><li>pending — в ожидании, trainName</li><li>booked — зарезервирован, departureStation</li><li>ticket — выписан, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass</li><li>cancelled — отменен.</li>|} '''Элемент Common'''{| style="width: 800px" class="wikitable"</ul>
|-
! scope="col" width="200" | ЭлементPenaltyDate! scope="col" width="300" | ОписаниеДата и время наступления штрафных санкций.! scope="col" width="300" | Допустимые значенияДата и время. Пример: 2014-03-05 15:23:40.
|-
| idTimelimit| Номер Таймлимит на оплату и подтверждение заказа в {{NameSystem}}.| ЧислоДата и время. Пример: 2682812014-03-05 15:23:40.
|-
| TypeCharge| Тип услугиСбор агентства.| Строка: Пример: FLIGHTSСм.<br/>Допустимые значения: <ul><li>FLIGHTS — авиа,</li><li>HOTELS — отели,</li><li>TRAINS — ЖДэлемент Common.TotalPrice.</li></ul>
|-
| ServiceBook| Поставщик услугиТариф.| СтрокаСм. Пример: UFSэлемент Common.TotalPrice.
|-
| LocatorPenalty| Идентификатор в системе поставщикаШтраф.<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.</span>| ЧислоСм. Пример: 65525140элемент Common.TotalPrice.
|-
| BeginDateTimeTotalAgencyChargeForRefund| Дата и время отправления первого сегментаОбщий сбор агентства за возврат.| Дата и времяСм. Пример: 2014элемент Common.03.06-00:15TotalPrice.
|-
| EndDateTimeTotal| Дата и время прибытия последнего сегментаОбщая стоимость.| Дата и времяСм. Пример: 2014элемент Common.03.06-13:33TotalPrice.
|-
| TicketingDateTimePaidValue| Дата и время выписки билетаОплачено.| Дата и времяСм. Примерэлемент Common.TotalPrice.|} <sup>*</sup> — список возможный платежных шлюзов: 2014<br/>Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney.10.17-17 '''Элемент Client'''{| style="width:23800px" class="wikitable"
|-
! scope="col" width="200" | VoidDateTimeЭлемент! scope="col" width="300" | Дата и время возврата билета.Описание! scope="col" width="300" | Дата и время. Пример: 2014.10.17-17:23Допустимые значения
|-
| TotalPriceName| Общая стоимость заказаФамилия и имя заказчика.| Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимостиСтрока. Пример: Иванов Иван.
|-
| UserIdMiddleName| Идентификатор пользователя в системе {{NameSystem}}, оформившего заказОтчество заказчика.| ЧислоСтрока. Пример: 123Иванович.
|-
| UserLoginNumber| Логин пользователя в системе {{NameSystem}}, оформившего заказСерия и номер документа.| Строка. Пример: userLogin1806123456.
|-
| GroupIdBirth| Идентификатор группы пользователя в системе {{NameSystem}}, оформившего заказДата рождения заказчика.| ЧислоДата. Пример: 1221984-06-30.
|-
| UserStatusEmail| Тип пользователя в системе {{NameSystem}}Адрес электронной почты заказчика.| Строка. Пример: Менеджерclient@host.com.
|-
| DateCreatePhone| Дата и время резервирования в системе поставщикаНомер телефона заказчика.| Дата и времяСтрока. Пример: 2014.03.05-15:08+74951234567
|}
'''Элемент TotalPricePassenger'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| Amountlastname| НоминалФамилия пассажира.| ЧислоСтрока. Пример: 1884Сидоров.
|-
| CurrencyCodename| ВалютаИмя пассажира.| Строка (Код ISO 4217 alfa-3). Пример: RUBВладимир.|} '''Элемент Payment'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элементmiddlename! scope="col" width="300" | ОписаниеОтчество пассажира.! scope="col" width="300" | Допустимые значенияСтрока. Пример: Константинович.
|-
| Titledoc_type| Название платежного шлюза<sup>*</sup>Тип документа.| Строка. Пример: TestpayC.<br/>Допустимые значения:<ul><li>C — Российский паспорт</li><li>P — Заграничный паспорт</li><li>A — Иностранный документ</li><li>S — Паспорт моряка</li><li>M — Военный билет</li><li>B — Свидетельство о рождении</li></ul>
|-
| Methodpassport_number| Тип формы оплаты<sup>*</sup>Серия и номер документа.| Строка. Пример: Testpay1806123456.
|-
| BillingIdgender| Идентификатор транзакции {{NameSystem}}Пол пассажира.| Строка. Пример: 117603370M.<br/>Допустимые значения:<ul><li>M — мужской</li><li>F — женский</li></ul>
|-
| Datedate_of_birth| Дата и время оплаты платежной транзакции {{NameSystem}}рождения пассажира.| СтрокаДата. Пример: 2014-04-24 15:10:1220.05.1987.
|-
| CreateDatenationality| Дата и время создания платежной транзакции {{NameSystem}}Гражданство пассажира.| Строка(ISO 3166-1 Alpha-2). Пример: 2014-06-06 15:10:00RU.
|-
| Statuspassenger_type| Статус заказа в системе {{NameSystem}}Тип пассажира.| Строка. Пример: bookedADT.<br/>Допустимые значения:
<ul>
<li>pending ADT в ожидании,взрослый</li><li>booked CLD зарезервированребенок до 10 лет<sup>*,**</sup></li><li>ticket INF выписанребенок до 5 лет<sup>*,***</lisup><li>cancelled — отменен.</li>
</ul>
|-
| PenaltyDatepassenger_id| Дата и время наступления штрафных санкцийПорядковый номер пассажира в заказе.| Дата и времяЧисло. Пример: 2014-03-05 15:23:402.
|-
| TimelimitTotalPrice| Таймлимит на оплату и подтверждение заказаОбщая стоимость билета со сборами для данного пассажира.| Дата и времяЧисло. Пример: 20141934.|-03-05 15:23| FarePrice| Стоимость по тарифу тарифу.| Число. Пример:401884.
|-
| Charge
| Сбор агентства.
| СмЧисло. элемент Common.TotalPriceПример: 50.
|-
| BookRefundMoney| ТарифСумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.| См. элемент CommonЧисло.TotalPriceПример: 1643.
|-
| PenaltyChargeForRefund| ШтрафCбор агентства за возврат. <br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.</span>| СмЧисло. элемент Common.TotalPriceПример: 100.
|-
| TotalAgencyChargeForRefundTicketNumber| Общий сбор агентства за возвратНомер билета.| СмЧисло. элемент CommonПример: 73944708472624.TotalPrice|-| SeatNumber| Номер места.| число. Пример: 21.
|-
| TotalTariffType| Общая стоимостьНаименование тарифа.| СмСтрока. элемент Common.TotalPriceПример: ПОЛНЫЙ.
|-
| PaidValueHasSeat| ОплаченоЗанимает ли пассажир отдельное место.| См. элемент Common.TotalPriceДопустимые значения:<ul><li>true — с местом,</li><li>false — без места.</li></ul>
|}
<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Не включая верхний предел. Возраст ребенка определяется на день совершения поездки.
<sup>**</sup> — Нижний и верхний пределы определяются видом сообщения:* от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. <sup>***</sup> — Верхний предел определяется видом сообщения:* до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.* до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.* до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад. '''Элемент ClientPassenger'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| NametrainNumber| Фамилия и имя заказчикаНомер поезда.| Строка. Пример: Иванов Иван098ХА.
|-
| MiddleNametrainName| Отчество заказчикаИмя фирменного поезда. Приходит от поставщика.| Строка. Пример: ИвановичРоссия.
|-
| NumberdepartureStation| Серия и номер документаСтанция отправления пассажира.| Строка. Пример: 1806123456МОСКВА КАЗ.
|-
| BirtharrivalStation| Дата рождения заказчикаСтанция прибытия пассажира.| ДатаСтрока. Пример: 1984КАЗАНЬ ПАС.|-06-30| trainCategory| Тип поезда.| Число. Пример: 1.<br/>Допустимые значения:<ul><li>0 — неизвестный тип поезда</li><li>1 — скорый поезд</li><li>2 — фирменный поезд</li><li>3 — скоростной поезд</li><li>4 — фирменный скоростной поезд</li></ul>
|-
| EmailbeginStation| Адрес электронной почты заказчикаНачальная станция в маршруте поезда.| Строка. Пример: client@host.com.Казань
|-
| PhoneendStation| Номер телефона заказчикаКонечная станция в маршруте поезда.| Строка. Пример: +74951234567|} '''Элемент Passenger'''{| style="width: 800px" class="wikitable"Москва
|-
! scope="col" width="200" | ЭлементstartDate! scope="col" width="300" | ОписаниеДата и время отправления со станции отправления пассажира.! scope="col" width="300" | Допустимые значенияДата и время. Пример: 2014-03-06 00:15:00.
|-
| lastnameendDate| Фамилия Дата и время прибытия со станции отправления пассажира.| СтрокаДата и время. Пример: Сидоров2014-03-06 13:33:00.
|-
| nametimeInRoad| Имя Время в пути от станции отправления до станции прибытия пассажира.| СтрокаЧисло (секунд). Пример: Владимир47880.
|-
| middlenamecarNumber| Отчество пассажираНомер вагона.| СтрокаЧисло. Пример: Константинович7.
|-
| doc_typecarType| Тип документавагона.| СтрокаЧисло. Пример: C1.<br/>Допустимые значения:
<ul>
<li>C — Российский паспорт1 - общий вагон</li><li>P — Заграничный паспорт2 - сидячий вагон</li><li>A — Иностранный документ3 - плацкарта</li><li>S — Паспорт моряка4 - купе</li><li>M — Военный билет5 - люкс</li><li>B — Свидетельство о рождении6 - мягкий</li><li>7 - неизвестный тип</li>
</ul>
|-
| passport_numberchoosenSeats| Серия и номер документаЭлемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.| Строка. Пример: 1806123456Элементы type.
|-
| genderchoosenRange| Пол пассажираВыбранный диапазон мест в вагоне.| СтрокаЭлементы start, end. Пример: M.<br/>Допустимые значения:<ul><li>M — мужской</li><li>F — женский</li></ul>
|-
| date_of_birthserviceClass| Дата рождения пассажираОписание услуг. Приходит от поставщика.| ДатаТекст. Пример: 20В стоимость входит - постельное белье.05.1987Наличие установки кондиционирования воздуха не гарантировано.|} '''Элемент type'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | nationalityЭлемент! scope="col" width="300" | Гражданство пассажира.Описание! scope="col" width="300" | Строка (ISO 3166-1 Alpha-2). Пример: RU.Допустимые значения
|-
| passenger_typelower| Тип пассажираКоличество нижних мест.| СтрокаЧисло. Пример: ADT1.<br/>Допустимые значения:<ul><li>ADT — взрослый</li><li>CLD — ребенок до 10 лет<sup>*, **</sup></li><li>INF — ребенок до 5 лет<sup>*, ***</sup></li></ul>
|-
| passenger_idupper| Порядковый номер пассажира в заказеКоличество верхних мест.| Число. Пример: 20.
|-
| TotalPricelower_side| Общая стоимость билета со сборами для данного пассажираКоличество нижних боковых мест.| Число. Пример: 19341.
|-
| FarePriceupper_side| Стоимость по тарифу тарифуКоличество верхних боковых мест.| Число. Пример: 18841.
|-
| Chargeundefined| Сбор агентстваКоличество мест неопределенного типа.| Число. Пример: 500.|} '''Элемент choosenRange'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | RefundMoneyЭлемент! scope="col" width="300" | Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.Описание! scope="col" width="300" | Число. Пример: 1643.Допустимые значения
|-
| ChargeForRefundstart| Cбор агентства за возвратНачало выбранного диапазон мест в вагоне<sup>*</sup>.| Число. Пример: 1004.
|-
| TicketNumberend| Номер билетаКонец выбранного диапазон мест в вагоне<sup>*</sup>.| Число. Пример: 7394470847262417.|-| SeatNumber| Номер места.| число. Пример: 21.|-| TariffType| Наименование тарифа.| Строка. Пример: ПОЛНЫЙ.|-| HasSeat}| Занимает ли пассажир отдельное место.| Допустимые значения:<ulsup>*<li/sup>true с местомЕсли диапазон не был зада пользователем на этапе выбора мест,</li><li>false — без местато поля start и end будут содержать нули.</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" | Допустимые значения|-| trainNumber| Номер поезда.| Строка. Пример: 098ХА.|-| trainName| Имя фирменного поезда. Приходит от поставщика.| Строка. Пример: Россия.|-| departureStation| Станция отправления пассажира.| Строка. Пример: МОСКВА КАЗ.|-| arrivalStation| Станция прибытия пассажира.| Строка. Пример: КАЗАНЬ ПАС.|-| trainCategory| Тип поезда.| Число. Пример: 1.<br/>Допустимые значения:<ul><li>0 — неизвестный тип поезда</li><li>1 — скорый поезд</li><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| Время в пути от станции отправления до станции прибытия пассажира.| Число (секунд). Пример: 47880.|-| carNumber| Номер вагона.| Число. Пример: 7.|-| carType| Тип вагона.| Число. Пример: 1.<br/div>Допустимые значения:<ul><li>1 - общий вагон</li><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>*</sup>.| Число. Пример: 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>

Навигация

'