Megatec Integration Service: Модуль для передачи данных в ГИС ЭП (Электронная путевка)

Материал из Megatec
Перейти к: навигация, поиск

Версия статьи от 21-10-2024.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15 версии
Доступна с релиза 15.9


Введение

Адаптер ЭП (электронная путевка) предназначен для отправки путевок и изменений по ним, отправки аннулированных путевок во внешнюю систему ГИС Электронная путевка. Состоит из одной части Бронирование путевок.

Начало работы

Перед началом обмена данными с ПК ЭП пользователям требуется обратиться в техническую поддержку ГИС ЭП для подключения к системе. Подробнее о подключении на сайте.


Подключение включает:

  1. Получение VipNe PKi Client у разработчика. Для работы с ViP Net PKI Client не подходят токены, работающие с Крипто-Про. ViP Net PKI Client работает только со своими ключами. Подробнее на сайте ИнфоТеКС.
  2. Получение и установка сертификата для туристической компании.

Важная информация

Важно! При подаче заявления на тестовую версию, укажите что требуется TLS Unit – (компонент для обеспечения организации TLS-соединений со стороны клиента для защищенного доступа к порталам) для двусторонней аутентификации.


Инструкции по подключению на сайте ГИС Электронная путевка.

  • pilot.support@aontt.ru — Техническая поддержка демонстрационного стенда ЭП
  • support.ev@aontt.ru — Техническая поддержка продуктивного стенда ЭП
  • +7 495 230-31-71 — Телефон для связи

Системные требования

В качестве общего ПО на сервер Баз данных устанавливается:

  • ОС – MS Windows Server 2016 x64 или выше.
  • MS SQL Server 2014 или выше. При использовании Microsoft SQL Server 2017 необходимо проставить у базы данных уровень совместимости 140, иначе будут возникать ошибки, связанные с производительностью системы.

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

Основная информация по настройкам адаптеров находится в отдельной статье: Создание направления. Настройки. В данном разделе описаны только индивидуальные настройки ЭП (электронная путевка).

Внешние настройки

Внешние настройки

Необходимо заполнить следующие параметры:

  • Параметры подключения к веб-сервису:
    • Адрес веб-сервиса обмена путевками – ссылка на веб-сервис внешней системы для обмена путевками. Предоставляется внешней системой;
    • Адрес веб-сервиса получения справочников – ссылка на веб-сервис внешней системы для получения справочников. Предоставляется внешней системой;
    • Мнемоника – пароль для подключения. Предоставляется внешней системой;


Основная информация по настройкам и установке адаптеров находится в отдельной статье: Создание направления. Настройки.

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

Внутренние настройки

Внутренние настройки

  • Дата создания путевки, с которой будет вестись отправка путевок – данная настройка действует только при автоматической отправке путевок;
  • Статусы путевок на бронирование – статусы, при которых возможна отправка путевок на бронирование. По умолчанию статусы не выбраны;
  • Разрешить отправку путевок от частных лиц – разрешает отправку путевок от частных лиц;
  • Разрешить ручную отправку путевок с любым статусом – распространяется только на ручную отправку путевок.
  • Отображать итоговую полную стоимость – позволяет показывать сумму полной стоимости по выбранным путёвкам (без скидки). Данная информация отображается в левом нижнем углу, в экране: Работа с путевками. Пр расчёте общей суммы валюта путёвки не учитывается.
    • Так же данной настройко регулируется отображение полей в экране бронирования: Стоимость из МТ (руб), Стоимость из ЛК (руб). Если настройка выключена, то отображается стандартный экран.
  • Типы платежей исключающие отправку путевок – настройка позволяет установить ограничение на отправку путевок по отмеченным статусам платежей.
  • Классы услуг для отправки путевок – настройка позволяет установить блок на отображение в поиске путевок, у которых не отмечены услуги в настройках.
  • Типы платежей исключающие отправку путёвки – данная настройка позволяет указать один или несколько типов платежей, путевки по которым не будут отбираться в экране: Бронирование путевок.
  • Классы услуг для отправки путевок – данная настройка позволяет отображать в экране поиска МИС, только те путевки, напротив услуг которых, во внутренних настройках установлен чекбокс.
    • При поиске путевок будут отобраны только те, в которых есть все выбранные услуги. Если не выбрано ни одной услуги, в экране поиска отобразятся все путевки. По умолчанию настройка выключена.
  • Состояние платежа для отправки – служит для предварительной сортировки путевок по состоянию оплаты в поисковой выдаче. При включении одного или нескольких чек-боксов, в окне работы с путевками будут отображены только те, которые подпадают под следующие отмеченные статусы:
    • Полная оплата
    • Частичная оплата
    • Переплата

