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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Отправка путевки на редактирование во внешней системе)
(Импорт цен за отели)
(не показано 25 промежуточных версий 6 участников)
Строка 7: Строка 7:
 
==Общие настройки для всех адаптеров Sejour==
 
==Общие настройки для всех адаптеров Sejour==
  
===Справочники===
+
===Профилактика базы данных===
Список справочников с множественным сопоставлением:
+
Существует задание под '''SQL Server''', для уменьшение размера базы данных. Создается автоматически при обновлении MIS, по умолчанию выключено, носит название: '''название_промежуточной_бд_DeleteOldQuotas'''. Удаляет квоты и  стопы, которые датой меньше чем, если от сегодняшней даты вычесть 30 дней.
*'''Транспорт'''
 
  
==Адаптер бронирование путевок==
+
==Настройка направления адаптера==
 +
Основная информация по настройкам адаптеров находится в отдельной статье: [[Megatec_Integration_Service:Создание_направления._Настройки.|Создание направления. Настройки]].  <br>
 +
Настройка адаптера является общей для всех 3-х его частей, то есть настройки направления из "Бронирования путевок" также сохранятся в "Импорте цен" и "Импорте квот". <br>
 +
[[Файл:IA Sijur3.png| Окно настройки]]<br> <br>
 +
Во вкладке '''"Внешние настройки"''' указываются следующие настройки:
 +
* '''Параметры подключения к веб-сервису''':
 +
* '''Название подключаемой базы данных''' - база данных внешней системы для загрузки справочников, цен, квот и отправки путевок;
 +
** '''Адрес веб-сервиса''' - ссылка на веб-сервис внешней системы для загрузки справочников, цен, квот и отправки путевок;
 +
** '''Логин''' - имя (идентификатор) учетной записи пользователя во внешней системе;
 +
** '''Пароль''' - пароль для учетной записи;
 +
* '''Признаки цены'''
 +
** '''Комиссионная цена''' - признак комиссионной цены для Мастер-Тур;
 +
* '''Разное'''
 +
** '''Тип загружаемых цен''' - Указывает, загрузку каких цен производить от сервиса Sejour: финальные (PriceSearch) или контрактные (GetGeneralExportXml).<br>
 +
В данном случае лучше производить загрузку контрактных цен. <br>
 +
После заполнения параметров подключения к веб-сервису рекомендуется нажать кнопку '''Проверить настройки''', чтобы убедиться, что учетные данные введены верно.
 +
Во вкладке '''"Внутренние настройки"''' доступны настройки:
 +
*'''Выбор пакетов по умолчанию'''
 +
*'''Синхронизация в момент импорта''' - при активации настройки: если сопоставлены не все данные, то, в момент импорта откроется окно синхронизации. Если настройка не активирована импорт цен будет произведен без открытия окна синхронизации. Настройка работает для адаптеров '''"Импорт цен"''' и '''"Импорт квот"'''.
 +
*'''Перезатирание цен в пакете''' - при активации данной настройки при повторном импорте старые цены будут удалены.
 +
*'''Активировать после сохранения''' - настройка активирует ценовые блоки после сохранения в ПК Мастер-Тур 15
 +
*'''Активировать для цен нетто после сохранения''' - настройка активирует ценовые блоки после сохранения только для цен нетто в ПК Мастер-Тур 15
 +
* '''Закачка цен по несинхронизированным отелям в МИС''' - при отключенной закачка цен не производится в промежуточную базу если отели не сопоставлены.
 +
[[Файл:IA Sijur4.png| Окно настройки]]<br> <br>
 +
Во вкладке '''"Синхронизация"''' осуществляется выбор справочников для сопоставления данных.
  
 +
==Синхронизация справочников==
 +
Основная информация по синхронизации справочников находится в статье: [[Megatec_Integration_Service:Работа_с_окном_Синхронизация|Работа с окном Синхронизации]]. <br>
 +
