Fee and Commission Calculator
При выписке билета в среде Red Workspace доступна только информация о базовом тарифе. Но для оформления документа агентам нужна также информация о комиссиях и сборах, которую они обычно хранят в разрозненных бумажных документах или файлах Excel. На поиск информации тратится значительное время, что снижает производительность работы агента и даже может стать причиной недовольства клиента.
Приложение Fee and Commission Calculator позволяет ускорить этот процесс — оно автоматически рассчитывает все применимые к текущему бронированию комиссии и сборы на основе имеющейся в Mid Office Manager информации, включает их в общую стоимость бронирования и отображает эту информацию непосредственно на экране терминала. Кроме того, приложение добавляет информацию о комиссиях и сборах в бронирование в виде ремарок.
После установки Fee and Commission Calculator в терминале Red Workspace становится доступной команда CALC, которая и предоставляет информацию о всех применимых к текущему бронированию комиссиях и сборах.
Содержание |
Подготовка к использованию Fee and Commission Calculator
Для нормальной работы приложения требуется следующее:
- Доступ к серверу Mid Office Manager. Сервер Mid Office Manager не обязательно должен размещаться на той же машине, что и Red Workspace, — достаточно доступа к серверу по локальной сети или через интернет. Подробнее о подключении к серверу Mid Office Manager см. Подключение приложений Red к серверу Mid Office Manager.
- Приложение Fee and Commission Calculator должно быть надлежащим образом установлено в среде Red Workspace.
- Настроенное подключение к серверу Mid Office Manager в параметрах приложения Red. В параметрах приложения Red надо задать адрес сервера и учетные данные для входа.
- Настроенные на сервере Mid Office Manager параметры для создания защищенного канала. В параметрах Mid Office Manager надо задать параметры защищенного канала между серверами Mid Office Manager и Red.
- Надлежащим образом настроенные профили и договоры на сервере Mid Office Manager.
- Надлежащим образом заданный сток в терминале Red Workspace (например, с помощью формата W*RU).
Далее описывается, как настроить подключение приложения Fee and Commission Calculator к серверу Mid Office Manager, а также как настроить на сервере Mid Office Manager самоподписанный сертификат для SSL-подключения.
Для выполнения приведенных далее инструкций нужна Java-утилита keytool.exe, которая находится в подпапке /jre/bin версии сервера и клиента Mid Office Manager со средой JRE.
Если вы используете клиент или сервер Mid Office Manager без среды JRE, нужно использовать утилиту keytool.exe входящую в состав Java JDK или JRE. В этом случае на машине должен быть установлен как минимум один из этих пакетов. Утилита keytool.exe обычно находится в подпапке bin установочной папки Java.
Чтобы настроить безопасный канал связи между сервером приложений Red и сервером Mid Office Manager:
- Создайте файл с парой ключей для шифрования канала связи в следующей последовательности:
- Выполните в командной строке следующую команду:
keytool -genkeypair -alias redapp -keyalg RSA -keysize 2048 -validity 3650 -keystore c:\mom\server\redapp.jks
- В ответ на вопросы команды Enter keystore password: и Re-enter new password: введите и подтвердите пароль хранилища ключей.
В ответ на остальные вопросы просто нажимайте Enter за исключением вопроса
Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct? [no]:
в ответ на который нужно ввести Y.Не задавайте никакого пароля в ответ на вопрос Enter key password for <redapp> (RETURN if same as keystore password): — пароль ключа обязательно должен совпадать с паролем на хранилище! - Убедитесь, что в указанном месте создан файл хранилища ключей с расширением .jks и при необходимости скопируйте его на машину с сервером Mid Office Manager.
- Выполните в командной строке следующую команду:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties для редактирования.
- В конец файла boot.properties добавьте следующие строки:
# Tomcat settings for interaction with RedApps com.gridnine.xtrip.server.tomcat.redapp.port = 8445 com.gridnine.xtrip.server.tomcat.redapp.protocol = org.apache.coyote.http11.Http11Protocol com.gridnine.xtrip.server.tomcat.redapp.proxyName = com.gridnine.xtrip.server.tomcat.redapp.proxyPort = com.gridnine.xtrip.server.tomcat.redapp.secure = true com.gridnine.xtrip.server.tomcat.redapp.scheme = https com.gridnine.xtrip.server.tomcat.redapp.URIEncoding = utf-8 com.gridnine.xtrip.server.tomcat.redapp.SSLEnabled = true com.gridnine.xtrip.server.tomcat.redapp.sslProtocol = TLSv1.2 com.gridnine.xtrip.server.tomcat.redapp.clientAuth = false com.gridnine.xtrip.server.tomcat.redapp.keystoreFile = c://mom//server//redapp.jks com.gridnine.xtrip.server.tomcat.redapp.keystorePass = <пароль ключа> com.gridnine.xtrip.server.tomcat.redapp.default = false
где <пароль ключа> — пароль, который нужен для извлечения ключа для шифрования канала связи, например P@ssw0rd1.
- Перезапустите сервер Mid Office Manager.
Чтобы создать подключение приложения Red к серверу Mid Office Manager:
- Откройте окно Sabre Red Workspace.
- В меню последовательно выберите Инструменты и Параметры.
- В левой панели окна Параметры разверните узел Настройки для приложений Red и выберите узел Fee and Commission Calculator Preferences.
- В правой панели задайте значения следующих полей:
- MOM server address — сетевой адрес сервера Mid Office Manager, например http://localhost:8080.
- Login — имя пользователя Mid Office Manager, в контексте которого будут выполняться запросы информации в Mid Office Manager из приложения.
- Password — пароль пользователя Mid Office Manager, в контексте которого будут выполняться запросы информации в Mid Office Manager из приложения.
- Щелчком кнопки ОК закройте окно Параметры.
После такой настройки Fee and Commission Calculator в терминале Red Workspace становится доступной команда CALC, которая предоставляет информацию о всех применимых к текущему бронированию комиссиях и сборах.
Использование Fee and Commission Calculator
Использование Fee and Commission Calculator показано на примере стандартного бронирования.
- В терминале Sabre Red Workspace откройте бронирование.
- Выполните команду CALC.
В результате создаются ремарки следующего вида:
H-FEE/FARE40523.00/KP12.15/AFEE200.00/DISC100.00/TTL40623.00 / RUB-1.1/1
где:
- FARE40523.00 — полная стоимость билета от авиакомпании: (Total Fare) = <эквивалентный тариф> + <таксы>.
- KP12.15 — величина комиссии. Комиссия в процентах отображается как KP, например KP10 означает 10% от эквивалентного тарифа. Абсолютное значение обозначается KA, например KA100.00.
- AFEE200.00 — величина агентских сборов с клиента (сервисный сбор агентства по билету, который будет выставлен клиенту по договору с ним). Если сбор в договоре задан в процентах, то выводится вычисленная сумма от величины эквивалентного тарифа.
- DISC100.00 — величина скидок. Если задано несколько скидок (в договоре с поставщиком и с клиентом), то они складываются.
- TTL40623.00 — общая сумма с клиента составляет (40523.00 + 200.00 – 100.00)
- RUB — валюта расчета
- 1.1 — номер билета (пассажира)
- 1 — номер PQ
Ремарка H- и ремарка .X*- отличаются только этими префиксами, их основное содержание одинаково. Отличие в том, что ремарка .X*- не попадает в инвойс и передается в IUR, а ремарка H- — это историческая ремарка.
Необходимые условия для вычисления комиссий и сборов
Чтобы при работе команды CALC были рассчитаны комиссии и сборы, необходимо выполнение следующих условий:
- Принтер В терминале Sabre должен быть задан принтер, например:
- W*RU — BSP Россия
- W*1R — Аэрофлот
- W*1Y — S7
- W*1T — ТКП
- Если принтер не определен, отображается сообщение об отсутствующем принтере (PRINTER NOT ASSIGNED) и работа Fee and Commission Calculator завершается.
- Корректное бронирование в Sabre В бронировании, для которого запускается команда CALC, должны быть сегменты и PQ.
- Если в бронировании не заданы имена пассажиров, маршрут или не рассчитаны PQ, выводятся соответствующие сообщения и работа Fee and Commission Calculator завершается.
- Если не задан DK-номер клиента, выводится предупреждающее сообщение. В этом случае ищется договор с клиентом, который выбран в системном свойстве "Код профиля розничного клиента". Если же и этот клиент не задан, берется профиль из свойства "Профиль Любой клиент".
- Головное агентство В Mid Office Manager должно присутствовать корректно определенное головное агентство и точка продаж. Для этого должен существовать профиль с ролью "Агентство".
- Точка продаж Для головного агентства должна существовать точка продаж.
- Договор с клиентом В Mid Office Manager должен быть корректно создан договор с клиентом.
- Для этого должен существовать профиль клиента, у которого указан DK-номер такой же, как в строке "Customer Number" в том PNR в Sabre, для которого запускается Fee and Commission Calculator.
- Должен существовать "Договор с клиентом", где в качестве агентства выступает ранее созданное головное агентство, а в качестве клиента — указанный профиль клиента.
- В договоре должно быть указано правило начисления сбора. Сбор может начисляться как в процентах, так и по абсолютной величине.
- В случае, если DK номер не задан в бронировании, ищется договор с клиентом, который выбран в системном свойстве "Код профиля розничного клиента". Если же и этот клиент не задан, берется профиль из свойства "Профиль Любой клиент". Также следует учесть, что при наличии двух сборов с разными категориями в двух договорах (например, в договоре с клиентом, заданным через DK номер, и в договоре с клиентом, заданным в "Профиль любой клиент") эти сборы суммируются.
- Договор с поставщиком В Mid Office Manager должен существовать корректный договор с поставщиком, то есть в договоре в качестве владельца бланка и поставщика должны присутствовать те же значения, что и в ранее описанном валидаторе. В качестве клиента должно присутствовать ранее описанное головное агентство.
Дополнительные параметры
В команде CALC можно использовать дополнительные параметры.
Указание валюты расчета
Для указания валюты расчета необходимо после команды CALC задать параметр — код валюты. В этом случае все рассчитанные значения будут показаны в указанной валюте. Например, для расчета в долларах:
Для пересчета значений в другую валюту должны быть корректно заполнены курсы валют в справочнике "Курсы обмена"
Перезапись PQ
Команда CALC c дополнительным параметром DIT позволяет перезаписать записи PQ в бронировании, добавить параметр комиссии и ремарки, а также отправить команду DIT. При этом будет сформирован обменный файл с добавленными ремарками, который обрабатывается в Mid Office Manager, что позволяет увидеть эти данные в маске билета в статусе "Бронь".
Действия выполняются в следующем порядке:
- Удаляются старые PQ записи (команда PQD-ALL).
- Удаляются старые ремарки по предыдущим PQ.
- Создаются новые PQ записи в соответствии с номерами и типами пассажиров. При этом старые параметры сохраняются и добавляются новые в соответствии с рассчитанными комиссиями (параметр вида KP или K).
- Создаются новые ремарки по PQ записям, в том числе ремарка по базовому и экв. тарифам, таксам, валидирующему перевозчику, типу пассажира, номеру пассажира.
- Отправляется команда DIT с учетом сегментов, до и после которой выполняются соответственно команды PGHOLD и PGREL для остановки CTP.
Ниже приведен пример работы команды CALC c параметром DIT.
Журнал работы приложений Red
Для уточнения и устранения неполадок при работе с командой CALC следует, прежде всего, проверить все действия согласно приведенному описанию и разделу "Необходимые условия для вычисления комиссий и сборов". При необходимости полезную информацию можно получить из журнала, где фиксируются выполняемые действия. Файл журнала приложений Red, который может быть полезным для настройки приложения Fee and Commission Calculator, называется redapp.log и находится в подпапке logs установочной папки сервера Mid Office Manager.
По умолчанию журнал неактивен или вообще отсутствует, а события приложений Red в журнале не регистрируются. Для включения регистрации событий приложений Red нужно предпринять ряд действий.
Чтобы включить регистрацию событий приложений Red в Mid Office Manager:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл log4j.properties в текстовом редакторе.
- Найдите раздел, начинающийся со строки # Loggers configuration, например:
# Loggers configuration log4j.rootLogger = OFF, null log4j.logger.com.gridnine.xtrip = ALL, xtrip log4j.logger.com.gridnine.xtrip.TIMING = ALL, xtrip
- Добавьте в раздел # Loggers configuration
следующую строку:
log4j.logger.com.gridnine.xtrip.server.parsers2.redapp = ALL, xtrip-redapp
- В конце файла log4j.properties добавьте следующие строки:
log4j.appender.xtrip-redapp = org.apache.log4j.FileAppender log4j.appender.xtrip-redapp.file = ${applicationRoot}/logs/redapp.log log4j.appender.xtrip-redapp.encoding = UTF-8 log4j.appender.xtrip-redapp.layout = org.apache.log4j.PatternLayout log4j.appender.xtrip-redapp.layout.conversionPattern = %d [%15.15t] %-5p %40.40c : %m%n log4j.appender.xtrip-redapp.append = false
- Сохраните и закройте файл log4j.properties.
- Перезагрузите сервер Mid Office Manager.