Загрузка справочников

Для начала работы необходимо загрузить справочники, для этого нужно нажать кнопку Кнопка «Загрузка из внешней системы», после чего откроется форма Загрузка из внешней системы, затем нажать кнопку Загрузить справочники.
В этом экране так же расположен экран для отправки покупателей\агентов в Электронную Путевку.
Загрузка справочников


Загрузка покупателей(агентов)

Отправка покупателей(агентов) в ЭП не является обязательной. Список агентов будет нужен только для внесения путёвок в л\к ЭП. Путёвка может быть отправлена без предварительной загрузки агентов  в ЭП из МИСа. Если агент  ранее не отправлялся, он будет добавлен как активный с теми данными, которые использованы в путёвке. Контактные данные указываются в каждой путёвке, они не обязательно должны совпадать с указанными данными при добавлении, но агент должн быть добалн в базу  ЕФРТА.

В колонку Покупатели(агенты) подгружаются записи из справочника Список партнеров у которых есть признак:

  • Дает клиентов

Для отправки покупателей(агентов) в электронную путевку необходимо, чтобы у них были заполнены обязательные поля в справочнике Список партнеров:

  • Полное название партнера
  • ИНН - корректный ИНН (10 или 12 символов)
  • Адрес - фактический адрес покупателя(агента), если нет, то юридический
  • Телефон. При отправке телефона во ВС МИС удаляет пробелы, скобки, тире и добавляет + к номеру телефона.
  • E-mail
  • Не отправлены в электронную путевку - данный функционал необходим для отображения не отправленных в электронную путевку агентов по отобранным путевкам. По умолчанию чек-боксы выключены.

В 9 версии ПК Мастер Тур покупателю Частное лицо нужно указать признак ЧЛ для отмены отправки в ЭП.

Те покупатели, у которых заполнены не все обязательные поля, в списке выделены красным.
Для отправки покупателя(агента) в электронную путевку нужно установить признак активности и нажать кнопку Отправить. По итогу отправки будут выведены сообщения о исходе отправки:

Сообщение об ошибке при отправке партнера

или

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

Синхронизация

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

Экран «Синхронизация»

