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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Настройки)
Строка 6: Строка 6:
 
== Описание ==
 
== Описание ==
 
Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.
 
Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.
 +
 +
=== Процесс выгрузки ===
 +
Схематично процесс выгрузки заказов представлен на блок-схеме.
 +
 +
[[Файл:Export.png]]
 +
 +
== Настройки ==
 +
На странице настроек выгрузки заказов доступны следующие опции:
 +
* '''Выгрузка одновременно и Nemo, и Софи''' — настройка позволяет производить экспорт данных одновременно в двух форматах. <br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Опция доступна только для компонента '''«Авиабилеты»''', при включенном модуле '''«Выгрузка заказов Софи».</span>
 +
* '''Тип выгрузки''' — настройка определяет один из доступных форматов выгрузки заказов:
 +
** '''''Выгрузка заказов Nemo''''' — внутренний формат системы Nemo, доступен по умолчанию.
 +
** '''''Выгрузка заказов Софи''''' — дополнительный формат, становится доступным при включении модуля '''«Выгрузка заказов Софи»'''.
 +
* '''Url стороннего скрипта для XML уведомлений''' — URL, на который будет производиться выгрузка данных.
 +
* '''Код сайта в системе Софи'''<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.</span>
 +
* '''Отправлять нотификацию о необходимости установки кода валидатора в реквизитах''' — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
 +
* '''E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах'''
  
 
== Форматы выгрузки заказов ==
 
== Форматы выгрузки заказов ==
Строка 62: Строка 81:
 
&#42;&#42; Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.
 
&#42;&#42; Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.
  
== Процесс выгрузки ==
+
=== Выгрузка заказа для компонента «Авиабилеты» ===
Схематично процесс выгрузки заказов представлен на блок-схеме.
+
Для компонента '''«Авиабилеты»''' доступна выгрузка заказов в форматах Nemo и/или Софи (при включенном модуле '''«Выгрузка заказов Софи»).  
 
 
[[Файл:Export.png]]
 
  
== Настройки ==
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
На странице настроек выгрузки заказов доступны следующие опции:
+
==== Формат Nemo ====
* '''Выгрузка одновременно и Nemo, и Софи''' — настройка позволяет производить экспорт данных одновременно в двух форматах. <br/>
 
