Просмотр кода страницы Настройки автовыписки и эквайринга

[[Category:Модули]] [[Category:Функции]][[Категория:Дополнительные модули]]
Разработан модуль '''«Настройка автовыписки и эквайринга»''', предоставляющий возможности гибкого управления оплатой и выпиской авиабилетов.  С его помощью можно легко построить необходимую схему оформления и оплаты авиабилетов, а также отследить заказы, требующие непосредственного участия агента.

Модуль предназначен для работы с компонентом ''«Авиабилеты»''.<br>
<span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span> Модуль «Настройка автовыписки и эквайринга» подключается дополнительно администратором системы {{NameSystem}}.</span>
== Настройки модуля ==
Если сам модуль уже подключен, в панели администрирования становится доступен новый раздел настроек '''«Авиабилеты - Настройка автовыписки и эквайринга»'''. 
[[Файл:settings autoticketing and acquiring.jpg|400px|thumb|right|Настройка автовыписки и эквайринга]]
'''Включить настройки автовыписки и эквайринга''' - при выборе данной опции происходит активация модуля, а все его последующие настройки применяются к оформлению заказа.<br>
'''Источник данных''' - определяет, какие данные анализирует система. В качестве возможных значений принимает '''данные из таблицы правил по автовыписке и эквайрингу''' или '''данные из таблицы правил ценообразования 2.0'''.<br>
При выборе значения '''данные из таблицы правил ценообразования 2.0''', к проверке заказа применяется таблица правил ценообразования 2.0, в столбцах которой добавлены значения ''«запретить автовыписку» и «прямой эквайринг»''. Таблица правил автовыписки и эквайринга не применяется. Если выбрано значение '''данные из таблицы правил по автовыписке и эквайрингу''', то дополнительно запускается проверка по таблице автовыписке и эквайринга, значения столбцов ''«запретить автовыписку» и «прямой эквайринг»'' в таблице ценообразования 2.0 игнорируются.<br>
'''Адрес для отправки нотификаций о необходимости ручной выписки''' - поле для внесения электронного адреса, на который будут поступать уведомления.<br>
'''Время работы правил''' - временной интервал, в течение которого применяется установленный набор правил. Обязательный параметр для работы модуля.<br>
'''Часовой пояс работы правил''' - дополнительный параметр, уточняющий время работы правил по конкретному местоположению.<br>
'''Применять настройки в определенные дни недели''' - суточное распределение работы правил. Обязательный параметр для работы модуля.<br>
'''Применять правила к перелётам, вылет которых через X и более часов относительно момента создания заказа'''.<br>
'''Аннулировать старый заказ при смене локатора PNR''' - опция позволяет снять сегменты старого заказа (с условием, что заказ не выписан) при ручной смене PNR.<br> В случае если на форме фиксации ручного статуса указан PNR, введены номера и выбрано действие '''"Зафиксировать статус"''', то происходит замена PNR локатора и снятие сегментов старого заказа. Если выбрано действие '''"Сохранить и синхронизировать"''',  
то произойдет замена PNR локатора, синхронизация с GDS и снятие сегментов предыдущего заказа.

== Работа автовыписки и эквайринга ==

После создания заказа проводится проверка на совпадение параметров перелета со строками, внесенными в таблицу настроек автовыписки и эквайринга. Если для выбранного перелета подходит несколько правил, приоритетным является последнее. При невозможности применения какого-либо из правил, оплата и выписка заказа проходят по стандартному алгоритму в соответствии с настройками. 

Забронировав заказ, пользователь переходит к оплате. При выборе оплаты картой, система проверяет значения, указанные в столбце ''«прямой эквайринг»''. Если значение равно 1, то оплата проходит по прямому эквайрингу в авиакомпанию, 2 - оплата проходит через банк, значение отсутствует - оплата проходит в соответствии с настройками платежного шлюза. <br>