Для адаптера необходимо синхронизировать следующие справочники:

  • Страны
  • Города – для городов есть возможность множественного сопоставления (один город из внешней системы с несколькими городами из справочника Города из ПК «Мастер-Тур»
  • Партнеры поставщика. Поставщики должны иметь признак Предоставляет сметные услуги. Поставщик с признаком ЧЛ (9 версия) не отображается в экране синхронизация.
  • Классы услуг – для классов услуг есть возможность множественного сопоставления, для отправки путевки, необходимо сопоставить следующие классы услуг:
    • Экскурсия
    • Прочее – этот класс сопоставляется с остальными классами услуг из ПК «Мастер-Тур», которые необходимо отправить (например: чтобы отправлялась Доп. услуга в отеле/круизе(ADHOT), нужно класс услуги Прочее из внешней системы сопоставить с классом услуги из МТ Доп. услуга в отеле/круизе(ADHOT))
  • ЖД перевозчики

Отправка путевок в ГИС ЭП

Отправка путевок в ГИС ЭП осуществляется из окна Megatec Integration Service: ЭП Бронирование путевок. Чтобы обновить информацию в экране нужно нажать кнопку Поиск. В список для отправки попадают все путевки, имеющие в своем составе услуги: отель + перевозка (авиаперелет/железнодорожный переезд/автобусный переезд/трансфер).
У туристов и представителя покупателя должны быть заполнены: фамилия, имя, дата рождения, паспорт (заграничный или внутренний), гражданство, адрес. Если у представителя покупателя заполнены не все требуемые данные, то отправляются данные главного туриста.


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




Фильтры туров

Фильтры распологаются в верхней части экрана Megatec Integration Service и служат для сортировки созданных для отправки путевок в ГИС Электронная путевка.

  • Филиал – cлужит для указания определенного филиала при сортировке путевок.
  • Страна – cлужит для указания страны тура при сортировке путевок.
  • Город – cлужит для указания города тура при сортировке путевок.
  • Множественная выборка по датам создания и окончания тура – cодержит в себе несколько параметров для поиска туров по датам, которые можно комбинировать между собой:
    • Дата создания
    • Дата заезда
    • Дата окончания
    • Дата подтверждения
  • Статус путевки – служит для сортировки путевок по их статусам в системе Мастер–Тур. Статусы будут идентичны тем, которые указаны в вашей системе.
  • Статус обмена – служит для сортировки туров по статусам обмена путевки с ГИС Электронная путевка. Содержит следующие статусы:
    • Все
    • Не обработана
    • Требуется отправка
    • Отправлена
    • Ошибка
    • Не отправлять
  • Номер путевки - служит для поиска созданного в системе тура по номеру путевки. При использовании данного фильтра все остальные при поиске будут проигнорированы.
  • Путёвки по всем поставщикам\покупателям – при включении данного чек-бокса отображаются все путевки по синхронизированным и несинхронизированным поставщикам и агентам.
  • Не показывать путевки с доп. информацией – при включении данного чек-бокса и нажатии кнопки Поиск отбираются путёвки, в которых незаполненно поле Доп. информация. Если чек-бокс выключен, то отбираются все путевки, независимо от наличия информации в поле Доп. информация. По умолчанию чек-бокс выключен.
    • Если поставщики и агенты синхронизированы с системой ГИС ЭП, то цвет номера путевки - черный.
    • Если поставщики и агенты не синхронизированы с системой ГИС ЭП, то цвет номера путевки - красный.


Описание полей таблицы

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

Отправка путевок в ГИС ЭП (Электронная_путевка)

Для отправки путёвок по стране Россия требуется передача когда региона. Данный код редактируется в поле региона в справочнике Города.
Am 063.png Для Мастер-Тур 2009 версии используется поле порядок для печати в справочнике Города.

Обмена статусами между MIS и электронной путевкой нет. При отправке путёвке используется статус отправки. Путевки со статусом Error во внешнюю систему не отправляются.

В ЭП отправляется полная стоимость по путевке в рублях. Если стоимость путёвки в валюте:

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

Если в экране Информация о заказе Мастер-Web, в поле Стоимость путевки для отправки в ГИС ЕИС Электронная путевка добавлена стоимость путевки, то будет отправляться указанная стоимость. Отображение поля Стоимость путевки для отправки в ГИС ЕИС Электронная путевка регулируется настройкой ListOfServiceClassesForSendingToEB в файле web.config MasterWeb и обрабатывается только для ПК Мастер-Тур 15. Если цена по путёвке в поле "Стоимость путевки для отправки в ГИС ЕИС Электронная путевка" не указана или работа с ЭП ведётся в ПК Мастер-Тур 9 , стоимость для отправки в ЭП будет рассчитываться по следующим правилам: .

1. Если путёвка полностью оплачена, стоимость рассчитывается по формуле: оплата в национальной валюте + комиссия агента (скидка покупателю) по курсу на дату последнего платежа(проводки) в кассе;
2. Если оплаты нет или она частичная, то расчёт производится "сумма в национальной валюте + скидка в национальной валюте".

В историю путёвки в сообщение покупателю записывается:
Номер ЭП 2121133748549903
логин\пароль для входа в л\к ЭП представителя покупателя 121133748549903 \ 977722
логин\пароль для входа в л\к ЭП туристов 2121133748549903 \ 254774, 2121133748549903 \ 254775
Номер ЭП дополнительно указывается в MIS, в поле доп. информация.

Обработка системных ошибок

При отправке путевки во внешнюю систему могут возникнуть ошибки, связанные с незаполненными полями партнера-покупателя или неполным количеством услуг:

  • Ошибка Ошибка «Не заполнен паспорт покупателя» говорит о том, что необходимо заполнить паспорт покупателя по путевке, для этого нужно зайти в ПК Мастер-тур -> Работа менеджеров -> найти путевку, которую нужно отправить -> по ней перейти в экран Турпутевка -> нажать кнопку Выбор покупателя -> после чего откроется форма Выбор покупателя для оформления заявки -> в ней у выбранного покупателя вносим паспорт (серию и номер).

Выбор покупателя

  • Ошибка Ошибка «Отсутствует необходимый набор услуг» говорит о том, что в путевке нет необходимого набора услуг отель + перевозка (а именно: авиаперелет/железнодорожный переезд/автобусный переезд/трансфер). Путевки без необходимого набора услуг не отправляются.
  • Ошибка Ошибка «Не заполнен код региона в справочнике Города» говорит о том, что в путевке не заполнен код региона в справочнике Города. Путевки по России требуют код региона в обязательном порядке, в случае отсутствия региона путевка не отправляется.
  • При отправке путёвки с покупателем-агентом, который не добавлен в базу ЕФРТА, от системы ГИСЭП будет приходить ошибка. Подробнее о ошибках в документации ГИС ЕИС ЭП.


Так же сведения об ошибках выводятся в историю (можно просмотреть по нажатию на кнопку История).

Полезные материалы