Мастер-Сервис:Дополнительный модуль Автоматическая загрузка статусов из ПK «ProTour»

Введение

Основное назначение модуля – загрузка статусов услуг в ПК «Мастер-Тур» из ПK «ProTour»

Задача выполняется с использованием ПК «Мастер-Сервис» в полностью автоматическом режиме. При этом запуск задания осуществляется каждые 2 часа .

Настройки, влияющие на работу механизма разделяются на:

• Настройки задания Мастер-Сервис (управление непосредственно через интерфейс модуля запуска задания в ПК «Мастер-Сервис»)
• Настройки в базе данных (управление только через запросы формата SQL)

Настройки задания Мастер-Сервис

Управление непосредственно через интерфейс модуля запуска задания в ПК «Мастер-Сервис»

DaysBeforeToday - за сколько дней назад получать данные

Текущее значение – «2»
Служба ProTour возвращает данные по статусам на дату выполнения этих изменений в ПК «ProTour». То есть, если услуга была подтверждена именно такого-то числа, то чтобы загрузить эту информацию необходимо запросить изменения именно за эту дату.
Фактически при стабильном функционировании системы достаточно установить параметр – «1», то есть загрузка только за текущий день. Установка значения в «2» производится только дополнительного контроля (на случай остановки механизма загрузки статусов на ночь).

ServiceUrl - адрес протуровского сервиса

Текущее значение – «http://www.turtess.com.tr/xml/xml_response.php»

TicketUrl - адрес сервиса ProTour для получения тикита

Текущее значение – «http://www.turtess.com.tr/xml/ticket.php»
Служебный адрес (необходим для работы с сервисом ПК «ProTour» )
Timeout - таймаут соединения
Текущее значение – «60000»
Служебная настройка (необходима для отладки и в случае ухудшения качества канала связи между с сервисом ПК «ProTour» )

YesStatusId - идентификатор статуса Ок в системе

Текущее значение – «0»

Важно! Это настройка отвечает не за выставление услуги в это значение, а только указывает эталонное значение для проверки и поиска услуг в которых необходимо выполнить изменение. 

Информацию по статусам модно посмотреть запросом
select * from Controls
В таблице видно, что текущее значение соответствует статусу «Ok»
Для выставления статуса, в который необходимо установить услугу, если пришло подтверждение от поставщика необходимо задать настройку «SYS_SerStateAfterConf»

WaitStatusId - идентификатор статуса Wait в системе

Текущее значение – «13»

Важно! Это настройка отвечает не за выставление услуги в это значение, а только указывает эталонное значение для проверки и поиска услуг в которых необходимо выполнить изменение.  

Информацию по статусам модно посмотреть запросом
select * from Controls
В таблице видно, что текущее значение соответствует статусу «Wait List»

NoStatusId - идентификатор статуса No в системе

Текущее значение – «9»

Важно! Это настройка отвечает не за выставление услуги в это значение, а только указывает эталонное значение для проверки и поиска услуг в которых необходимо выполнить изменение. 

Информацию по статусам модно посмотреть запросом
select * from Controls
В таблице видно, что текущее значение соответствует статусу «Отказано партнером»
Для выставления статуса, в который необходимо установить услугу, если пришел отказ необходимо задать настройку «SYS_SerStateAfterNotConf»

SetNotConf – Устанавливать автоматически статус в ПК «Мастер-Тур» на «не подтвержден», в случае отказа партнером

Текущее значение – «False»
Если данная настройка будет установлена в значение «True», то будет производиться изменение статуса неподтвержденных услуг на указанный в настройке «SYS_SerStateAfterNotConf». Изменение будет производиться только в случае, если глобальный статус услуги не был в состоянии «OK».
Глобальный статус услуги можно узнать в справочнике «Статусы услуг».

SetChangeNotConf – Присылать уведомление на почту, что была попытка изменить статус путевки

Текущее значение – «False»
Работа в состоянии «False» - присылает уведомление на почту, что была попытка изменить статус путевки, на сам статус не изменяет.
Если данная настройка будет установлена в значение «True» - на почту ничего не отправляется, а статус путевки заменяется на тот, который пришел.

ReportConfirmationToAgent - шаблон отчета отправляемого в случае успешного подтверждения услуги

Текущее значение – «ConfToAgent»