После успешной оплаты заказа выполняется проверка в столбце ''«запретить автотикетинг»''. При нахождении значения, равном 1, автовыписка запрещена. При этом пользователю выдается сообщение ''Заказ отправлен на ручную выписку агентом'', текст сообщения может редактироваться в локализации (метка "ticketing_must_be_made_manually"). Также пользователю отправляется нотификация об ожидании выписки, настройка шаблона которой возможна в разделе ''«Заказы» → «Шаблоны электронных писем» → «Нотификация об ожидании выписки заказа»''. 

Менеджер агентства получает уведомление о необходимости ручной выписки заказа (если e-mail указан в поле ''Адрес для отправки нотификаций о необходимости ручной выписки''), сам текст сообщения можно задать в шаблоне электронных писем ''«Нотификация о необходимости выписки заказа»''. В уведомление также входит время, до которого нужно обработать заказ.

В случае если значение в столбце ''«запретить автотикетинг»'' равно 0 или пусто, то выписка проходит по стандартному алгоритму в соответствии с настройками. 

{{Attention|Запрет автовыписки не сработает, если оплата выполнена по гдс процессингу или МФОП. <br>
В настройках почты должно быть выбрано [[Маршрут-квитанция|''Автоматическая отправка Маршрут-квитанции'': "При любой выписке"]] }}

{{Attention|Если настройка ''Включить настройки автовыписки и эквайринга'' выключена, правила с наличием параметров автовыписки/эквайринга в ЦО не учитываются }}