Синхронизация справочников также является общей для всех 3-х его частей (Бронирование, Импорт цен и Импорт квот). <br>
 +
Сопоставление данных происходит по следующим справочникам: Страны, Города, Отели, Партнеры поставщика, Типы размещений, Типы и категории номеров, Типы питаний, Валюты, Транспорт, Типы ценовых блоков. <br>
 +
Список справочников с множественным сопоставлением: <br>
 +
• Транспорт<br>
 +
• Типы номеров<br>
 +
[[Файл:Ud_246.png|Синхронизация типа и категории номера|800px]] <br>
  
 +
==Импорт квот за отели==
 +
'''Основная информация по импорте квот за отели находится в отдельной статье: [[Megatec_Integration_Service:Работа_с_окном_Импорт_в_адаптере_«Импорт_квот»_и_«Импорт_наличия_мест»|Работа с окном «Импорт квот за отели»]].''' <br>
 +
[[Файл:IA Sijur5.png|1000px|Импорт квот - главное окно]] <br>
 +
На вкладке Внешние настройки есть настройка:
 +
* '''Тип номера квоты Любое''' - при включенной настройке тип номера будет отображаться как "Все" в экране просмотра квот и стопов.
 +
Для импорта квот и стопов сначала необходимо загрузить справочники и квоты. Для этого нужно нажать на кнопку '''"Загрузка из внешней системы"''' [[Файл:Ud_242.png|Кнопка "Загрузка квот из внешней системы"]]. Откроется следующее окно: <br>
 +
[[Файл:IA Sijur1.png|Загрузка квот из внешней системы]] <br>
 +
* '''Загрузить справочники''' - для загрузки/обновления информации по справочникам, по которым доступны новые квоты и стопы.
 +
* '''Загрузить квоты ''' - для загрузки/обновления информации по квотам.
 +
* '''Загрузить StopSales''' - для загрузки/обновления информации по стопам.
 +
* '''Код отеля через точку с запятой''' - для загрузки квот и стопов по определенным отелям
 +
Выбор даты - можно выбрать дату с и дату по начала загрузки квот и стопов.
  
 +
==Импорт цен за отели==
 +
'''Основная информация по импорте цен за отели находится в отдельной статье: [[Megatec Integration Service:Работа с окном Импорт в адаптере «Импорт цен за отели»|Работа с окном «Импорт цен за отели»]].''' <br>
 +
[[Файл:IA Sijur2.png|1000px|Импорт цен- главное окно]] <br>
 +
Для импорта цен сначала необходимо загрузить справочники и цены. Для этого нужно нажать на кнопку '''"Загрузка из внешней системы"''' [[Файл:Ud_242.png|Кнопка "Загрузка квот из внешней системы"]]. Откроется следующее окно: <br>
 +
[[Файл:NA_Sejour.jpg|Загрузка цен из внешней системы]] <br>
 +
* '''Загрузить справочники''' - для загрузки/обновления информации по справочникам, по которым доступны новые цены.
 +
* '''Загрузить цены''' - для загрузки всех цен. При каждой загрузке пользователь производится закачка всех цен. Использовать при первичной загрузке цен и после перерыва загрузки изменений более одного дня.
 +
* '''Загрузить изменения по ценам''' - для загрузки изменений по ценам. Сервис Sejour выгружает изменения по ценам только за текущий день. <br>
 +
Из сервиса Sejour цены закачиваются за номер с включенными в стоимость номера доплатами за питание и категорию номера. Цены за человека не загружаются и не обрабатываются. Загружаются основные цены, СПО с изменениями по ценам, а также СПО разных форматов, которые при импорте обрабатываются как акции в МТ типов Early Bird, Kick Back, Pay/Stay. Если от внешней системы приходит цена с значением min/max stay и датами периода или заезда, отличающимися от аналогичных дат основной цены, то при импорте основная цена разбивается на отдельные блоки с отдельными датами.<br>
 +
 +
==Бронирование путевок==
 +
