Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия) — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][непроверенная версия]
(Импорт цен за отели)
(Синхронизация справочников)
Строка 18: Строка 18:
 
  Для объединенной записи из '''внешней системы "Типы и категории номеров"''' нужно '''отдельно''' сопоставить '''"Тип номера"''' и '''"Категория номера"''' из справочника Мастер-Тура.  
 
  Для объединенной записи из '''внешней системы "Типы и категории номеров"''' нужно '''отдельно''' сопоставить '''"Тип номера"''' и '''"Категория номера"''' из справочника Мастер-Тура.  
 
[[Файл:Ud_246.png|Синхронизация типа и категории номера|800px]] <br>
 
[[Файл:Ud_246.png|Синхронизация типа и категории номера|800px]] <br>
 +
 +
 +
 +
На экране загрузки реализована возможность ( в зависимости от настроек usersrtting ) сохранения значения "Загружать импортированные" ( вкл/выкл ).
 +
 
==Импорт квот за отели==
 
==Импорт квот за отели==
 
'''Основная информация по импорте квот за отели находится в отдельной статье: [[Megatec_Integration_Service:Работа_с_окном_Импорт_в_адаптере_«Импорт_квот»_и_«Импорт_наличия_мест»|Работа с окном «Импорт квот за отели»]].''' <br>
 
'''Основная информация по импорте квот за отели находится в отдельной статье: [[Megatec_Integration_Service:Работа_с_окном_Импорт_в_адаптере_«Импорт_квот»_и_«Импорт_наличия_мест»|Работа с окном «Импорт квот за отели»]].''' <br>

Версия 16:02, 22 сентября 2017

Статья находится в стадии разработки.

Введение

Адаптер TravelLine состоит из 3-х частей:

  • Бронирование путевок
  • Импорт квот за отели
  • Импорт цен за отели

Настройка адаптера

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

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

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

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

В адаптере TravelLine "Тип номера" и "Категория номера" объединены в единый справочник "Типы и категории номеров". 
Для объединенной записи из внешней системы "Типы и категории номеров" нужно отдельно сопоставить "Тип номера" и "Категория номера" из справочника Мастер-Тура. 

Синхронизация типа и категории номера


На экране загрузки реализована возможность ( в зависимости от настроек usersrtting ) сохранения значения "Загружать импортированные" ( вкл/выкл ).

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

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

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

  • Для типов : Если одна внешняя запись соответствует нескольким записям МТ , тогда эту квоту кладем на несколько МТ записей.

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

Основная информация по импорте цен за отели находится в отдельной статье: Работа с окном «Импорт цен за отели».
Для импорта цен сначала необходимо загрузить справочники и цены. Для этого нужно нажать на кнопку "Загрузка из внешней системы" Кнопка "Загрузка квот из внешней системы". Откроется следующее окно:
Загрузка цен из внешней системы
Для загрузки/обновления информации по справочникам, по которым доступны новые цены надо нажать "Загрузить справочники".
"Загрузить изменения по ценам" (то, что работает сейчас) и "Загрузить все цены" (все имеющиеся цены удаляются и грузятся заново).

В окне Импорт цен можно скорректировать Брутто и Нетто для загрузки в ПК «Мастер-Тур».

Предупреждение


Для корректной работы необходимо, чтобы настройка NewRecalculatePrice таблицы [SystemSettings] имела значение 0.



Ak 093.png

Удаление цен

Снятие цен с продажи

Отель в программе TravelLine может снять с продажи уже закаченные цены.
В экране "Импорт цен" неактуальные цены будут иметь статус "удаленные" и после импорта удалятся из базы Мастер-Тура.
Также удаленные цены перестанут отображаться в экране "Импорт цен" TravelLine. Количество удаленных цен будет указано в сообщениях о результатах импорта.

Удаление синхронизации

В случае удаления какой-либо синхронизации, привязанной к отелю (тип номера/категория, тип размещения, туры), по которой уже были закачаны цены, выдается сообщение "Данное сопоставление использовалось при загрузке цен. Удалить загруженные цены?".
При положительном ответе все связанные цены в данном отеле удаляются в базе Мастер-Тура, а в промежуточной базе убирается пометка о том, что цены закачаны и счетчики импорта цены обнуляются.
Для новой закачки цен потребуется новое сопоставление справочников.

Ограничение на срок запроса данных

Ранее были случаи, когда Мастер-Тур (Дельфин) запрашивал данные на большой промежуток времени назад.
В нашей системе есть определенные ограничения, которые не позволяют выполнять подобные запросы.
В связи с этим, мы вводим ограничение, что данные можно запрашивать максимум на 15 дней назад.
В иных случаях будет возвращаться ошибка.

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

Отправка путевок - главное окно
После заведения путевки в Мастер-Туре [уточнить при каких условиях, поставщик] она появляется в данном окне.

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


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

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


Примечания к путевке:

При бронировании передавать сообщения поставщику (MTP) в guestComment.
Если их несколько в путевке, передавать все, каждый раз при передаче путевки. Комментарий ТревелЛайна:guestComment encoded-строка с комментарием гостя.
Данное поле может быть использовано для передачи в отель особых пожеланий гостя, например: «номер не выше третьего этажа».


Ak 093.png


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

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

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

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

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

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

  • При передаче путевки в TravelLine передается расчетный час из карточки отеля в Мастер-Туре. Если время не заведено, то пустое значение.

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

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

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

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

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

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

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

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

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

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

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

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