----
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Шаблонные переменные нотификации о необходимости ручной выписки заказа'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
| %AGENCY_EMAIL%
| E-mail агентства
|-
| %USER_NAME%
| Имя и фамилия получателя письма
|-
| %BOOKING_NUMBER%
| Внутренний номер заказа
|-
| %EXTERNAL_ID%
| Внешний ID заказа
|-
| %BOOKING_CODE%
| Код доступа к брони
|-
| %SERVICE_BOOKING_NUMBER%
| Номер бронирования в системе поставщика
|-
| %LINK_TO_BOOKING%
| Ссылка на бронирование
|-
| %CLIENT_PHONE%
| Телефон заказчика
|-
| %SEGMENT_DATE_ARR%
| Дата и время прилета сегмента
|-
| %SEGMENT_DATE_DEP%
| Дата и время вылета сегмента
|-
| %GROUP_DATE_DEP_ARR%
| Дата и время вылета и прилета по сегмента
|-
| %GROUP_DEP_ARR%
| Маршрут сегмента
|-
| %QRCODE%
| QR - код
|-
| %ALPHA_INSURANCE_INFO%
| Информация об услуге АльфаCтрахование для всего заказа
|-
| %SERVICE_PACK_INFO%
| Информация о выбранном сервисном пакете
|-
| %PASS_TYPE_GROUP_TYPE%
| Тип пассажира (группировка по типам пассажиров)
|-
| %TOTAL_CHARGES_AND_TAXES%
| Сборы и таксы на всех пассажиров
|-
| %PASS_TYPE_GROUP_COUNT%
| Количество пассажиров (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_FARE%
| Тариф (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TAXES%
| Таксы и сборы (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TOTAL%
| Итого (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TOTAL_FOR_GROUP%
| Итого на группу (группировка по типам пассажиров)
|-
| %MANUAL_TICKETING_TIMELIMIT%
| Время, до которого необходимо обработать заказ
|-
| %PCC_NAME%
| Название пакета реквизитов, в котором создан заказ
|-
| %CLIENT_EMAIL%
| E-mail заказчика
|}

</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Шаблонные переменные нотификации об ожидании ручной выписки заказа'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
| %AGENCY_NAME%
| Название агентства
|-
| %AGENCY_PHONE%
| Телефон агентства
|-
| %AGENCY_EMAIL%
| E-mail агентства
|-
| %USER_NAME%
| Имя и фамилия получателя письма
|-
| %BOOKING_NUMBER%
| Внутренний номер заказа
|-
| %EXTERNAL_ID%
| Внешний ID заказа
|-
| %BOOKING_CODE%
| Код доступа к брони
|-
| %SERVICE_BOOKING_NUMBER%
| Номер бронирования в системе поставщика
|-
| %LINK_TO_BOOKING%
| Ссылка на бронирование
|-
| %CLIENT_PHONE%
| Телефон заказчика
|-
| %SEGMENT_DATE_ARR%
| Дата и время прилета сегмента
|-
| %SEGMENT_DATE_DEP%
| Дата и время вылета сегмента
|-
| %GROUP_DATE_DEP_ARR%
| Дата и время вылета и прилета по сегмента
|-
| %GROUP_DEP_ARR%
| Маршрут сегмента
|-
| %QRCODE%
| QR - код
|-
| %ALPHA_INSURANCE_INFO%
| Информация об услуге АльфаCтрахование для всего заказа
|-
| %SERVICE_PACK_INFO%
| Информация о выбранном сервисном пакете
|-
| %PASS_TYPE_GROUP_TYPE%
| Тип пассажира (группировка по типам пассажиров)
|-
| %TOTAL_CHARGES_AND_TAXES%
| Сборы и таксы на всех пассажиров
|-
| %PASS_TYPE_GROUP_COUNT%
| Количество пассажиров (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_FARE%
| Тариф (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TAXES%
| Таксы и сборы (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TOTAL%
| Итого (группировка по типам пассажиров)
|-
| %PASS_TYPE_GROUP_TOTAL_FOR_GROUP%
| Итого на группу (группировка по типам пассажиров)
|}

</div>
</div>

== Ручной статус синхронизации ==
[[Файл:fixation status.jpg|450px|thumb|right|Зафиксировать статус вручную]]
Заказы, требующие участия агента, попадают в список '''«С дополнительным статусом»''' в личном кабинете. Для них устанавливается дополнительный статус '''«Необработан»''', данный статус отображается, если включен столбец ''«Дополнительный статус»''. При ручной обработке таких заказов, менеджер указывает ряд параметров в попапе ''«Зафиксировать статус вручную»'':
статус, номера билета (даже если он уже выписан), PNR, ID заказа в авиакомпании, PCC\пакет реквизитов (выбирается из списка). 

Редактировать вышеуказанные параметры можно без изменения параметра ''«Статус»''. Измененные параметры автоматически обновляются в печатных формах и личном кабинете.

После внесенных изменений по нажатию кнопки ''«Зафиксировать статус»'' статус заказа меняется на '''«Обработан»''', и ручную обработку заказа можно считать выполненной. Все дальнейшие действия с данным заказом становятся недоступным до снятия ручного статуса. 

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

== Импорт и экспорт правил ==
Правила задаются внесением ряда параметров в файл в формате XLS/XLSX, который импортируется в систему в разделе «Настройки автовыписки и эквайринга» → «Импорт/экспорт Excel». Пример файла для заполнения и полное описание формата внесения данных указаны ниже. Экспорт правил доступен в форматах XLS или XLSX. <br>
'''Пример файла для импорта:'''<br/>[[File:AcquiringExportExample.xls]]
----
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Импортируемые параметры'''</u>
<div class="mw-collapsible-content">
{| style="width: 100%" align="left" border="1" cellpadding="5" cellspacing="1" class="wikitable"
|-
! scope="col" | Заголовок<br/>
! scope="col" | Внутреннее название<br/>
! scope="col" | Описание<br/>
! scope="col" | Допустимые значения<br/>
! scope="col" | Примеры<br/>
|-
| id
| <span id="id">id</span>
| Уникальный номер записи, из любой внешней системы/БД. Необязательно для заполнения. Не участвуют в логике расчетов и используются для информативности<br/>
| любое значение.
| 123
|-
| запретить автотикетинг
| <span id="id">autoticketingDisabled</span>
| Определяет по какой схеме пройдет выписка заказа.<br/>
| 1 - автовыписка для заказа запрещена
0 - автовыписка разрешена 
пустое = выписка проходит по стандартному алгоритму в соответствие с настройками
| 1
0 <br/>
|-
| прямой эквайринг
| <span id="id">acquiringMode</span>
| Определяет по какой схеме пройдет оплата заказа.<br/>
| 1 - оплата проходит по прямому эквайрингу в авиакомпанию
2 - оплата проходит через банк <br/>
пустое = оплата проходит в соответствии с настройками
| 1
2 <br/>
|-
| правило активно
| <span id="id">active</span>
| Параметр определяет будет ли применяться правило или нет.<br/>
| 1 - правило активно
0 - правило неактивно <br/>
| 1
0 <br/>
|-
| валидирующий перевозчик GDS
| <span id="valCompanyId">valCompanyId</span>
| 
Валидирующий перевозчик перелета.<br/>

| 
пустое игнорируется
2 буквы/цифры<br/>
| 
SU,LH,BA<br/>
|-
| код-шеринг
| <span id="id">codeSharing</span>
| Признак допустимости выполнения рейса под другой оперирующей авиакомпанией.<br/>
| пустое - все перелеты<br/>
1 - код-шеринг обязателен <br/>
0 - код шеринг запрещён
| 1
0
|-
| системы бронирования
| <span id="gds">gds</span>
| Глобальная дистрибьютерская система / PCC конкретных реквизитов / ID пакета реквизитов системы NEMO
Перечиляются в любой последовательности, можно смешивать разные типы. Действует правило "или": если указан Sabre целиком, все его PCC/пакеты указывать уже нет смысла.

| 
пустое = любые<br/>SABRE, GALILEO, AMADEUS, SIRENA, SITA - GDS<br/>[буквы+цифры] - PCC<br/>[цифры] - ID пакета

| SABRE,670P,123
AMADEUS,GALILEO

|-
| тип рейса
| <span id="airlineType">airlineType</span>
| Международные воздушные линии или внутренние (весь перелет в пределах одной страны). Одно значение
| пустое = любой<br/>IA (international airlines - международные)<br/>DA (domestic airlines - внутренние)
| IA<br/>DA
|-
| содержит маршруты
| <span id="routePart">routePart</span>
| 
Цепочка из IATA кодов городов или аэропортов, описывающая часть маршрута перелета с учетом пересадок. Всегда следует использовать IATA код города, если он имеется (агрегирующий аэропорт). К примеру перелет VKO-ORY, ORY-VKO приводится к маршруту MOW-PAR-MOW.
| 
пустое = любые<br/>КОД-КОД,<br/>-КОД-,...<br/><>-КОД-,...(кроме)

| 
-CAI-<br/><>-PRG-,PRG-SVX
|-
| сервис классы
| <span id="serviceClass">serviceClass</span>
| 
Допустимые категории классов обслуживания<br/>Варианты ввода:

*КОД,КОД: должен совпасть класс из любого сегмента с одним из заданного списка.
*КОД,КОД!&nbsp;: классы из всех сегметнов перелета должны встречаться в этом списке
*<>КОД,КОД&nbsp;: хотя бы один класс из перелета не должен быть в этом списке
*<>КОД,КОД!&nbsp;: все классы из перелета не должны встречаться в этом списке

где КОД:

*B - бизнес
*E - эконом
*F - первый
*EB - сочетание эконом + бизнес
*EF - сочетание эконом + первый
*BF - сочетание бизнес + первый

| 
пустое = любые<br/>- одно или несколько значений (см. описание)

| 
B,E<br/>F<br/>EB,EF,F

|-
| начало вылета
| <span id="dateBegin">dateBegin</span>
| Дата вылета первого сегмента должна быть больше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY

| 05.05.2015
31.05.2015
|-
| конец вылета
| <span id="dateEnd">dateEnd</span>
| Дата вылета первого сегмента должна быть меньше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY

| 05.12.2015
31.12.2015
|}

</div>
</div>