'''Основная информация по бронированию путёвок  за отели находится в отдельной статье:[[Megatec Integration Service:Работа с окном в адаптере «Бронирование путевок»|Работа с окном в адаптере «Бронирование путевок»]].''' <br>
 
===Подготовка путевки===
 
===Подготовка путевки===
  
Строка 35: Строка 90:
  
 
====Отправка путевки на редактирование во внешней системе ====
 
====Отправка путевки на редактирование во внешней системе ====
При изменении любой информации в путевке, кроме статуса услуг и статуса путевки необходимо будет снова отправить данную путевку во внешнюю систему, но уже на редактирование. Об этом будет символизировать '''статус обмена''' - '''Требуется отправка''' и статус услуг смениться с любого состояния на '''Не определен'''. Чтобы отправить путевку на редактирование надо снова вызвать меню работы с путевкой и выбрать пункт '''Отправить путевку'''. Актуальный код путевки в системе Sejour, всегда будет отображен в колонке '''Доп информация'''.
+
При изменении любой информации в путевке, кроме статуса услуг и статуса путевки необходимо будет снова отправить данную путевку во внешнюю систему, но уже на редактирование. Об этом будет символизировать '''статус обмена''' - '''Требуется отправка''' и статус услуг сменится с любого состояния на статус - '''Не определен'''. Чтобы отправить путевку на редактирование надо снова вызвать меню работы с путевкой и выбрать пункт '''Отправить путевку'''. Актуальный код путевки в системе Sejour, всегда будет отображен в колонке '''Доп информация'''.
  
 
====Отправка путевки на аннуляцию во внешней системе====
 
====Отправка путевки на аннуляцию во внешней системе====
Строка 47: Строка 102:
 
*'''Confirmed''' – услуга подтверждена.
 
*'''Confirmed''' – услуга подтверждена.
 
*'''NotConfirmed''' – услуга не подтверждена.
 
*'''NotConfirmed''' – услуга не подтверждена.
*'''Не определен''' – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
+
*'''No answer''' – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
 
В экране '''Турпутевка''' «'''Мастер-Тур'''» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике '''Статусы услуг''' пользователем.
 
В экране '''Турпутевка''' «'''Мастер-Тур'''» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике '''Статусы услуг''' пользователем.
 +
 +
===Список особенностей при отправке/работе с путевками===
 +
1) В первичной отправке путевки или на редактирование. Для путевок, в которых есть услуга трансфер и проживание, но нет услуги перелет, при отправке таких путевок буду проставлены значения по умолчанию. <br> 
 +
*'''<ArrivalReg>AR</ArrivalReg>'''
 +
*'''<DeparutureReg>DP</DeparutureReg>'''<br> 
 +
2) Если путевка, когда либо была отправлена во внешнюю систему, но после этого была аннулирована или её статус стал штраф в МТ, то для таких путевок статус обмена станет - '''Не отправлять'''
  
 
[[Category:Megatec_Integration_Service]]
 
[[Category:Megatec_Integration_Service]]

Версия 10:59, 5 марта 2022

Статья находится на стадии разработки.
Версия статьи от 5-03-2022.

Введение

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

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

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

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

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

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

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

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

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

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

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

  • Выбор пакетов по умолчанию
  • Синхронизация в момент импорта - при активации настройки: если сопоставлены не все данные, то, в момент импорта откроется окно синхронизации. Если настройка не активирована импорт цен будет произведен без открытия окна синхронизации. Настройка работает для адаптеров "Импорт цен" и "Импорт квот".
  • Перезатирание цен в пакете - при активации данной настройки при повторном импорте старые цены будут удалены.
  • Активировать после сохранения - настройка активирует ценовые блоки после сохранения в ПК Мастер-Тур 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) Если путевка, когда либо была отправлена во внешнюю систему, но после этого была аннулирована или её статус стал штраф в МТ, то для таких путевок статус обмена станет - Не отправлять