<span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Опция доступна только для компонента '''«Авиабилеты»''', при включенном модуле '''«Выгрузка заказов Софи».</span>
 
* '''Тип выгрузки''' — настройка определяет один из доступных форматов выгрузки заказов:
 
** '''''Выгрузка заказов Nemo''''' — внутренний формат системы Nemo, доступен по умолчанию.
 
** '''''Выгрузка заказов Софи''''' — дополнительный формат, становится доступным при включении модуля '''«Выгрузка заказов Софи»'''.
 
* '''Url стороннего скрипта для XML уведомлений''' — URL, на который будет производиться выгрузка данных.
 
* '''Код сайта в системе Софи''' —
 
* '''Повторная отправка в случае неудачи''' — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
 
* '''Список адресов для уведомлений (разделяется запятыми)''' — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
 
* '''Экспортировать после оплаты''' — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа.<br/>
 
<span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Доступно только для формата Nemo.</span>
 
* '''Отправлять нотификацию о необходимости установки кода валидатора в реквизитах''' — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
 
* '''E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах'''
 
 
 
== Выгрузка заказов для компонента «Авиабилеты» ==
 
Для компонента '''«Авиабилеты»''' и '''"Отели"''' доступна выгрузка заказов в форматах Софи и/или Nemo.
 
На странице есть возможность активировать опцию '''«Повторная отправка в случае неудачи»'''.
 
 
 
*Выгрузка в формате Софи производится при выписке и войдировании билета. При включенном модуле '''«Выгрузка заказов в Софи»''' агентству становятся доступны настройки экспорта на странице '''«Заказы» - «Выгрузка заказов»'''.
 
 
 
*Выгрузка данных заказов в формате XML (Nemo). В системе Nemo существует возможность выгрузки данных о заказе при совершении ряда действий. Данные выгружаются по адресу скрипта, указанного в поле «Url стороннего скрипта для XML уведомлений».
 
 
 
* Выгрузка одновременно и Nemo, и Софи - позволяет настроить систему так, чтобы заказы выгружались одновременно в обоих форматах. <span style="font-size: large;"><span style="color: rgb(255, 0, 0);">!</span></span><span style="background-color: rgb(255, 240, 245);">&nbsp;Обратите внимание на необходимость заполнения полей '''"Url стороннего скрипта для XML уведомлений"''' и '''"Код сайта в системе Софи"''', которые становятся доступными только при переключении '''"Типа выгрузки"''' в значение '''"Выгрузка заказов Софи"''', а также поля '''"Url стороннего скрипта для XML уведомлений"''' для типа выгрузки '''"Nemo"'''.</span>
 
<!--
 
Если в настройке '''«Повторная отправка в случае неудачи»''' выбрано значение «''Да''», то  при наличии в планировщике задач Cron (с помощью которого  выполняются  запросы на совершение заданного действия)  задачи /?go=cron/send_booking,  будут происходить попытки экспортировать бронь повторно через определенный интервал равный интервалу, указанному в конфигурации крон-задания.
 
 
 
Лог отправки броней можно получить по адресу:
 
http://domain.com/logs/export_resend.log
 
 
 
Логи хранятся в таблице базы данных, которая называется cron_export_resend. 
 
 
 
Если же три попытки подряд  закончатся неудачно, то на адреса, указанные в поле '''«Список адресов для уведомлений (разделяется запятыми)»''',  будет отправлено уведомление о проблемном заказе.
 
 
 
Если в настройке '''«Повторная отправка в случае неудачи»''' выбрано значение «''Нет''», то после неудачного экспорта повторной попытки и уведомления не будет.
 
-->
 
 
 
== Выгрузка в формате Nemo ==
 
 
 
Действия, при которых происходит выгрузка в формате Nemo:
 
*бронирование;
 
*аннуляция;
 
*синхронизация (если в заказе произошли изменения);
 
*выписка;
 
*войдирование;
 
*оплата (если включена настройка "Экспортировать после оплаты" в "Заказы" - "Выгрузка заказов").
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
 
<u>Пример файла, формируемого при выгрузке</u>
 
 
<div class="mw-collapsible-content">
 
<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;">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
Строка 259: Строка 228:
 
</PNRS>
 
</PNRS>
 
</syntaxhighlight>
 
</syntaxhighlight>
</div>
 
</div>
 
  
 
Ремарка ''<Remarks>Debit</Remarks>'' является не обязательной, означает что заказ был оплачен с помощью способа оплаты "Депозит";
 
Ремарка ''<Remarks>Debit</Remarks>'' является не обязательной, означает что заказ был оплачен с помощью способа оплаты "Депозит";
Строка 268: Строка 235:
  
 
Элемент ''<CreateDate>'' в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.
 
Элемент ''<CreateDate>'' в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.
 +
</div>
 +
</div>
  
 
== См. также ==
 
== См. также ==

Версия 14:58, 21 марта 2014

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

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

Описание

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

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

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

Export.png

Настройки

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

  • Выгрузка одновременно и Nemo, и Софи — настройка позволяет производить экспорт данных одновременно в двух форматах.
    Внимание! Опция доступна только для компонента «Авиабилеты», при включенном модуле «Выгрузка заказов Софи».
  • Тип выгрузки — настройка определяет один из доступных форматов выгрузки заказов:
    • Выгрузка заказов Nemo — внутренний формат системы Nemo, доступен по умолчанию.
    • Выгрузка заказов Софи — дополнительный формат, становится доступным при включении модуля «Выгрузка заказов Софи».
  • Url стороннего скрипта для XML уведомлений — URL, на который будет производиться выгрузка данных.
  • Код сайта в системе Софи
    Внимание! Необходимо заполнить поля "Url стороннего скрипта для XML уведомлений" и "Код сайта в системе Софи", которые становятся доступными только при переключении "Типа выгрузки" в значение "Выгрузка заказов Софи", а также поле "Url стороннего скрипта для XML уведомлений" для типа выгрузки "Nemo".
  • Повторная отправка в случае неудачи — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
  • Список адресов для уведомлений (разделяется запятыми) — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
  • Экспортировать после оплаты — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа.
    Внимание! Доступно только для формата Nemo.
  • Отправлять нотификацию о необходимости установки кода валидатора в реквизитах — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
  • E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах

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

Система поддерживает выгрузку заказов в форматах Nemo и Софи.

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

Авиабилеты Отели ЖД
Формат Nemo + + +
Формат Софи +

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

Бронирование Оплата* Синхронизация** Выписка Войдирование Аннуляция
Формат Nemo + + + + + +
Формат Софи + + +

*  Выгрузка заказа при оплате произойдет только если включена настройка «Экспортировать после оплаты» в разделе «Заказы»«Выгрузка заказов».
** Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.

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

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

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8" ?> 
  2 <PNRS>
  3    <PNR>
  4       <Common>
  5          <id>261722</id>
  6          <Type>FLIGHTS</Type>
  7          <Service>SIRENA2000</Service>
  8          <Locator>0R7FW9</Locator>
  9          <BeginDateTime>2014.03.08-18:05</BeginDateTime>
 10          <EndDateTime>2014.03.08-19:05</EndDateTime>
 11          <TotalPrice>
 12             <Amount>14695</Amount>
 13             <CurrencyCode>RUB</CurrencyCode>
 14          </TotalPrice>
 15          <UserId>524</UserId>
 16          <EEUserId>0</EEUserId>
 17          <UserLogin>mikhalevtur_sub</UserLogin>
 18          <GroupId>523</GroupId>
 19          <UserStatus>Менеджер</UserStatus>
 20          <DateCreate>2014.02.26-15:08</DateCreate>
 21       </Common>
 22       <Payment>
 23          <Title>Deposit</Title>
 24          <Method>Deposit</Method>
 25          <BillingId>117600534</BillingId>
 26          <Date>2014-02-26 15:08:53</Date>
 27          <CreateDate>2014-02-26 15:08:45</CreateDate>
 28          <Status>ticket</Status>
 29          <PenaltyDate />
 30          <Timelimit>2014-02-26 16:08:23</Timelimit>
 31          <Charge>
 32             <Amount>10370</Amount>
 33             <CurrencyCode>RUB</CurrencyCode>
 34          </Charge>
 35          <BaseFare>
 36             <Amount>3500</Amount>
 37             <CurrencyCode>RUB</CurrencyCode>
 38          </BaseFare>
 39          <Book>
 40             <Amount>4325</Amount>
 41             <CurrencyCode>RUB</CurrencyCode>
 42          </Book>
 43          <Penalty>
 44             <Amount>0</Amount>
 45             <CurrencyCode>RUB</CurrencyCode>
 46          </Penalty>
 47          <Total>
 48             <Amount>14695</Amount>
 49             <CurrencyCode>RUB</CurrencyCode>
 50          </Total>
 51          <Commission>
 52             <Amount>0</Amount>
 53             <CurrencyCode>RUB</CurrencyCode>
 54          </Commission>
 55          <PaidValue>
 56             <Amount>14695</Amount>
 57             <CurrencyCode>RUB</CurrencyCode>
 58          </PaidValue>
 59       </Payment>
 60       <Client>
 61          <LastName>Petrov</LastName>
 62          <Name>Petr</Name>
 63          <MiddleName />
 64          <SerialNumber />
 65          <Number />
 66          <Birth />
 67          <Email>petrov@ya.ru</Email>
 68          <Phone>+79999999999</Phone>
 69       </Client>
 70       <PassengersCount>1</PassengersCount>
 71       <Passengers>
 72          <Passenger>
 73             <nationality>RU</nationality>
 74             <lastname>PETROV</lastname>
 75             <name>PETR</name>
 76             <gender>M</gender>
 77             <date_of_birth>01.02.1984</date_of_birth>
 78             <doc_type>P</doc_type>
 79             <passport_number>654789</passport_number>
 80             <passport_series>123</passport_series>
 81             <passenger_type>ADT</passenger_type>
 82             <phone>
 83                <number>79999999999</number>
 84             </phone>
 85             <Tickets>
 86                <Seg>12</Seg>
 87                <Num>4416150733000</Num>
 88                <Date>2014 15:08</Date>
 89             </Tickets>
 90             <PriceInfo>
 91                <BaseFare>
 92                   <Amount>3500</Amount>
 93                   <CurrencyCode>RUB</CurrencyCode>
 94                </BaseFare>
 95                <TotalFare>
 96                   <Amount>4325</Amount>
 97                   <CurrencyCode>RUB</CurrencyCode>
 98                </TotalFare>
 99                <Commission>
100                   <Amount>0</Amount>
101                   <CurrencyCode>RUB</CurrencyCode>
102                </Commission>
103                <AirlineCommission>
104                   <Amount>0</Amount>
105                   <CurrencyCode>RUB</CurrencyCode>
106                </AirlineCommission>
107             </PriceInfo>
108          </Passenger>
109       </Passengers>
110       <FlightType>Внутренний</FlightType>
111       <OrderInfo>
112          <Info>
113             <Company>Ак Барс Аэро</Company>
114             <CompanyCode>2B</CompanyCode>
115             <StartDate>2014.03.08</StartDate>
116             <StartTime>18:05</StartTime>
117             <StartDayOfWeek>Saturday</StartDayOfWeek>
118             <FlightNumber>543 (2B543)</FlightNumber>
119             <StartAirportCode>DME</StartAirportCode>
120             <StartAirportName>Домодедово, Москва</StartAirportName>
121             <StartCountry>Россия</StartCountry>
122             <StartCountryCode>RU</StartCountryCode>
123             <EndAirportCode>KGD</EndAirportCode>
124             <EndAirportName>Калининград</EndAirportName>
125             <EndCountry>Россия</EndCountry>
126             <EndCountryCode>RU</EndCountryCode>
127             <Time>2:0</Time>
128             <Equip>
129                <Name>Bombardier Canadair Regional Jet</Name>
130                <Type>CR2</Type>
131             </Equip>
132             <ClassType>economy</ClassType>
133             <ClassTypeCode>B</ClassTypeCode>
134             <Meal />
135          </Info>
136       </OrderInfo>
137       <Remarks>Debit</Remarks>
138    </PNR>
139 </PNRS>

Ремарка <Remarks>Debit</Remarks> является не обязательной, означает что заказ был оплачен с помощью способа оплаты "Депозит"; если же заказ был оплачен с использованием депозитного кредита, и депозит ушел в минус даже на 1 руб., то будет <Remarks>Credit</Remarks>.

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

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

См. также