Отчет будет отправляться в случае успешного подтверждения услуги и путевки на e-mail агентства. Алгоритм работы данного механизма полностью совпадает со стандартным алгоритмом отправки подтверждения через интерфейс ПК «Мастер-Тур» (отправка отчета «Счет-подтверждение (Mostravel) )».
Сопоставление данного значения с конкретным отчетом производится в плагине «Настройка отчетов», где в поле «Отображаемое значение» необходимо проставить значение: «значение текущей настройки», а в остальных вызов конкретного отчета.
В данном случае:

• отчет -«Бланки по заявке»,
• Профиль – «Счет(Мостравел)»

ReportNoticeOfConfirmation - профиль отчета отправляемого в случае невозможности подтверждения услуги в ПК «Мастер-Тур»

Текущее значение – «NoticeOfConf»
Услуга может не быть подтверждена автоматически в случае, если в ПК «Мастер-Тур» отсутствует возможность посадить услугу в квоты (даже без учета релиз-периода), а квоты в программе по услуге заведены.
Сопоставление данного значения с конкретным отчетом производится в плагине «Настройка отчетов», где в поле «Отображаемое значение» необходимо проставить значение: «значение текущей настройки», а в остальных вызов конкретного отчета.
В данном случае:

• отчет -«Бланки по заявке»,
• Профиль – «Уведомление об отказе в подтверждении»

Отчет будет отправляться в случае невозможности подтверждения услуги. Для подтверждения данной услуги необходимо увеличить количество мест в квоте, затем либо вручную подтвердить данную услугу, либо дождаться следующего запуска модуля и данная операция выполниться автоматически.

Пример отчета:
Тема: KMR09090AJ Нет квоты для подтверждения
Содержимое:
Нет квоты для подтверждения
Номер путевки: KMR09090AJ
Название услуги: HOTEL::Кемер/Queens Park Resort 5*, 10 ночей/Dbl, Standard Sea View, 2 взрослых,
Дата с: 09.09.2010 Дата по: 18.09.2010

ReportNotificationInabilityConfirm - шаблон отчета отправляемого в случае не возможности снятия с вэйт листа

Текущее значение – «InabilityConf»
В случае неподтверждения услуги отправлять уведомление.
Сопоставление данного значения с конкретным отчетом производится в плагине «Настройка отчетов», где в поле «Отображаемое значение» необходимо проставить значение: «значение текущей настройки», а в остальных вызов конкретного отчета.
В данном случае:

• отчет -«Бланки по заявке»,
• Профиль – «Уведомление о невозможности подтверждения услуги»

Отчет будет отправляться в случае отказа в подтверждении услуги поставщиком.

Пример отчета:
Тема: BLK19090B1 NOT CONFIRMED
Содержимое:
NOT CONFIRMED
Номер путевки: BLK19090B1
Название услуги: HOTEL::Белек/Rixos Hotel Premium-5*,14 ночей/Sng(Standard Garden),1+1ch6-11 (6-11)/AXI EXCLUSIVE ALL INCLUS/
Дата с: 03.10.2010 Дата по: 16.10.2010

ReportChangeNotConf - шаблон отчета, отправляемого при попытке изменения путевки со статусом «Отказано партнером»

Текущее значение – «ChangeNotConf»
При попытке изменения путевки со статусом «Отказано партнером» отправлять уведомление.
Сопоставление данного значения с конкретным отчетом производится в плагине «Настройка отчетов», где в поле «Отображаемое значение» необходимо проставить значение: «значение текущей настройки», а в остальных вызов конкретного отчета.
В данном случае:

• отчет -«Бланки по заявке»,
• Профиль – «Уведомление о попытке изменения путевки»

Отчет будет отправляться в том случае, если из Протура пришел статус услуги проживания - «ОК», а в МТ путевка имеет статус «Отказано партнером».

Пример отчета:
Тема: BLK19090B1 ChangeNotConf
Содержимое:
ChangeNotConf
Номер путевки: BLK19090B1
Название услуги: HOTEL::Белек/Rixos Hotel Premium-5*,14 ночей/Sng(Standard Garden),1+1ch6-11 (6-11)/AXI EXCLUSIVE ALL INCLUS/
Дата с: 03.10.2010 Дата по: 16.10.2010

DemoMode - демо режим

Текущее значение – «False» В случае запуска демо-режима (установки данной настройки в «True») активируются следующие настройки:

• TestEmail
• ConfCountPerOneJob

TestEmail - если задан то все письма отправляются на этот адрес

Текущее значение – «»
Работает только в режиме DemoMode.
На данный E-mail отправляются все отправляемые письма. Данная настройка необходима для отладки системы.

ConfCountPerOneJob - если > 0 то количество подтверждений за один цикл работы плагина

Текущее значение – «0»
Если в данной настройке указать значение > 0, то именно столько данных из системы ПК «ProTour» будет обрабатываться за один запуск системы.
Данная настройка необходима для отладки системы.

USER

Текущее значение – «sysadm»
Пользователь от имени которого будет производиться запуск данного модуля.
Данный пользователь должен обладать определенными правами в ПК «Мастер-Тур» (права на изменение услуг, на отправку почты, на изменение путевки)
Пользователь должен иметь права на следующие actions:

• Разрешить подтверждать услуги при наступлении релиз-периода
• Разрешить подтверждать услуги при наступлении Stop-Sale

Password

Пароль пользователя под которым запущено задание.

Настройки в базе данных

Настройки в базе данных (управление только через запросы формата SQL):
Все настройки установлены в БД и доступны для просмотра через запрос SQL
select * from Systemsettings where SS_ParmName='<Название настройки>’

(Пример: select * from Systemsettings where SS_ParmName='SYS_SerStateAfterConf' )

Для изменения настроек потребуется выполнить запрос к БД формата:
update systemsettings SET SS_ParmValue='<Новое заначение настройки>' where SS_ParmName='<Название настройки>’

(Пример: update systemsettings SET SS_ParmValue='3266,3268,2615,3442,3459,3452,3311,3312,3313,3301,3287' where SS_ParmName='SYS_HotelsWithServState' )

SYS_HotelsWithServState

Текущее значение – «3266,3268,2615,3442,3459,3452,3311,3312,3313,3301,3287»
Настройка предназначена для ограничения списка отелей, которые разрешено подтверждать из системы ПК «ProTour». В данной настройке перечислены ключи отелей, статусы по которым не будут загружаться в ПК «Мастер-Тур».
На момент установки системы была поставлена задача не загружать статусы по определенным отелям, как видно в нижеследующем запросе. Запрос помогает отобрать ключи отелей, которые необходимо установить в данной настройке:
select HD_Key,HD_Name from hoteldictionary where hd_name in
(
'Sphinx Heliopolis',
'Hilton Life Golf Resort',
'Magic Pyramids Kalawy Imperial',
'Movipick',
'Premier Romance Boutique Hotel & Spa',
'Radisson Oriental Resort El Quseir',
'Sentido Blu Dream Resort'
)

SYS_EmailSerNotConf

Текущее значение – «alper.erol@mostravel.com»
Настройка указывает E-mail на который требуется отправлять письмо, если от поставщиков пришел отказ в подтверждении услуги.
Важно! E-mail можно перечислять через запятую

SYS_EmailSerWarning

Текущее значение – «alper.erol@mostravel.com»
Настройка указывает E-mail на который требуется отправлять письмо, если пришло подтверждение от поставщика, но нет возможности подтвердить услугу в ПК «Мастер-Тур».
Важно! E-mail можно перечислять через запятую

SYS_SerStateAfterConf

Текущее значение – «0»
Настройка, отвечающая за установку статуса в ПК «Мастер-Тур». Значение в данной настройке может быть только из списка значений, присутствующих в таблице «Controls»
Информацию по статусам модно посмотреть запросом
select * from Controls
В таблице видно, что текущее значение соответствует статусу «Ok»
Текущий модуль будет пробовать установить услугу в данный статус, если в системе ПК «ProTour» услуга получила статус «YES»

SYS_SerStateAfterNotConf – Статус, в который необходимо переводить услугу в случае отказа поставщиком

Текущее значение – «9»
Настройка, отвечающая за установку статуса в ПК «Мастер-Тур». Значение в данной настройке может быть только из списка значений, присутствующих в таблице «Controls»
Информацию по статусам модно посмотреть запросом
select * from Controls
В таблице видно, что текущее значение соответствует статусу «Отказано партнером»
Текущий модуль будет устанавливать услугу в данный статус, если в системе ПК «ProTour» услуга получила статус «NO» и установлена настройка модуля «SetNotConf» в значение «True».

SYS_ResStateAfterNotConf – Статус, в который необходимо переводить путевку в случае отказа поставщиком

Текущее значение – «12»
Настройка, отвечающая за установку статуса в ПК «Мастер-Тур». Значение в данной настройке может быть только из списка значений, присутствующих в таблице «Order_status»
Информацию по статусам модно посмотреть запросом
select * from Order_status
В таблице видно, что текущее значение соответствует статусу «Отказано партнером»
Текущий модуль будет устанавливать путевку в данный статус, если в системе ПК «ProTour» услуга получила статус «NO» и установлена настройка модуля «SetNotConf» в значение «True».