Corteos — различия между версиями
Строка 134: | Строка 134: | ||
[[Image: Corteos_pax.png|center|580px]] | [[Image: Corteos_pax.png|center|580px]] | ||
{{warn|При синхронизации UDIDs в путешественниках и продуктах имя структурного кода в Corteos будет сравниваться с именем категории udid в организации в МОМ.}} | {{warn|При синхронизации UDIDs в путешественниках и продуктах имя структурного кода в Corteos будет сравниваться с именем категории udid в организации в МОМ.}} | ||
+ | |||
+ | |||
+ | ==Синхронизация заказов== | ||
+ | ===Автоматическое обновление заказов из Corteos в МОМ (Corteos 3)=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Чтобы при смене статуса заказа в Corteus 3 данные автоматически передавались в МОМ, необходимо сделать дополнительные настройки на стороне Corteos. | ||
+ | <br/> | ||
+ | Для этого в Corteos нужно включить Callback по заказам и указать адрес | ||
+ | </p> | ||
+ | <pre>http://ip:port/corteos/corteos</pre> | ||
+ | где '''ip:port''' - адрес сервера МОМ. В поле '''"Body"''' нужно указать следующее: | ||
+ | |||
+ | <pre> | ||
+ | <Order> | ||
+ | <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> | ||
+ | <id_Reserve>@id_Reserve</id_Reserve> | ||
+ | <EventType>@EventType</EventType> | ||
+ | <ReserveState>@ReserveState</ReserveState> | ||
+ | <ComplexState>@ComplexState</ComplexState> | ||
+ | <EventDescription>@EventDescription</EventDescription> | ||
+ | <CallbackId>@CallbackId</CallbackId> | ||
+ | </Order> | ||
+ | </pre> | ||
+ | |||
+ | Пример настройки: | ||
+ | [[Image: Corteus_order_callback.png|center|380px]] | ||
+ | |||
+ | ===Автоматическое обновление заказов из Corteos в МОМ (Corteos 2)=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Аналогично настройкам для 3 версии Corteos, можно настроить получение данных в МОМ из Corteos 2 при смене статуса заказа. | ||
+ | <br/> | ||
+ | Для этого в Corteos 2 нужно включить Callback по заказам и указать адрес | ||
+ | </p> | ||
+ | <pre>http://ip:port/corteos/corteos</pre> | ||
+ | где '''"ip:port"''' - адрес сервера МОМ. В поле '''"Body"''' нужно указать следующее: | ||
+ | <pre> | ||
+ | <OrderV2> | ||
+ | <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> | ||
+ | <id_Reserve>@id_Reserve</id_Reserve> | ||
+ | <EventType>@EventType</EventType> | ||
+ | <EventDescription>@EventDescription</EventDescription> | ||
+ | </OrderV2> | ||
+ | </pre> | ||
+ | |||
+ | Пример настройки: | ||
+ | [[Image: Corteus_order_callback_2ver.png|center|380px]] | ||
+ | |||
+ | ===Ручное обновление заказов из Corteos в МОМ=== | ||
+ | Обновить данные в МОМ из командировок Corteos можно вручную, для чего нужно нажать кнопку "Создать", выбрать раздел "Заказы и услуги" и воспользоваться кнопкой "Заказ Corteos", где в диалоговом окне указать номер командировки. | ||
+ | |||
+ | ===«Привязка» бронирования к заказу в Corteos 2=== | ||
+ | |||
+ | Если бронирование было создано в Corteos 2 только для согласования, а выписывалась билеты в GDS c другим номером бронирования (PNR), то можно привязать это бронирование к заказу в Corteos кнопкой "Привязать продукты к Corteos" справа на зеленой панели. | ||
+ | В диалоговом окне для этого нужно выбрать продукты для привязки к заказу Corteos и ввести номер заказа (''не командировки''): | ||
+ | [[Image: Corteos_order_connection.png|center|380px]] |
Версия 15:54, 2 ноября 2020
Содержание |
Введение
Для поддержания актуальности профилей путешественников как на стороне Mid Office Manager, так и на стороне Corteos, а также получения данных всех продаж в МОМ реализован функционал синхронизации данных между этими двумя системами.
Поскольку сейчас актуальны две версии Corteos – вторая и третья, и может быть, что часть клиентов агентства работает еще на второй версии, а часть уже переведена на третью, ниже будут отдельно указаны настройки для каждой из версий и помимо общей настройки, частично эти настройки (как раз касающиеся версии Corteos) будут указаны именно в профиле клиента.
Настройки подключения
Общая настройка
Функционал синхронизации с Corteos настраивается в системном свойстве «Настройки Corteos»:
Для внесения изменений в системном свойстве нужно нажать кнопку «Меню», выбрать раздел «параметры» и развернуть панель «Системные свойства». Если в списке системных свойств данное свойство отсутствует, добавьте его с помощью кнопки «+».
Описание полей системного свойства:
Наименование поля | Описание |
---|---|
Название | Название самого системного свойства |
Синхронизация включена | Общая активация синхронизации с Corteos. Включение синхронизации в этой настройке также влияет на отображение связанных с Corteos кнопок, элементов в редакторе профилей и справочников. |
Логин | Параметр учетных данных для подключения к Corteos |
Пароль | Параметр учетных данных для подключения к Corteos |
Адрес сервера | Адрес для подключения к актуальной (третьей) версии Corteos |
Адрес сервера (Corteos 2) | Адрес ко второй версии Corteos для загрузки заказов, если кто-то из клиентов не перешёл на новую версию |
Настройки GDS | Секция предназначена для настройки параметров, которые будут выставлены в загруженных из Corteos продуктах, т.е. в зависимости от системы бронирования будут прописываться в заказ МОМ параметры валидатора |
Настройки отельных поставщиков | Секция предназначена для настройки параметров, которые будут выставлены в загруженных из Corteos продуктах |
Настройка профиля корпоративного клиента
Для синхронизации данных необходимо заполнить вкладку с данными организации-клиента. Т.е. нужно открыть профиль корпоративного клиента и перейти в панель "Синхронизация в Corteos"
Значение поля «Id в Corteos» находится в Corteos на списке организаций:
Значение поля «Номер клиентского договора» находится в Corteos на списке договоров:
Значение поля «Номер группы компаний» находится в Corteos в договоре в поле «Идентификатор группы компаний клиента для API»:
Раздел «Синхронизация путешественников» включает синхронизацию UDIDs (структурных кодов) в 2 и/или 3 версию Corteos. Раздел «Загрузка заказов» влияет на то, из какой версии Corteos будут грузиться заказы в МОМ (только для кнопки «Создать/Заказ Corteos»).
Синхронизация профилей путешественников
Первоначальная однократная загрузка профилей из Corteos в МОМ
Загрузка профилей осуществляется с помощью задачи "Загрузка путешественников из Corteos". Эта задача хорошо подходит для связи профилей в самом начале интеграции Corteos и МОМ, т.е. у агентства уже есть структура профилей в Corteos, а в МОМ пока профилей путешественников нет. В таком случае агентству необходимо создать профили организаций и внести в них настройки синхронизации с Corteos, а потом воспользоваться данной задачей.
При её запуске можно указать, для каких именно организаций выгружать путешественников (по умолчанию выгружаются для всех имеющихся в МОМ организаций с настройками синхронизации с Corteos) и режим работы задачи (всех ли путешественников выгружать).
Задача выгружает все профили для выбранных (или всех) организаций. В случае, если профиль был синхронизирован с Corteos ранее, не делается ничего. В случае, если похожий профиль найден в МОМ, она его обновляет. В случае, если профиль не найден в МОМ - создается новый с нуля.
Подробные результаты работы задачи сохраняются в текстовом файле в папке logs\corteos.
Для запуска задачи нужно зайти в "Меню", нажать кнопку "Задачи" и на списке с помощью кнопки "+" добавить задачу "Загрузка путешественников из Corteos". В открывшемся диалоговом окне указать параметры запускаемой задачи.
Если оставить пустым поле "Дата и время запуска", то задача начнет выполняться немедленно по сохранении.
Поле "Нода" стоит оставить пустым, если МОМ работает на одном сервере.
В секции "Параметры задачи" как было упомянуто выше, можно добавить два параметра"
"Только работников следующих организаций" - где можно указать, сотрудники каких конкретно организаций должны быть синхронизированы. Для выбора доступны только те компании, в профили которых внесены настройки синхронизации.
"Режим работы задачи" - определяет, как именно профили путешественников будут синхронизированы.
"Все профили" - будут обновлены все профили, будут ли они новыми для МОМ, профилями, где есть ключевые различия с данными Corteos или полностью совпадающими. Сравнение профилей идет по полям ФИО на русском и английском, дате рождения, гражданству и номерам паспортов.
"Только новые и профили без отличий" - будут добавлены новые профили и в профили, где все данные совпадают с Corteos будут прописаны ID профилей в Corteos и не основные поля.
"Только новые профили" - будут добавлены только новые профили.
"Только результаты" - обновление профилей проводиться не будет, будет заполнен лог, какие действия были бы выполнены при выборе варианта "Все профили".
Автоматическая загрузка профилей из Corteos в МОМ
Для получения всех изменений, произведенных на стороне Corteos, нужно настроить функцию callback от Corteos 3. Если настроить отправку callback по статике (а в терминологии Corteos к статике относятся в том числе профили) в настройках Corteos (см. скриншот), и указать там url http://ваш ip: ваш port/corteos/corteos, где "ip:port" - адрес сервера МОМ, то при изменении персон в Corteos будет отправляться post запрос в MOM, который будет обновлять соответствующий профиль путешественника. В поле body настройки должно быть указано следующее:
<Change> <Before> @Before </Before> <After> @After </After> </Change>
Автоматическая загрузка профилей из МОМ в Corteos
Автоматическая загрузка профилей предназначена для синхронизации данных при постоянной работе с ними в Corteos, чтобы все изменения на стороне Corteos автоматически попадали в МОМ.
Включается такая синхронизация с помощью задач планировщика "Автоматическая синхронизация профилей в Corteos". Для включения нужно зайти в "Меню", нажать кнопку "Параметры", развернуть панель "Задачи планировщика", выбрать в списке (или добавить, если в списке она отсутствует) задачу "Автоматическая синхронизация профилей в Corteos" и в поле "Активна" выбрать значение "Да":
Ручная загрузка профилей из МОМ в Corteos и обратно
Cинхронизация путешественников выполняется с помощью кнопок "Синхронизировать в Corteos" для профилей, которые создавались в МОМ и в Corteos их пока нет и "Обновить из Corteos". Обе кнопки доступны как в профиле путешественника, так и на списке путешественников.
Также для загрузки нового путешественника из Corteos в МОМ в ручном режиме можно воспользоваться кнопкой "Путешественник Corteos", для чего нажать кнопку "Создать" и зайти в раздел "Профили". В появившемся диалоговом окне нужно указать организацию, чей это сотрудник, а также ID профиля в Corteos:
При синхронизации UDIDs в путешественниках и продуктах имя структурного кода в Corteos будет сравниваться с именем категории udid в организации в МОМ. |
Синхронизация заказов
Автоматическое обновление заказов из Corteos в МОМ (Corteos 3)
Чтобы при смене статуса заказа в Corteus 3 данные автоматически передавались в МОМ, необходимо сделать дополнительные настройки на стороне Corteos.
Для этого в Corteos нужно включить Callback по заказам и указать адрес
http://ip:port/corteos/corteos
где ip:port - адрес сервера МОМ. В поле "Body" нужно указать следующее:
<Order> <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> <id_Reserve>@id_Reserve</id_Reserve> <EventType>@EventType</EventType> <ReserveState>@ReserveState</ReserveState> <ComplexState>@ComplexState</ComplexState> <EventDescription>@EventDescription</EventDescription> <CallbackId>@CallbackId</CallbackId> </Order>
Пример настройки:
Автоматическое обновление заказов из Corteos в МОМ (Corteos 2)
Аналогично настройкам для 3 версии Corteos, можно настроить получение данных в МОМ из Corteos 2 при смене статуса заказа.
Для этого в Corteos 2 нужно включить Callback по заказам и указать адрес
http://ip:port/corteos/corteos
где "ip:port" - адрес сервера МОМ. В поле "Body" нужно указать следующее:
<OrderV2> <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> <id_Reserve>@id_Reserve</id_Reserve> <EventType>@EventType</EventType> <EventDescription>@EventDescription</EventDescription> </OrderV2>
Пример настройки:
Ручное обновление заказов из Corteos в МОМ
Обновить данные в МОМ из командировок Corteos можно вручную, для чего нужно нажать кнопку "Создать", выбрать раздел "Заказы и услуги" и воспользоваться кнопкой "Заказ Corteos", где в диалоговом окне указать номер командировки.
«Привязка» бронирования к заказу в Corteos 2
Если бронирование было создано в Corteos 2 только для согласования, а выписывалась билеты в GDS c другим номером бронирования (PNR), то можно привязать это бронирование к заказу в Corteos кнопкой "Привязать продукты к Corteos" справа на зеленой панели. В диалоговом окне для этого нужно выбрать продукты для привязки к заказу Corteos и ввести номер заказа (не командировки):