Изменения

← Предыдущая правка

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

36 026 байт добавлено, 30 январь

→‎Настройки

[[Категория:Статистика и отчёты]]

[[Категория:Функции]]

[[Категория:Модули]] [[Категория:Встроенные модули]]'''Выгрузка заказов''' — это экспорт данных заказа или заказов для различных компонентов системы ~~Nemo~~{{NameSystemLink}}.

== Описание ==

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

[[~~Файл~~файл:~~Export~~ВыгрузкаСофиИНемо.png]] {{Attention| *Выгрузка заказа в формате СОФИ при синхронизации произойдет, только если в заказе произошли изменения. *Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.}}

== Настройки ==

[[Файл:Выгрузка заказов.jpg|400px|thumb|right|Настройка процесса выгрузки заказов для авиабилетов]]~~На странице настроек~~ Настройки выгрузки заказов доступны ~~следующие опции:~~в разделе '''Настройки системы → Интеграция → Выгрузка заказов'''.*  '''Экспортировать заказы в формате''' — настройка определяет один из доступных форматов выгрузки заказов:** ''''' Nemo''''' — внутренний формат системы ~~Nemo~~{{NameSystem}}, доступен по умолчанию.** ''''' Софи''''' — дополнительный формат, становится доступным при включении модуля '''«Выгрузка заказов Софи»'''. ** '''''Nemo Backoffice''''' — возможность экспорта заказов в формате JSON, который предоставляет более полный и актуальный объем данных, использует международные стандарты формата данных, является усовершенствованной версией протокола экспорта данных в формате Nemo.* '''Адрес для отправки нотификаций об изменении заказа''' — если задан, то при получении изменений в ходе актуализации отправляется 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 ~~стороннего~~ скрипта для ~~XML уведомлений~~выгрузки в формате СОФИ''' — URL, на который будет производиться выгрузка данных.Cистема {{NameSystem}} отправляет файлы выгрузки на указанный в этом поле http-адрес через POST-запрос (см. https://ru.wikipedia.org/wiki/POST_(HTTP) ). Скрипт для обработки получаемых данных должен быть написан на стороне самого клиента. Задача скрипта — принять данные и корректно их обработать. Все данные, которые можно получить через браузер, также можно получить и альтернативными программными средствами (автоматизируя процесс выгрузки). Рекомендуется к использованию библиотека CURL (см. https://ru.wikipedia.org/wiki/CURL) Готовые примеры скриптов сотрудники {{NameSystem}} не предоставляют.<br>Если у субагента указан свой Url скрипта для выгрузки, отличный от URL корневого агенства, то выгрузка по заказам этого субагента будет идти на оба адреса. Главный агент получает информацию по всем заказам всех субагентов, субагент получает выгрузку только своих заказов.<br/> * '''Адрес для выгрузки в Nemo Backoffice''' — URL, на который будет производиться выгрузка данных.* '''Ключ безопасности для выгрузки в Nemo Backoffice''' — значение, которое задается самостоятельно агентством на стороне принимающего запрос сервера.* '''Код сайта в системе Софи''' — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в ~~Немо~~{{NameSystem}}. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства.

* '''Повторная отправка в случае неудачи''' — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).

* '''Список адресов для уведомлений (разделяется запятыми)''' — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.

* '''Экспортировать после оплаты''' — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа(поддерживается для выгрузки в формате Nemo и Backoffice).~~<br/><span style="background-color:#fff0f5;">~~* '''~~<span style="color:#ff0000;">Внимание!</span>~~Экспортировать код доступа к заказу''' ~~Доступно только для формата~~ — настройка включает отображение кода доступа в выгрузке. Поддерживается строго в формате Nemo.~~</span>~~

* '''Отправлять нотификацию о необходимости установки кода валидатора в реквизитах''' — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.

* '''E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах'''

* '''Временная зона для дат''' - — настройка позволяет менять временную зону в выгрузке Софи. [[Файл:Временная зона для дат.jpg|500px|thumb|right|Настройка "Временная зона для дат"]]

** '''Использовать временную зону системных настроек''', через которую будет использоваться часовой пояс указанный в "Настройках системы".

** '''Использовать временную зону реквизитов''' - — часовой пояс подтягивается индивидуально от каждого пакета реквизитов подключения к ГДС.** '''Выбрать другую временную зону''' дает возможность выбирать временную зону, независимо от других настроек.

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

Система поддерживает выгрузку заказов в форматах '''''Nemo''''', '''''Софи''''' и '''''~~Софи~~JSON'''''. Рекомендуется использовать функционал выгрузки JSON.

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

! style="font-weight: bold;" | Формат Nemo

! style="background-color: #99FF66;" | +

! style="background-color: #~~99FF66~~FF6666;" | +−

! style="background-color: #99FF66;" | +

|-

! style="background-color: #FF6666;" | −

|-

! style="font-weight: bold;" | Формат JSON

! style="background-color: #99FF66;" | +

|}

! scope="col" style="width: 100px;" | Войдирование

! 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="font-weight: bold;" | Формат Софи

! style="background-color: #FF6666;" | -

! style="background-color: #FF6666;" | −

! style="background-color: #FF6666;" | -

! style="background-color: #99FF66;" | +

! style="background-color: #FF6666;" | −

|-

! style="font-weight: bold;" | Формат JSON

! style="background-color: #99FF66;" | +

! scope="col" style="width: 100px;" | Аннуляция

|-

! style="font-weight: bold;" | Формат ~~Nemo~~JSON

! style="background-color: #99FF66;" | +

|-

! style="font-weight: bold;" | Формат Nemo

! style="background-color: #99FF66;" | +

|-

! style="font-weight: bold;" | Формат JSON

! style="background-color: #99FF66;" | +

|}

*  Выгрузка заказа в формате Nemo при оплате произойдет , только если включена настройка '''''«Экспортировать после оплаты»''' в разделе '''Настройки системы''' ~~в разделе~~ → '''~~«Заказы»~~Интеграция''' → '''~~«Выгрузка заказов»~~Выгрузка заказов'''.<br/>

** Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.<br/>

***  Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.<br/>****  Выгрузка заказа при обмене или возврате произойдет при завершении работы с заявкой (при пропуске импорта PNR).<br/>*****  Выгрузка заказа при импорте PNR в рамках работы модуля [[Импорт PNR]].

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

| 500

| Любая внутренняя ошибка сервера.

|-

| 503

| Служба недоступна. Ошибка из-за временной перегрузки или отключения на техническое обслуживание сервера.

|}

<Type>ServicePack</Type>

<Price>

</Price>

</ExtService>

<Type>AeroExpress</Type>

</ExtService>

</ExtServices>

</Common>

</Charge>

</SubagentCharge>

<Seg/>

</Tickets>

<Seg/>

<Seg/>

</Tickets>

<Seg/>

</Passengers>

<FlightType>Внутренний</FlightType>

<Info>

</OrderInfo>

<Remarks>Debit</Remarks>

<Price>

</Price>

<Data>

</SegmentNums>

</Data>

</PassengersData>

</Return>

</Returns>

<Price>

</Price>

<Text>Причина создания заявки</Text>

</Exchange>

</Exchanges>

</PNR>

</syntaxhighlight>

<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.</span> Ремарка ''<Remarks>Debit</Remarks>'' является не обязательной, означает что заказ был оплачен с помощью способа оплаты ~~«Депозит»~~«Баланс компании»;если же заказ был оплачен с использованием депозитного кредита, и ~~депозит~~ баланс ушел в минус даже на 1 руб., то будет ''<Remarks>Credit</Remarks>''.

Элемент ''<TotalFare>'' возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.

Элемент ''<CreateDate>'' в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.

Блок ''<Returns>'' и ''<Exchanges>'' содержит данные по заявкам на обмен и/или возврат, которые привязаны к заказу. В выгрузку попадает информация только о выполненных заявках на обмен и/или возврат. Важно учесть, что сумма к возврату по заявке указана со знаком ''«-»'', а сумма к доплате идет без дополнительных знаков.

Формат поддерживает возможность передачи нескольких номеров электронных билетов на одного пассажира (в том числе войдированных и аннулированных).

Если требуется выгружать EMD на услуги а/к, необходимо использовать в работе Формат JSON.

</div>

==== Формат Nemo для составных броней (MultiOW) ====

<PNR>

<Title>Testpay</Title>

<Method>Testpay</Method>

<PaymentGateway>testpay</PaymentGateway>

<Status>ticket</Status>

</PaymentCharge>

</Charge>

</AgentCharge>

</BaseFare>

<Book>

</Book>

</Penalty>

<Total>

</Total>

</Commission>

</AirlineCommission>

</PaidValue>

</Payment>

</ChildBookIDs>

<Type>ServicePack</Type>

<Price>

</Price>

</ExtService>

<Type>AlphaInsurance</Type>

<Price>

</Price>

<Fio>BAGGINS BILBO</Fio>

</Insurance>

<Fio>IVANOV SEMEN</Fio>

</Insurance>

</Insurance>

</Insurances>

</ExtService>

</ExtServices>

</ParentBook>

<Type>FLIGHTS</Type>

<Service>AMADEUS</Service>

<Locator>LOYYRD</Locator>

</TotalPrice>

<UserStatus>Пользователь</UserStatus>

</Common>

<Status>ticket</Status>

</PaymentCharge>

</Charge>

</AgentCharge>

</BaseFare>

<Book>

</Book>

</Penalty>

<Total>

</Total>

</Commission>

</AirlineCommission>

</PaidValue>

</Payment>

<Email>qddednbavfta@dropmail.me</Email>

</Client>

<name>BILBO</name>

<lastname>BAGGINS</lastname>

<passenger_type>CLD</passenger_type>

<doc_type>P</doc_type>

<date_of_birth>02.01.2015</date_of_birth>

<passport_number>985478569</passport_number>

<currency_of_passport>28.05.2023</currency_of_passport>

<Seg/>

</Tickets>

</BaseFare>

</TotalFare>

</Commission>

</AirlineCommission>

</PriceInfo>

</Passenger>

<name>SEMEN</name>

<lastname>IVANOV</lastname>

<passenger_type>ADT</passenger_type>

<doc_type>P</doc_type>

<date_of_birth>05.05.1945</date_of_birth>

<passport_number>954563562</passport_number>

<currency_of_passport>25.03.2021</currency_of_passport>

<phone>

</phone>

<email>QDDEDNBAVFTA@DROPMAIL.ME</email>

<Seg/>

</Tickets>

</BaseFare>

</TotalFare>

</Commission>

</AirlineCommission>

</PriceInfo>

</Passenger>

<passenger_type>INF</passenger_type>

<doc_type>P</doc_type>

<date_of_birth>08.09.2017</date_of_birth>

<passport_number>859654125</passport_number>

<currency_of_passport>28.05.2023</currency_of_passport>

<Seg/>

</Tickets>

</BaseFare>

</TotalFare>

</Commission>

</AirlineCommission>

</PriceInfo>

</Passenger>

</Passengers>

<FlightType>Внутренний</FlightType>

<Info>

<Company>Аэрофлот</Company>

<StartDayOfWeek>Saturday</StartDayOfWeek>

<StartAirportName>Шереметьево, Москва</StartAirportName>

<StartCountry>Россия</StartCountry>

<EndAirportName>Екатеринбург</EndAirportName>

<EndCountry>Россия</EndCountry>

<Equip>

<Name>Airbus A320 (with Sharklets)</Name>

</Equip>

<ClassType>economy</ClassType>

<Meal/>

</Info>

</OrderInfo>

</PNR>

</syntaxhighlight>

<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Данные в блоке ParentBook одинаковы для обеих реальных броней, являющихся частью составной. Но так как составная бронь несёт формальный характер, она не может быть отражена в XML-выгрузке</span>

*ParentBook - общий блок, отражает информацию об оплате составной брони; о дополнительных услугах, приобретённых в составной брони; а также номера обоих реальных заказов составной брони.

</div>

<?xml version="1.0" encoding="UTF-8"?>

<order_snapshot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<air_ticket_prod psg_type="A" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="0" taxes="3005" fare="0" service_fee="356.5" commission="30" origin="SVX" destination="MOW"> <air_seg segment_id="0" carrier="NN" flight_number="200" op_carrier="NN" departure_datetime="2018-03-22 06:00:00" arrival_datetime="2018-03-22 09:00:00" departure_airport="SVX" arrival_airport="DME" fare_basis="YCH"> <air_tax amount="2085" code="YQ"/> <air_tax amount="70" code="RU"/> <air_tax amount="850" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod> </product> <product> <air_ticket_prod psg_type="A" title="Екатеринбург - Москва - ~~Ленинград~~Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="1" taxes="~~1776~~698" fare="~~400~~6100" ~~crs_taxes~~service_fee="63356.495" ~~crs_fare~~commission="~~107~~30" origin="SVX" destination="MOW"> <air_seg segment_id="1" carrier="U6" flight_number="161" op_carrier="U6" departure_datetime="2018-03-24 11:20:00" arrival_datetime="2018-03-24 15:30:00" departure_airport="DME" arrival_airport="SVX" fare_basis="KPROW"> <air_tax amount="185" code="ZZ"/> <air_tax amount="513" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod> </product> <product> <air_ticket_prod psg_type="A" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="2" taxes="500" fare="" service_fee="~~100~~0" commission="0" origin="SVX" destination="MOW"/> </product> <product> <air_ticket_prod psg_type="A" title="Екатеринбург - Москва - Екатеринбург" form_owner="SUNN" validating_carrier="SUNN" prod_id="3" taxes="3005" fare="0" service_fee="356.5" commission="30" origin="SVX" destination="~~LED~~MOW" ~~comission~~> <air_seg segment_id="0" carrier="NN" flight_number="200" op_carrier="NN" departure_datetime="2018-03-22 06:00:00" arrival_datetime="2018-03-22 09:00:00" departure_airport="SVX" arrival_airport="DME" fare_basis="YCH"> <air_tax amount="2085" code="YQ"/> <air_tax amount="70" code="RU"/> <air_tax amount="850" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod> </product> <product> <air_ticket_prod psg_type="A" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="4" ~~stamp~~taxes="698" fare="6100" service_fee="356.5" commission="30" origin="SVX" destination="MOW"> <air_seg segment_id="1" carrier="U6" flight_number="161" op_carrier="U6" departure_datetime="2018-03-24 11:20:00" arrival_datetime="2018-03-24 15:30:00" departure_airport="DME" arrival_airport="SVX" fare_basis="KPROW"> <air_tax amount="185" code="ZZ"/> <air_tax amount="513" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod> </product> <product> <air_ticket_prod psg_type="A" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="5" taxes="500" fare="" service_fee="0" commission="0" origin="SVX" destination="MOW"/> </product> <product> <air_ticket_prod psg_type="C" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="6" taxes="3005" fare="0" service_fee="356.5" commission="30" origin="SVX" destination="~~92354802~~MOW"> <air_seg segment_id="0" carrier="SUNN" flight_number="~~6128~~200" op_carrier="FVNN" departure_datetime="~~2015~~2018-0103-~~16 10~~22 06:4500:00" arrival_datetime="~~2015~~2018-0103-~~16 12~~22 09:1500:00" departure_airport="~~VKO~~SVX" arrival_airport="~~LED~~DME" fare_basis="~~RPROWRF~~YCH/CN0"> <air_tax amount="2085" code="YQ"/> <air_tax amount="70" code="RU"/> <air_tax amount="850" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees>

</air_ticket_prod>

</product>

<~~ral_ticket_prod rsrv_id~~air_ticket_prod psg_type="~~2496500~~C" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="~~200~~7" taxes="698" fare="4575" service_fee="356.5" commission="30" origin="~~Киевский вокзал~~SVX" destination="~~Внуково, Москва~~MOW"> <air_seg segment_id="1" carrier="U6" flight_number="161" op_carrier="U6" departure_datetime="~~2015~~2018-0103-~~16 06~~24 11:4520:00" ~~cartype~~arrival_datetime="~~standart~~2018-03-24 15:30:00" departure_airport="DME" arrival_airport="SVX" fare_basis="KPROW/CH25"> <air_tax amount="185" code="ZZ"/> <air_tax amount="513" code=" ~~fare~~RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="~~360~~7.5"/> </fees> </air_ticket_prod>

</product>

<~~service_prod price~~air_ticket_prod psg_type="~~200~~C" ~~main_ticket_prod_id~~title="~~200~~Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="~~400~~8" ~~psgr_id~~taxes="250" fare="" service_fee="0" ~~offer_type~~commission="0" origin="SVX" destination="~~Cервисные пакеты~~MOW"/>

</product>

<~~service_prod~~ air_ticket_prod psg_type="I" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="~~300~~9" ~~provider_type~~taxes="~~INSURANCE~~3005" ~~provider_id~~fare="~~AlphaInsurance~~0" ~~offer_type~~service_fee="~~Альфа страхование~~356.5" ~~ext_id~~commission="~~Z694.198TEST.2774397~~30" ~~price~~origin="~~100~~SVX" ~~count~~destination="1MOW" ~~psgr_id~~> <air_seg segment_id="0"carrier="NN" flight_number="200" op_carrier="NN" departure_datetime="2018-03-22 06:00:00" arrival_datetime="2018-03-22 09:00:00" departure_airport="SVX" arrival_airport="DME" fare_basis="YCH/IN0"> <air_tax amount="2085" code="YQ"/> <air_tax amount="70" code="RU"/> <air_tax amount="850" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod>

</product>

<air_ticket_prod psg_type="I" title="Екатеринбург - Москва - Екатеринбург" form_owner="NN" validating_carrier="NN" prod_id="10" taxes="513" fare="0" service_fee="356.5" commission="30" origin="SVX" destination="MOW"> <air_seg segment_id="1" carrier="U6" flight_number="161" op_carrier="U6" departure_datetime="2018-03-24 11:20:00" arrival_datetime="2018-03-24 15:30:00" departure_airport="DME" arrival_airport="SVX" fare_basis="KPROW/IN00"> <air_tax amount="513" code="RI"/> </air_seg> <fees> <fee type="commission" code="commission_vcarrier" amount="7.5"/> </fees> </air_ticket_prod> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200200" origin="Домодедово, Москва" destination="Павелецкий вокзал" departure_datetime="2018-03-22 10:00:00" cartype="standart" fare="420"/> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200201" origin="Домодедово, Москва" destination="Павелецкий вокзал" departure_datetime="2018-03-22 10:00:00" cartype="standart" fare="420"/> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200202" origin="Домодедово, Москва" destination="Павелецкий вокзал" departure_datetime="2018-03-22 10:00:00" cartype="standart" fare="420"/> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200203" origin="Павелецкий вокзал" destination="Домодедово, Москва" departure_datetime="2018-03-24 07:20:00" cartype="standart" fare="420"/> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200204" origin="Павелецкий вокзал" destination="Домодедово, Москва" departure_datetime="2018-03-24 07:20:00" cartype="standart" fare="420"/> </product> <product> <ral_ticket_prod rsrv_id="4965710200" prod_id="4965710200205" origin="Павелецкий вокзал" destination="Домодедово, Москва" departure_datetime="2018-03-24 07:20:00" cartype="standart" fare="420"/> </product> <product> <payment_prod price="~~123~~150"/>

</product>

</products>

</reservations>

</passengers>

<travel_docs>

<travel_doc>

<air_ticket_doc tkt_oper="TKT" tkt_number="~~5555871998698~~8236100037848" tkt_date="~~2015~~2018-01-~~13 12~~24 16:23:26" prod_id="0" psgr_id="0" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="2626100037849" tkt_date="2018-01-24 16:23:26" prod_id="1" psgr_id="0" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="99C6160149267" tkt_date="2018-01-24 16:23:26" prod_id="2" psgr_id="0" issuingAgent="2615" rsrv_id="496571" main_prod_id="1" rfic="D"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="8236100037850" tkt_date="2018-01-24 16:23:26" prod_id="3" psgr_id="1" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="2626100037851" tkt_date="2018-01-24 16:23:26" prod_id="4" psgr_id="1" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="99C6160149268" tkt_date="2018-01-24 16:23:26" prod_id="5" psgr_id="1" issuingAgent="2615" rsrv_id="496571" main_prod_id="4" rfic="D"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="8236100037852" tkt_date="2018-01-24 16:23:26" prod_id="6" psgr_id="2" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="2626100037853" tkt_date="2018-01-24 16:23:26" prod_id="7" psgr_id="2" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="99C6160149269" tkt_date="2018-01-24 16:23:26" prod_id="8" psgr_id="2" issuingAgent="2615" rsrv_id="496571" main_prod_id="7" rfic="D"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="8236100037854" tkt_date="2018-01-24 16:23:26" prod_id="9" psgr_id="3" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <air_ticket_doc tkt_oper="TKT" tkt_number="2626100037855" tkt_date="2018-01-24 16:23:26" prod_id="10" psgr_id="3" issuingAgent="2615" rsrv_id="496571"/> </travel_doc> <travel_doc> <aex_doc rsrv_id="4965710200" prod_id="4965710200200" psgr_id="0" tkt_oper="TKT" tkt_date="2018-01-24 16:23:44" tkt_number="427309"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="23K6160148822" tkt_date="16:23 24.01.2018" prod_id="4965710200200" psgr_id="0" issuingAgent="2615" rsrv_id="4965710200"/> </travel_doc> <travel_doc> <aex_doc rsrv_id="4965710200" prod_id="4965710200201" psgr_id="1" tkt_oper="TKT" tkt_date="2018-01-24 16:23:44" tkt_number="427310"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="23K6160148823" tkt_date="16:5023 24.01.2018" prod_id="4965710200201" psgr_id="1" issuingAgent="2615" rsrv_id="4965710200"/> </travel_doc> <travel_doc> <aex_doc rsrv_id="4965710200" prod_id="4965710200202" psgr_id="2" tkt_oper="TKT" tkt_date="2018-01-24 16:23:44" tkt_number="427311"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="23K6160148824" tkt_date="16:23 24.01.2018" prod_id="4965710200202" psgr_id="2" issuingAgent="2615" rsrv_id="4965710200"/> </travel_doc> <travel_doc> <aex_doc rsrv_id="4965710200" prod_id="4965710200203" psgr_id="0" tkt_oper="TKT" tkt_date="2018-01-24 16:23:44" tkt_number="427312"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="23K6160148826" tkt_date="16:23 24.01.2018" prod_id="4965710200203" psgr_id="0" issuingAgent="~~2807~~2615" rsrv_id="4965710200"/> </travel_doc> <travel_doc> <aex_doc rsrv_id="4965710200" prod_id="4965710200204" psgr_id="1" tkt_oper="TKT" tkt_date="2018-01-24 16:23:44" tkt_number="427313"/>

</travel_doc>

<travel_doc>

<~~aex_doc rsrv_id~~emd_ticket_doc tkt_oper="TKT" tkt_number="~~2496500~~23K6160148825" ~~prod_id~~tkt_date="~~200~~16:23 24.01.2018" ~~psgr_id~~prod_id="04965710200204" ~~tkt_oper~~psgr_id="~~TKT~~1" ~~tkt_date~~issuingAgent="~~2015-01-13 12:10:54~~2615" ~~tkt_number~~rsrv_id="~~394612~~4965710200"/>

</travel_doc>

<travel_doc>

<~~insur_doc main_prod_id~~aex_doc rsrv_id="04965710200" prod_id="~~300~~4965710200205" psgr_id="02" tkt_oper="TKT" tkt_date="~~2015~~2018-01-~~13 12~~24 16:1023:5444" tkt_number="~~Z694~~427314"/> </travel_doc> <travel_doc> <emd_ticket_doc tkt_oper="TKT" tkt_number="23K6160148827" tkt_date="16:23 24.~~198TEST~~01.~~2774397~~2018" prod_id="4965710200205" psgr_id="2" issuingAgent="2615" rsrv_id="4965710200"/>

</travel_doc>

</travel_docs>

</payments>

</order_snapshot>

</syntaxhighlight>

<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.</span>*bonus_card - номер бонусной карты, введённой покупателем билета в числовом формате.*service_fee — сбор агентский (только сервисный сбор, '''не включает''' в себя сбор за эквайринг), отображается только на первом билете (отдельно для каждого пассажира).

*comission - комиссия АК

*stamp - код Валидатора в ~~ПСС~~PCC, берется из настроек ~~Немо~~{{NameSystem}}, если в настройках он не указан, то не передается.*ord_id — идентификатор заказа в ~~НЕМО~~{{NameSystem}}

*corp_ord_id — PNR из ГДС

*site — идентификатор агентства в ~~Немо~~{{NameSystem}}*payment pay_id — номер биллинга ~~Немо.~~{{NameSystem}}

*pay_system — код платежной системы

**SB — для сбербанка

**ES — для Рапиды

**UNT — для Юнителлера

*psp_name — отображает название платежного шлюза, для ПШ МПС возможно значения:

**"Sirena2_card" - Оплата картой,

**"Sirena2_qr_code" - Оплата по QR,

**"Sirena2_client_bank" - Оплата по СберПей

**Uniteller — оплата Юнителлер (банк)

**Uniteller_GDS — оплата через GDS-процессинг (Юнителлер)

*cardholder — держатель карты.

*expire_date — срок действия карты, у тех ПШ, что не приходит в ответе — пустой.

*offer_type - название полиса;

*price - цена полиса для пассажира;

*rsrv_id - идентификатор заказа;

*rloc - номер заказа у поставщика;

*currency - основная валюта сайта (валюта расчетов, валюта оплаты);

*crs_currency - валюта расчетов с поставщиком (c ГДС);

*crs_currency_rate - курс валюты поставщика;

*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>

==== Формат JSON ====

см. http://docs.nemo.travel/ru/nemo-backoffice-api/json_api/order_export

</div>

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

Для компонента '''«Отели»''' доступна выгрузка заказов в ~~формате~~ форматах Nemoи/или JSON.

==== Формат ~~Nemo~~ JSON ====

~~<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>263462</id>~~ ~~<Type>HOTELS</Type>~~ ~~<Service>ACADEM</Service>~~ ~~<Locator>3028655</Locator>~~ ~~<BeginDateTime>2014.04.15-00:00</BeginDateTime>~~ ~~<EndDateTime>2014.04.16-00:00</EndDateTime>~~ ~~<TotalPrice>~~ ~~<Amount>1950</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</TotalPrice>~~ ~~<UserId>123</UserId>~~ ~~<EEUserId />~~ ~~<UserLogin>userLogin</UserLogin>~~ ~~<GroupId>332</GroupId>~~ ~~<UserStatus>Менеджер</UserStatus>~~ ~~<DateCreate>2014.03.21-16:11</DateCreate>~~ ~~</Common>~~ ~~<Payment>~~ ~~<Status>booked</Status>~~ ~~<PenaltyDate>2014.04.13-00:00</PenaltyDate>~~ ~~<Timelimit>2014-04-13 00:00:00</Timelimit>~~ ~~<Charge>~~ ~~<Amount>0</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Charge>~~ ~~<Book>~~ ~~<Amount>1950</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Book>~~ ~~<Penalty>~~ ~~<Amount>0</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Penalty>~~ ~~<Total>~~ ~~<Amount>1950</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Total>~~ ~~<Commission>~~ ~~<Amount>112</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Commission>~~ ~~<PaidValue>~~ ~~<Amount>0</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</PaidValue>~~ ~~</Payment>~~ ~~<Client>~~ ~~<LastName>Сидоров</LastName>~~ ~~<Name>Владимир</Name>~~ ~~<MiddleName>Константинович</MiddleName>~~ ~~<Number>1806326598</Number>~~ ~~<Birth>1987-05-20</Birth>~~ ~~<Email>mail@host~~см.~~com</Email>~~ ~~<Phone>+79871234567</Phone>~~ ~~</Client>~~ ~~<Passengers>~~ ~~<Passenger>~~ ~~<nationality>RU</nationality>~~ ~~<lastname>IVANOV</lastname>~~ ~~<name>IVAN</name>~~ ~~</Passenger>~~ ~~</Passengers>~~ ~~<Info>~~ ~~<Name>Интурист</Name>~~ ~~<City>~~ ~~<Code>34</Code>~~ ~~<Name>Великий Новгород</Name>~~ ~~</City>~~ ~~<Location />~~ ~~<StarRating>3</StarRating>~~ ~~<Days>2</Days>~~ ~~<Nights>1</Nights>~~ ~~<CheckInDate>2014.04.15</CheckInDate>~~ ~~<CheckOutDate>2014.04.16</CheckOutDate>~~ ~~<CheckInTime>14~~https:~~00<~~/~~CheckInTime>~~ ~~<CheckOutTime>12:00<~~/~~CheckOutTime>~~ ~~<OnRequest>false</OnRequest>~~ ~~</Info>~~ ~~<Rooms>~~ ~~<Room>~~ ~~<Name>Двухместный стандарт (две кровати)</Name>~~ ~~<Type>SNGL</Type>~~ ~~<FareId>1</FareId>~~ ~~</Room>~~ ~~</Rooms>~~ ~~<Fares>~~ ~~<Fare>~~ ~~<Id>1</Id>~~ ~~<Price>~~ ~~<Amount>1950</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Price>~~ ~~<Meals>Завтрак "Шведский стол",Отсутствует</Meals>~~ ~~<Description>Одноместный</Description>~~ ~~</Fare>~~ ~~</Fares>~~ ~~<CancelCharges>~~ ~~<Charge>~~ ~~<DateFrom>2014.04~~docs.~~13-00:00</DateFrom>~~ ~~<DateTo>2014~~nemo.~~04.15-00:00</DateTo>~~ ~~<Amount>1488</Amount>~~ ~~<CurrencyCode>RUB</CurrencyCode>~~ ~~</Charge>~~ ~~</CancelCharges>~~ ~~<ModifyCharges />~~ ~~<ModificationMethods>~~ ~~<Method>MOD_PASS_NAMES</Method>~~ ~~<Method>MOD_DATES</Method>~~ <travel/~~ModificationMethods>~~<ru/~~PNR>~~<hotels/~~syntaxhighlight>~~hotelsbackoffice

</div>

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

Для компонента '''«ЖД»''' доступна выгрузка заказов в ~~формате~~ форматах Nemoи/или JSON.

|-

| id

| Номер заказа в ~~Немо~~{{NameSystem}}.

| Число. Пример: 268281.

|-

| UserId

| Идентификатор пользователя в системе ~~Немо~~{{NameSystem}}, оформившего заказ.

| Число. Пример: 123.

|-

| UserLogin

| Логин пользователя в системе ~~Немо~~{{NameSystem}}, оформившего заказ.

| Строка. Пример: userLogin.

|-

| GroupId

| Идентификатор группы пользователя в системе ~~Немо~~{{NameSystem}}, оформившего заказ.

| Число. Пример: 122.

|-

| UserStatus

| Тип пользователя в системе ~~Немо~~{{NameSystem}}.

| Строка. Пример: Менеджер.

|-

| BillingId

| Идентификатор транзакции ~~Немо~~{{NameSystem}}.

| Строка. Пример: 117603370.

|-

| Date

| Дата и время оплаты платежной транзакции ~~Немо~~{{NameSystem}}.

| Строка. Пример: 2014-04-24 15:10:12.

|-

| CreateDate

| Дата и время создания платежной транзакции ~~Немо~~{{NameSystem}}.

| Строка. Пример: 2014-06-06 15:10:00.

|-

| Status

| Статус заказа в системе ~~Немо~~{{NameSystem}}.

| Строка. Пример: booked.<br/>Допустимые значения:

<ul>

<sup>*</sup> — Если диапазон не был зада пользователем на этапе выбора мест, то поля start и end будут содержать нули.

</div>

==== Формат JSON ====

см. http://docs.nemo.travel/ru/nemo-backoffice-api/json_api/order_export

</div>

== Пакетный экспорт заказов в формате Nemo==

Сервис выгрузки заказов позволяет экспортировать ~~интересующие~~ необходимые выборки по заказам в формате XML, XLS~~, XLSX~~(X). Например, можно выбрать ~~все~~ заказы по дате бронирования и получить информацию по ним в ~~выбранном~~ нужном формате. ~~Необходимо учесть~~Экспорт в формате XLS(X) единовременно выгружает не более 1000 заказов. Если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), ~~что выгрузка~~ то нужно выгружать заказы за последовательные периоды. При выгрузке данных по заказам в формате XLS~~/XLSX имеет ограничение~~ (X) ценовые параметры конвертируются в валюту агентства по курсам, зафиксированным на ~~1000 заказов~~момент оплаты конкретного заказа. Панель выгрузки всегда доступна для менеджеров и экспертов.

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

[[Файл:exportxmlxlsxlsx.jpg|600px|thumb|right|Фильтры пакетного экспорта заказов в личном кабинете]]

~~Кликнув по ссылке~~ Псевдоссылка ''Показать панель экспорта'' ~~раскрывается форма~~ раскрывает форму, позволяющую экспортировать заказы в файл формат XML, XLS или XLSX. Выгружаются заказы выбранного пользователя/компании и принадлежащих к ним субагентов/пользователей с ~~вариантами выгрузки~~учетом примененных параметров фильтра. ~~Панель~~ Запрос на выгрузку данных по заказам отобразится в системе логирования с XML файлом, содержащим данные выгрузки ~~всегда доступна для менеджеров и экспертов~~.

~~Выгружаются только~~ Для экспорта отложенных заказов в формате XLS(X) нужно в фильтрах заказов установить параметр «Статус бронирования» в значение «Отложен». В данный момент установлен лимит на количество выгружаемых единовременно заказов, равный 1000. В случае, если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), это возможно сделать, выгружая заказы ~~выбранного пользователя/компании с учетом примененных параметров фильтра~~за определенные периоды. ==== Параметры пакетной выгрузки ==== {| class="wikitable mw-collapsible mw-uncollapsed"|-! scope="col" | Параметр! scope="col" | XLS - выгрузка! scope="col" | XML -выгрузка|-| Номер билета| нет| Passengers->Passenger->Tickets->Ticket->Num|-|Маршрут| service_summary| OrderInfo|-| Дата выписки| ticketing_date| Common->TicketingDateTime|-| Дата вылета| date_begin| OrderInfo->Info->StartDate,StartTime|-|Тариф в валюте сайта (по каждому билету)|только суммарно за всех пассажиров| нет|-|Таксы в валюте сайта (по каждому билету)|только суммарно за всех пассажиров| нет|-|Тариф в валюте выписки (по каждому билету)|нет |нет|-| фамилия пассажира (по каждому билету)| нет| Passengers->Passenger->lastname|-|}

~~Пользователь может произвести выгрузку только своих~~ === Повторная выгрузка заказов===Если выгрузка заказа прошла неуспешно, в системе предусмотрена возможность выгрузить его повторно. Для этого менеджеру агентства необходимо на странице проблемного заказа перейти в раздел «Служебная информация», где расположена ссылка «Выгрузить заказ повторно», после нажатия на которую заказ будет выгружен повторно.

~~Запрос на выгрузку данных по заказам~~Причем в случае, если в разделе настроек '''Настройки системы → Интеграция → Выгрузка заказов''' включена настройка '''Выгрузка одновременно и Nemo и Софи''', повторная выгрузка будет ~~отображен~~ выполнена и в ~~системе логирования~~формате Nemo, ~~с XML файлом содержащим данные выгрузки~~и в формате СОФИ.

Также, доступна повторная выгрузка заказов через Личный кабинет. Для этого разделе «Заказы», для нужного заказа в колонке «Действия» требуется нажать на ссылку «Выгрузить заказ повторно».

<!-- Выпилино по тикету 13622 (МР)

<!--

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

В ~~Nemo~~ {{NameSystem}} существует возможность получить выборку заказов под неавторизованным пользователем («гостем»). Для этого необходимо выполнить запрос вида: <syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0; width: 800px;">

http://DOMAIN/index.php?go=export_xml_key/search&параметры экспорта&xmlKey=ХХХ

</syntaxhighlight>

Выгрузка конкретного заказа:

http://DOMAIN/booking__sofi_export_bookings&booking_id=123456

где booking_id — номер заказа в системе ~~Немо~~{{NameSystem}}.

Выгрузка заказов забронированных за определенный период:

Выгрузка конкретного заказа:

http://DOMAIN/booking__sofi_export_bookings&booking_id=123456

где booking_id — номер заказа в системе ~~Немо~~{{NameSystem}}.

Выгрузка заказов забронированных за определенный период:

Денис Якименко

232

правки

Изменения

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

Навигация

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

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

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты