Megatec Integration Service:Индивидуальные особенности адаптеров Sejour (Турция, Болгария, Египет)

Статья находится на стадии разработки.
Версия статьи от 28-10-2024.

Введение

В данной вкладке представлена информация обо всех индивидуальных настройках и возможностей для адаптеров работающих с веб сервисом внешней системы Sejour.

Общие настройки для всех адаптеров Sejour

Профилактика базы данных

Существует задание под SQL Server, для уменьшение размера базы данных. Создается автоматически при обновлении MIS, по умолчанию выключено, носит название: название_промежуточной_бд_DeleteOldQuotas. Удаляет квоты и стопы, которые датой меньше чем, если от сегодняшней даты вычесть 30 дней.

Настройка направления адаптера

Основная информация по настройкам адаптеров находится в отдельной статье: Создание направления. Настройки.
Настройка адаптера является общей для всех 3-х его частей, то есть настройки направления из "Бронирования путевок" также сохранятся в "Импорте цен" и "Импорте квот".


Во вкладке "Внешние настройки" указываются следующие настройки:

• Параметры подключения к веб-сервису:
• Название подключаемой базы данных - база данных внешней системы для загрузки справочников, цен, квот и отправки путевок;
  • Адрес веб-сервиса - ссылка на веб-сервис внешней системы для загрузки справочников, цен, квот и отправки путевок;
  • Логин - имя (идентификатор) учетной записи пользователя во внешней системе;
  • Пароль - пароль для учетной записи;
• Признаки цены
  • Комиссионная цена - признак комиссионной цены для Мастер-Тур;
• Разное
  • Тип загружаемых цен - Указывает, загрузку каких цен производить от сервиса Sejour: финальные (динамика,PriceSearch) или контрактные (GetGeneralExportXml).
    

В данном случае нужно производить загрузку контрактных цен.

После заполнения параметров подключения к веб-сервису рекомендуется нажать кнопку Проверить настройки, чтобы убедиться, что учетные данные введены верно.

Во вкладке "Внутренние настройки" доступны настройки:

• Выбор пакетов по умолчанию
• Синхронизация в момент импорта - при активации настройки: если сопоставлены не все данные, то, в момент импорта откроется окно синхронизации. Если настройка не активирована импорт цен будет произведен без открытия окна синхронизации. Настройка работает для адаптеров "Импорт цен" и "Импорт квот".
• Перезатирание цен в пакете - при активации данной настройки при повторном импорте старые цены будут удалены.
• Импортировать цены, ранее загруженные из ВС – по умолчанию признак активности выключен.

Алгоритм работы настройки:

• Признак активности Загружать импортированные выключен.
  • Импорт в новый ЦБ
    • Признак активности Перезатирание цены в настройках выключен\включен: все цены, выбранные пользователем в экране Импорт цен импортируются в новый ЦБ. Проверка дублей цен в выбранном пакете не производится.
  • Импорт в существующий ЦБ
    • Признак активности Перезатирание цены в настройках включен: работает текущий функционал. После проверки соответствия дат продаж и поставщика цены будут импортированы с учётом функционала перезатирания цен цены, дубли цен не будут загружены, в интерфейсе появится запись Отклонено 100 цен.
    • Признак активности Перезатирание цены выключен: работает текущий функционал. После проверки соответствия дат продаж и поставщика цены будут импортированы с учётом функционала перезатирания цен, будут созданы дубли цен ( подсвечены розовым цветом).
• Признак активности Загружать импортированные включён.
  • Импорт в новый ЦБ
    • Признак активности Перезатирание цены в настройках выключена\включена: все выбранные пользователем цены в экране Импорт цен импортируются в новый созданный ЦБ. Проверка дублей цен в выбранном пакете не производится.
  • Импорт в существующий ЦБ
    • Признак активности Перезатирание цены в настройках включен: работает текущий функционал. После проверки соответствия дат продаж и поставщика цены будут импортированы с учётом функционала перезатирания цен, дублирующие цены не загружаются (в интерфейсе появится запись, например: Отклонено 100 цен).
    • Признак активности Перезатирание цены в настройках выключен: работает текущий функционал. После проверки соответствия дат продаж и поставщика цены будут импортированы с учётом функционала настройки Перезатирание цены, будут созданы дубли цен ( подсвечены розовым цветом).
• Признак активности Загружать импортированные выключен: работает текущий функционал.

• Активировать после сохранения - настройка активирует ценовые блоки после сохранения в ПК Мастер-Тур 15
• Активировать для цен нетто после сохранения - настройка активирует ценовые блоки после сохранения только для цен нетто в ПК Мастер-Тур 15

Во вкладке "Синхронизация" осуществляется выбор справочников для сопоставления данных.

Синхронизация справочников

Основная информация по синхронизации справочников находится в статье: Работа с окном Синхронизации.
Синхронизация справочников также является общей для всех 3-х его частей (Бронирование, Импорт цен и Импорт квот).
Сопоставление данных происходит по следующим справочникам: Страны, Города, Отели, Партнеры поставщика, Типы размещений, Типы и категории номеров, Типы питаний, Валюты, Транспорт, Типы ценовых блоков.
Список справочников с множественным сопоставлением:
• Транспорт
• Типы номеров

Импорт квот на отели

Основная информация по импорте квот за отели находится в отдельной статье: Работа с окном «Импорт квот на отели».

На вкладке Внешние настройки есть настройка:

• Тип номера квоты Любое - при включенной настройке тип номера будет отображаться как "Все" в экране просмотра квот и стопов.

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

• Загрузить справочники - для загрузки/обновления информации по справочникам, по которым доступны новые квоты и стопы.
• Загрузить квоты - для загрузки/обновления информации по квотам.
• Загрузить StopSales - для загрузки/обновления информации по стопам.
• Код отеля через точку с запятой - для загрузки квот и стопов по определенным отелям

Выбор даты - можно выбрать дату с и дату по начала загрузки квот и стопов.

Импорт цен на отели

Основная информация по импорте цен за отели находится в отдельной статье: Работа с окном «Импорт цен на отели».

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

• Загрузить справочники - для загрузки/обновления информации по справочникам, по которым доступны новые цены.
• Загрузить цены - для загрузки всех цен. При каждой загрузке пользователем производится закачка всех цен. Использовать при первичной загрузке цен. При повторной загрузке всех цен дублирующиеся цены с одинаковыми параметрами не загружаются в МИС, дата загрузки не обновляется.
• Загрузить изменения по ценам - для загрузки изменений по ценам. Сервис Sejour выгружает изменения по ценам только за текущий день.
  

Из сервиса Sejour цены закачиваются за номер с включенными в стоимость номера доплатами за питание и категорию номера. Цены за человека не загружаются и не обрабатываются. Загружаются основные цены, СПО с изменениями по ценам, а также СПО разных форматов, которые при импорте обрабатываются как акции в МТ типов Early Bird, Kick Back, Pay/Stay. Если от внешней системы приходит цена с значением min/max stay и датами периода или заезда, отличающимися от аналогичных дат основной цены, то при импорте основная цена разбивается на отдельные блоки с отдельными датами.

Бронирование путевок

Основная информация по бронированию путёвок за отели находится в отдельной статье:Работа с окном в адаптере «Бронирование путевок».

Подготовка путевки

Прежде чем приступить к отправке путевки необходимо:

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

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

Отправка путевки

Окно импорт состоит из фильтров для отбора путевок и таблицы с результатами. Если было введён номер путевки, то остальные фильтры работать не будут, пока поле с номером путевки не станет пустым. Данное окно позволяет производить действия с одной или несколькими путевками, для этого просто выделите их левой кнопкой мыши.

Первичное создание путевки во внешней системе

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

Получение стоимости путевки во внешней системе

Чтобы получить цену по путевке надо снова вызвать меню работы с путевкой и выбрать пункт Проверить стоимость по путевке. Стоимость будет отображена в колонке Нетто планируемое экрана импорт.

Отправка путевки на редактирование во внешней системе

При изменении любой информации в путевке, кроме статуса услуг и статуса путевки необходимо будет снова отправить данную путевку во внешнюю систему, но уже на редактирование. Об этом будет символизировать статус обмена - Требуется отправка и статус услуг сменится с любого состояния на статус - Не определен. Чтобы отправить путевку на редактирование надо снова вызвать меню работы с путевкой и выбрать пункт Отправить путевку. Актуальный код путевки в системе Sejour, всегда будет отображен в колонке Доп информация.

Отправка путевки на аннуляцию во внешней системе

Если путевка была когда-либо отправлена во внешнюю систему и после этого аннулирована в «Мастер-Туре», то соответственно статус обмена будет Требуется отправка, после аннуляции. После чего её необходимо аннулировать и во внешней системе снова вызвав меню работы с путевкой и нажать Аннулировать путевку.

Проверка заявки

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

• Waiting – внешняя система не определилась с ответом
• Confirmed – услуга подтверждена.
• NotConfirmed – услуга не подтверждена.
• No answer – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.

В экране Турпутевка «Мастер-Тур» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике Статусы услуг пользователем.

Список особенностей при отправке/работе с путевками

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

• <ArrivalReg>AR</ArrivalReg>
• <DeparutureReg>DP</DeparutureReg>
  

2) Если путевка, когда либо была отправлена во внешнюю систему, но после этого была аннулирована или её статус стал штраф в МТ, то для таких путевок статус обмена станет - Не отправлять