Megatec Integration Service: Модуль для передачи данных в ГИС ЭП (Электронная путевка)
Версия статьи от 23-03-2023.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
Введение
Адаптер EP (электронная путевка) предназначен для отправки путевок и изменений по ним, отправки аннулированных путевок во внешнюю систему. Состоит из одной части Бронирование путевок.
Перед началом обмена данными с ПК ЭП пользователям требуется обратиться в тех поддержку ЭП для подключения к системе, подробнее https://ev.tourism.gov.ru/.
Подключение включает:
1. Получение VipNe PKi Client у разработчика https://infotecs.ru/product/vipnet-pki-client.html#soft.
ВАЖНО! При подаче заявления на тестовую версию, укажите что требуется TLS Unit для двусторонней аутентификации.
Инструкции по подключению. https://eisep.ru/и https://ev.tourism.gov.ru/
pilot.support@aontt.ru — Техническая поддержка демонстрационного стенда ЭП
support.ev@aontt.ru — Техническая поддержка продуктивного стенда ЭП
+7 495 230-31-71
2. Получение и установка сертификата для туристической компании компании.
Настройки адаптера
Основная информация по настройкам адаптеров находится в отдельной статье: Создание направления. Настройки. В данном разделе описаны только индивидуальные настройки EP(электронная путевка).
Внешние настройки
Основная информация по настройкам адаптеров находится в отдельной статье: Создание направления. Настройки.
Необходимо заполнить следующие параметры:
- Параметры подключения к веб-сервису:
- Адрес веб-сервиса обмена путевками – ссылка на веб-сервис внешней системы для обмена путевками. Предоставляется внешней системой;
- Адрес веб-сервиса получения справочников – ссылка на веб-сервис внешней системы для получения справочников. Предоставляется внешней системой;
- Мнемоника – пароль для подключения. Предоставляется внешней системой;
После заполнения параметров подключения к веб-сервису рекомендуется нажать кнопку Проверить настройки, чтобы убедиться, что учетные данные введены верно.
Внутренние настройки
- Дата создания путевки, с которой будет вестись отправка путевок – данная настройка действует только при автоматической отправке путевок;
- Статусы путевок на бронирование – статусы, при которых возможна отправка путевок на бронирование. По умолчанию статусы не выбраны;
- Разрешить отправку путевок от частных лиц – разрешает отправку путевок от частных лиц;
- Разрешить ручную отправку путевок с любым статусом – распространяется только на ручную отправку путевок.
Загрузка справочников
Для начала работы необходимо загрузить справочники, для этого нужно нажать кнопку , после чего откроется форма Загрузка из внешней системы, затем нажать кнопку Загрузить справочники:
Так же на этой форме нужно отметить партнеров и покупателей(агентов) и отправить их в электронную путевку.
Загрузка партнеров
В колонку Партнеры подгружаются записи из справочника Список партнеров у которых есть какой то из признаков:
- Предоставляет сметные услуги
- Авиаперевозчик
Для отправки партнеров в электронную путевку необходимо, чтобы у них были заполнены обязательные поля в справочнике Список партнеров:
- Полное название партнера
- Телефон
Те партнеры, у которых заполнены не все обязательные поля, в списке выделены красным.
Для отправки партнера в электронную путевку нужно установить признак активности у партнера и нажать кнопку Отправить. По итогу отправки будут выведены сообщения о исходе отправки:
или
Если партнер был отправлен в электронную путевку, но перед новой отправкой у него признак активности отключили, в электронную путевку будет отправлена отметка о деактивации записи.
Загрузка покупателей(агентов)
В колонку Покупатели(агенты) подгружаются записи из справочника Список партнеров у которых есть признак:
- Дает клиентов
Для отправки покупателей(агентов) в электронную путевку необходимо, чтобы у них были заполнены обязательные поля в справочнике Список партнеров:
- Полное название партнера
- ИНН
- Адрес - фактический адрес покупателя(агента), если нет, то юридический
- Телефон
Те покупатели(агенты), у которых заполнены не все обязательные поля, в списке выделены красным.
Для отправки покупателя(агента) в электронную путевку нужно установить признак активности и нажать кнопку Отправить. По итогу отправки будут выведены сообщения о исходе отправки:
или
Синхронизация
Основная информация по синхронизации справочников находится в статье: Работа с окном Синхронизации.
Для адаптера необходимо синхронизировать следующие справочники:
- Страны
- Города
- Партнеры поставщика
- Классы услуг ( в ЭП из дополнительных услуг передаются данные только по услуге Экскурсия)
- ЖД перевозчики
Бронирование путевок
Создание путевки во внешней системе происходит после ее того как будет создан тур с услугами (отель + перевозка (авиаперелет/железнодорожный переезд/автобусный переезд/трансфер) и по нему забронирована путевка( поиск и бронирование путевок можно осуществить в Canary, TourSearchClient, оформлении клиентов). Из дополнительный услуг в ЭП отправляются данные только по услуге экскурсия. После того, как путевка создана она появляется в окне Megatec Integration Service: ЭП Бронирование путевок. Чтобы обновить информацию в экране нужно нажать кнопку Поиск.
- Номер путевки из Мастер-Тура.
- Последний обмен – время последней отправки путевки.
- Статус обмена:
- Требуется отправка – данный статус путевка принимает только в том случае, если после успешной отправки путевки были изменения в ПК "Мастер-Тур", которые необходимо повторно отправить.
- Отправлена – путевка успешно отправлена во внешнюю систему.
- Ошибка – при попытке отправки путевки произошел сбой или есть несинхронизированные данные.
- Не отправлять – если путевка содержит статус, который не участвует в обмене, то ей присваивается статус 'Не отправлять'.
- Статусы услуг – статусы услуг сопоставляются в окне синхронизации, после отправления заявки статус обновляется в зависимости от ответа. В экране Турпутевка «Мастер-Тур» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике Статусы услуг пользователем. Виды статусов:
- Waiting – внешняя система не определилась с ответом.
- Confirmed – услуга подтверждена.
- NotConfirmed – услуга не подтверждена.
- Не определен – проверка заявки ещё ни разу не происходила или необходимо снова отправить запрос в связи с изменениями услуг в путевке.
- Статус путевки (МТ) – статус путевки в Мастер-Туре.
- Нетто планируемое – цена из поля "Нетто планируемое" в Мастер-туре.
- Нетто от партнера – цена, пришедшая от внешней системы.
- Филиал – филиал бронирования
- Дата заезда – дата заезда по путевке
- Покупатель – покупатель при бронировании
- Дата создания – дата создания путевки в Мастер-туре
- Отель – отель, в котором создана бронь
- Доп информация – номер брони во внешней системе
Обмена статусами между MIS и электронной путевкой нет, при отправке путёвке ориентируемся на статус отправки. Путевки со статусом Error во внешнюю систему не отправляются.
При отправке путевки во внешнюю систему могут возникнуть ошибки, связанные с незаполненными полями партнера-покупателя или неполным количеством услуг:
- Ошибка говорит о том, что необходимо заполнить паспорт покупателя по путевке, для этого нужно зайти в ПК Мастер-тур -> Работа менеджеров -> найти путевку, которую нужно отправить -> по ней перейти в экран Турпутевка -> нажать кнопку Выбор покупателя -> после чего откроется форма Выбор покупателя для оформления заявки -> в ней у выбранного покупателя вносим паспорт (серию и номер)
- Ошибка говорит о том, что в путевке нет необходимого набора услуг отель + перевозка (а именно: авиаперелет/железнодорожный переезд/автобусный переезд/трансфер). Путевки без необходимого набора услуг не отправляются.
Так же сведения об ошибках выводятся в историю (можно просмотреть по нажатию на кнопку ).