Megatec Integration Service:Работа с окном в адаптере «Бронирование путевок» — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Подготовка путевки)
 
(не показано 35 промежуточных версий 4 участников)
Строка 1: Строка 1:
==Бронирование путевок==
+
<span style="color:red;font-size:120%">Статья находится на стадии разработки.</span><br>
 +
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
 +
 
 +
==Введение==
 +
 
 +
Данное окно предназначено для отправки забронированных в ПК Мастер-Тур путевок во внешнюю систему с помощью MIS.
 +
 
 +
==Описание экрана Бронирование путёвок==
  
 
[[Файл:TP_9.png|Отправка путевок - главное окно]] <br>
 
[[Файл:TP_9.png|Отправка путевок - главное окно]] <br>
После заведения путевки в Мастер-Туре [уточнить при каких условиях, поставщик] она появляется в данном окне.
+
После заведения путевки в Мастер-Туре на синхронизированного поставщика  она появляется в данном окне. Чтобы обновить информацию в экране нужно нажать кнопку '''Поиск'''.
 
*'''Номер путевки''' из Мастер-Тура.
 
*'''Номер путевки''' из Мастер-Тура.
*'''Последний обмен''' - время последней отправки путевки.
+
*'''Последний обмен''' время последней отправки путевки.
*'''Статус обмена:'''
+
*'''Статус обмена''' – колонка, которая показывает текущий статус обмена по путевкам. Возможные варианты:
**'''Не обработана''' - путевка ни разу не отправлялась во внешнюю систему.
+
**'''Не обработана''' путевка ни разу не отправлялась во внешнюю систему.
**'''Требуется отправка''' - данный статус путевка принимает только в том случае, если после успешной отправки путевки были изменения в ПК "Мастер-Тур", которые необходимо повторно отправить.
+
**'''Требуется отправка''' данный статус путевка принимает только в том случае, если после успешной отправки путевки были изменения в ПК "Мастер-Тур", которые необходимо повторно отправить.
**'''Отправлена''' - путевка успешно отправлена во внешнюю систему.
+
**'''Отправлена''' путевка успешно отправлена во внешнюю систему.
**'''Ошибка''' - при попытке отправки путевки произошел сбой или есть не синхронизированные данные.
+
**'''Ошибка''' при попытке отправки путевки произошел сбой или есть несинхронизированные данные.
**'''Забронирована''' - путевка успешно забронирована во внешней системе.
+
**'''Забронирована''' путевка успешно забронирована во внешней системе. (адаптер Terma)
**'''Не отправлять''' - если путевка содержит статус, который не участвует в обмене, то ей присваивается статус 'Не отправлять'.
+
**'''Не отправлять''' – данный статус обмена присваивается путевке в том случае, если статус путевки в МТ не указан в списке статусов, подлежащих отправки. Перечень статусов путевок, подлежащих обмену указывается в [[Megatec Integration Service:Создание направления. Настройки.#Бронирование путевок|общих настройках направления]].
*'''Статусы услуг''' - статусы услуг сопоставляются в окне синхронизации, после отправления заявки статус обновляется в зависимости от ответа. В экране '''Турпутевка''' «'''Мастер-Тур'''» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике '''Статусы услуг''' пользователем. '''Виды статусов:'''  
+
*'''Статусы услуг''' статусы услуг сопоставляются в окне синхронизации, после отправления заявки статус обновляется в зависимости от ответа. В экране '''Турпутевка''' «'''Мастер-Тур'''» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике '''Статусы услуг''' пользователем. '''Виды статусов:'''  
 
**'''Waiting''' – внешняя система не определилась с ответом.
 
**'''Waiting''' – внешняя система не определилась с ответом.
 
**'''Confirmed''' – услуга подтверждена.
 
**'''Confirmed''' – услуга подтверждена.
 
**'''NotConfirmed''' – услуга не подтверждена.
 
**'''NotConfirmed''' – услуга не подтверждена.
 
**'''Не определен''' – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
 
**'''Не определен''' – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
*'''Статус путевки (МТ)''' - статус путевки в Мастер-Туре.
+
*'''Статус путевки (МТ)''' статус путевки в Мастер-Туре.
*'''Нетто планируемое''' - цена из поля "Нетто планируемое" в Мастер-туре.
+
*'''Нетто планируемое''' цена из поля "Нетто планируемое" в Мастер-туре.
*'''Нетто от партнера''' - цена, пришедшая от внешней системы.
+
*'''Нетто от партнера''' цена, пришедшая от внешней системы.
 
*'''Филиал'''
 
*'''Филиал'''
*'''Дата заезда''' - дата заезда в отель, также передается [[Мастер-Тур:Справочники#Основное описание отеля/круиза|Расчетный час]] (параметры: arrivalTime; departureTime), если он указан в данном отеле.
+
*'''Дата заезда'''  
 
*'''Покупатель'''
 
*'''Покупатель'''
 +
*'''Дата создания'''
 +
*'''Отель'''
 +
*'''Доп информация ''' –  указывается номер брони, штрафы из внешней системы, поле есть не во всех адаптерах.
  
 
[[Файл:TP_10.png|Контекстное меню путевки]] <br>
 
[[Файл:TP_10.png|Контекстное меню путевки]] <br>
 +
 
В контекстном меню путевки возможны следующие действия:
 
В контекстном меню путевки возможны следующие действия:
 
*Открыть путевку в Мастер-Туре
 
*Открыть путевку в Мастер-Туре
 
*Отправить путевку
 
*Отправить путевку
 +
*Проверить статус (не во всех адаптерах)
 
*Аннулировать путевку
 
*Аннулировать путевку
 
*Скопировать номер путевки в буфер обмена
 
*Скопировать номер путевки в буфер обмена
  
 
===Подготовка путевки===
 
===Подготовка путевки===
Основная информация по синхронизации справочников находится в статье: [[Megatec_Integration_Service:Работа_с_окном_Синхронизация|Работа с окном Синхронизации]]. <br>
+
Основная информация по синхронизации справочников находится в статье [[Megatec_Integration_Service:Работа_с_окном_Синхронизация|Работа с окном Синхронизации]]. <br>
 
Прежде чем приступить к отправке путевки необходимо:
 
Прежде чем приступить к отправке путевки необходимо:
 
*Сопоставить партнеров в справочнике '''Партнеры поставщика''', которые являются поставщиками услуг в путевке, желаемой для отправки во внешнюю систему.
 
*Сопоставить партнеров в справочнике '''Партнеры поставщика''', которые являются поставщиками услуг в путевке, желаемой для отправки во внешнюю систему.
Строка 39: Строка 51:
 
*Если в путевке есть услуга трансфер, то необходимо, чтобы в справочнике «Транспорт» были сделаны сопоставления.
 
*Если в путевке есть услуга трансфер, то необходимо, чтобы в справочнике «Транспорт» были сделаны сопоставления.
  
Для создания сопоставления услуги отель необходимо произвести сопоставления, аналогичные сопоставлениям для адаптера цен, которые нужны были для того, чтобы понять какому отелю из «'''Мастер-Тура'''» принадлежат закаченные цены из внешней системы. Соответственно надо сопоставить все значения для услуги '''Отель''' из данной путевки – '''название отеля''', '''тип размещения''', '''тип номера и категории''', '''тип питания''' в соответствующих справочниках вкладки '''Синхронизация'''.
+
Для создания сопоставления услуги отель необходимо произвести сопоставления, аналогичные сопоставлениям для адаптера цен, которые нужны были для того, чтобы понять какому отелю из «'''Мастер-Тура'''» принадлежат закаченные цены из внешней системы. Соответственно надо сопоставить все значения для услуги '''Отель''' из данной путевки – '''название отеля''', '''тип размещения''', '''тип номера и категории''', '''тип питания''' в соответствующих справочниках окна '''Синхронизации'''.
  
 
===Отправка путевки===
 
===Отправка путевки===
  
Окно импорт состоит из фильтров для отбора путевок и таблицы с результатами. Если было введён номер путевки, то остальные фильтры работать не будут, пока поле с номером путевки не станет пустым. Данное окно позволяет производить действия с одной или несколькими путевками, для этого просто выделите их левой кнопкой мыши.  
+
Окно импорт состоит из фильтров для отбора путевок и таблицы с результатами. Если был введён номер путевки, то остальные фильтры работать не будут, пока поле с номером путевки не станет пустым. Данное окно позволяет производить действия с одной или несколькими путевками, для этого просто выделите их левой кнопкой мыши.  
* При передаче путевки в TravelLine передается расчетный час из карточки отеля в Мастер-Туре. Если время не заведено, то пустое значение.
 
* Во внешних настройках, есть поле '''Записывать в МТ номер подтверждения'''
 
[[Файл: dk_17.png| ]]<br />
 
  
* Если проставить в этом поле галочку, то после отправки путевки и запроса статуса путевки нам возвращается номер брони. Его можно посмотреть в '''Работе менеджеров''' в поле '''Номер путевки партнера'''
+
[[Файл: TP_12.png|1000px| ]]<br />
[[Файл: dk_18.png|1000px| ]]<br />
 
  
* Также при передаче путевки передается фамилия, имя, е-mail, skype ведущего менеджера по туру и [[Мастер-Тур:Работа с путевкой#Сообщения по путевке|сообщение поставщику]]. Сообщение поставщику передается в историю направления (параметр "guestComment") и в промежуточную базу, если в направлении настроено логирование.
+
* Также при передаче путевки передается фамилия, имя, е-mail, skype ведущего менеджера по туру.
 
 
При успешной отправке путевки - в '''ПК Мастер-Тур -> Работа менеджеров -> поле ''Номер путевки партнера'' ''' записывается номер путевки в системе TravelLine. При не
 
успешной отправке записывается '''Отказ'''.  
 
  
 
====Первичное создание путевки во внешней системе====
 
====Первичное создание путевки во внешней системе====
Для выполнения данного действия необходимо с помощью фильтров отобрать необходимую путевку с сопоставленными услугами и вызвать меню, кликнув по ней правой кнопкой мыши и нажать на пункт '''Отправить путевку '''. После этого в первой колонке таблицы появиться прогресс бар, отражающий процесс отправки. По окончанию действия в случае успешной отправки значение в колонке '''Статус обмена''' станет '''Отправлена'''. В случае возникновения каких-либо ошибок в процессе отправки, они будут отображены в окне истории и на месте пропавшего прогресс бара, появиться знак предупреждения и при наведении мыши будет отображено сообщение с описанием ситуации, повлекшей возникновение ошибки.<br>
+
Для выполнения данного действия необходимо с помощью фильтров отобрать необходимую путевку с сопоставленными услугами и вызвать меню, кликнув по ней правой кнопкой мыши и нажать на пункт '''Отправить путевку '''. После этого в первой колонке таблицы появиться прогресс бар, отражающий процесс отправки. По окончанию действия в случае успешной отправки значение в колонке '''Статус обмена''' станет '''Отправлена'''. В случае возникновения каких-либо ошибок в процессе отправки, они будут отображены в окне истории и на месте пропавшего прогресс бара, появится знак предупреждения и при наведении мыши будет отображено сообщение с описанием ситуации, повлекшей возникновение ошибки.<br>
 +
Возраст ребёнка рассчитывается на момент бронирования.<br>
  
  
[[Файл:jk_218.png|800 px |Экран «Megatec Integration Service: TravelLine Бронирование путевок»]] <br>
+
[[Файл:TP_13.png|Экран «Megatec Integration Service: TravelLine Бронирование путевок»]] <br>
  
  
Также есть возможность передачи путевки, в которой не внесены даты рождения туристов. Если в путёвку в последующем будут внесены даты рождения туристов, то её нужно будет отправить повторно вручную. Для запуска автоотправки нужно:
 
* в экране редактирования направления на вкладке '''Внутренние настройки''' в колонке '''Автоматическая отправка путевок''' выбрать необходимый отель (или выбрать '''Все''');<br>
 
  
[[Файл:jk_219.png|500 px| Экран редактирования направления]] <br>
 
 
* запустить приложение '''Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe''' из командной строки с параметрами '''adapter:"Megatec.MasterTour.AdapterPlugins.Import.Travelline.dll"'''.
 
  
 
====Получение стоимости путевки во внешней системе ====
 
====Получение стоимости путевки во внешней системе ====
Строка 74: Строка 75:
  
 
====Отправка путевки на редактирование во внешней системе ====
 
====Отправка путевки на редактирование во внешней системе ====
При изменении любой информации в путевке, кроме статуса услуг и статуса путевки необходимо будет снова отправить данную путевку во внешнюю систему, но уже на редактирование. Об этом будет символизировать '''статус обмена''' - '''Требуется отправка''' и статус услуг сменится с любого состояния на статус - '''Не определен'''. Чтобы отправить путевку на редактирование надо снова вызвать меню работы с путевкой и выбрать пункт '''Отправить путевку'''. Актуальный код путевки в системе TravelLine, всегда будет отображен в колонке '''Доп информация'''.
+
При изменении любой информации в путевке, кроме статуса услуг и статуса путевки необходимо будет снова отправить данную путевку во внешнюю систему, но уже на редактирование. Об этом будет символизировать '''статус обмена''' - '''Требуется отправка''' и статус услуг сменится с любого состояния на статус - '''Не определен'''. Чтобы отправить путевку на редактирование надо снова вызвать меню работы с путевкой и выбрать пункт '''Отправить путевку'''. Актуальный код путевки внешней системы, всегда будет отображен в колонке '''Доп информация'''.
 +
 
 +
Изменения в путёвке, при которых статус обмена меняется на '''Требуется отправка''':
 +
номер путевки, номер авиарейса, название трансфера, название отеля, название экскурсии, название круизного судна, название страховки, название услуги, данные по услуге (проживание, питание), статус услуги, кол-во туристов, нетто, дата начала\окончания действия услуги, продолжительность, партнер, фамилия, имя, дата рождения туриста, данные загран.паспорта, данные общегражданского паспорта, возраст, пол, аннуляция путёвки,  дата расчета цены по услуге.
  
 
====Отправка путевки на аннуляцию во внешней системе====
 
====Отправка путевки на аннуляцию во внешней системе====
Строка 81: Строка 85:
 
===Проверка заявки===
 
===Проверка заявки===
  
После того, как путевка была успешно отправлена ('''Статус обмена''' - '''Отправлена''') во внешнюю систему, необходимо запросить статусы услуг, но перед этим надо сопоставить статусы услуг внешней системы со статусами «'''Мастер-Тура'''» в справочнике '''Получить статусы услуг'''. Чтобы проверить заявку необходимо кликнуть по ней правой кнопкой мыши и нажать на пункт '''Получить статусы услуг'''. В случае возникновения каких-либо ошибок в процессе проверки заявки, они будут отображены в окне истории и на месте пропавшего прогресс бара появиться знак предупреждения и при наведении мыши появиться сообщение с описанием ситуации, повлекшей возникновение ошибки. В случае успешной операции в колонке '''Статусы услуг''', будут отображены статусы услуг по отправленным услугам.  
+
После того, как путевка была успешно отправлена ('''Статус обмена''' - '''Отправлена''') во внешнюю систему, необходимо запросить статусы услуг, но перед этим надо сопоставить статусы услуг внешней системы со статусами «'''Мастер-Тура'''» в справочнике '''Получить статусы услуг'''. Чтобы проверить заявку необходимо кликнуть по ней правой кнопкой мыши и нажать на пункт '''Получить статусы услуг'''. В случае возникновения каких-либо ошибок в процессе проверки заявки, они будут отображены в окне истории и на месте пропавшего прогресс бара появится знак предупреждения и при наведении мыши появится сообщение с описанием ситуации, повлекшей возникновение ошибки. В случае успешной операции в колонке '''Статусы услуг''', будут отображены статусы услуг по отправленным услугам.  
 
Виды статусов:
 
Виды статусов:
 
*'''Waiting''' – внешняя система не определилась с ответом
 
*'''Waiting''' – внешняя система не определилась с ответом

Текущая версия на 11:52, 19 декабря 2023

Статья находится на стадии разработки.
Версия статьи от 19-12-2023.

Введение

Данное окно предназначено для отправки забронированных в ПК Мастер-Тур путевок во внешнюю систему с помощью MIS.

Описание экрана Бронирование путёвок

Отправка путевок - главное окно
После заведения путевки в Мастер-Туре на синхронизированного поставщика она появляется в данном окне. Чтобы обновить информацию в экране нужно нажать кнопку Поиск.

  • Номер путевки из Мастер-Тура.
  • Последний обмен – время последней отправки путевки.
  • Статус обмена – колонка, которая показывает текущий статус обмена по путевкам. Возможные варианты:
    • Не обработана – путевка ни разу не отправлялась во внешнюю систему.
    • Требуется отправка – данный статус путевка принимает только в том случае, если после успешной отправки путевки были изменения в ПК "Мастер-Тур", которые необходимо повторно отправить.
    • Отправлена – путевка успешно отправлена во внешнюю систему.
    • Ошибка – при попытке отправки путевки произошел сбой или есть несинхронизированные данные.
    • Забронирована – путевка успешно забронирована во внешней системе. (адаптер Terma)
    • Не отправлять – данный статус обмена присваивается путевке в том случае, если статус путевки в МТ не указан в списке статусов, подлежащих отправки. Перечень статусов путевок, подлежащих обмену указывается в общих настройках направления.
  • Статусы услуг – статусы услуг сопоставляются в окне синхронизации, после отправления заявки статус обновляется в зависимости от ответа. В экране Турпутевка «Мастер-Тур» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике Статусы услуг пользователем. Виды статусов:
    • Waiting – внешняя система не определилась с ответом.
    • Confirmed – услуга подтверждена.
    • NotConfirmed – услуга не подтверждена.
    • Не определен – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
  • Статус путевки (МТ) – статус путевки в Мастер-Туре.
  • Нетто планируемое – цена из поля "Нетто планируемое" в Мастер-туре.
  • Нетто от партнера – цена, пришедшая от внешней системы.
  • Филиал
  • Дата заезда
  • Покупатель
  • Дата создания
  • Отель
  • Доп информация – указывается номер брони, штрафы из внешней системы, поле есть не во всех адаптерах.

Контекстное меню путевки

В контекстном меню путевки возможны следующие действия:

  • Открыть путевку в Мастер-Туре
  • Отправить путевку
  • Проверить статус (не во всех адаптерах)
  • Аннулировать путевку
  • Скопировать номер путевки в буфер обмена

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

Основная информация по синхронизации справочников находится в статье Работа с окном Синхронизации.
Прежде чем приступить к отправке путевки необходимо:

  • Сопоставить партнеров в справочнике Партнеры поставщика, которые являются поставщиками услуг в путевке, желаемой для отправки во внешнюю систему.

Синхронизация партнеров поставщика

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

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

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

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

TP 12.png

  • Также при передаче путевки передается фамилия, имя, е-mail, skype ведущего менеджера по туру.

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

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


Экран «Megatec Integration Service: TravelLine Бронирование путевок»



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

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

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

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

Изменения в путёвке, при которых статус обмена меняется на Требуется отправка: номер путевки, номер авиарейса, название трансфера, название отеля, название экскурсии, название круизного судна, название страховки, название услуги, данные по услуге (проживание, питание), статус услуги, кол-во туристов, нетто, дата начала\окончания действия услуги, продолжительность, партнер, фамилия, имя, дата рождения туриста, данные загран.паспорта, данные общегражданского паспорта, возраст, пол, аннуляция путёвки, дата расчета цены по услуге.

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

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

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

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

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

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