Предварительные настройки:

1. https://corteos-platform.atlassian.net/wiki/x/acsK

2. Активировать моды.
В данной задаче моды достаточно просто активировать, через тревел менеджмент управляем настройками клиента от его имени и включаем чекбоксы для того, чтобы моды заработали. Настройку производить нет необходимости сверх базовых настроек SSO-портала
мод Интеграция с SSO.
мод Контейнер командировки: жесткое сохранение структуры маршрута

Web Services

Описание службы: http://test.sso.corteos.ru/XmlGate/DataService.asmx
Файл WSDL: https://test.sso.corteos.ru/XmlGate/DataService.asmx?WSDL

Сценарий использования
При переходе при помощи SSO, мы инициализируем Setзапрос при помощи следующих данных:

Запрос состоит:
<sso:OuterId>-идентификатор командировки, уникальный номер ( если такой номер командировки уже существует, то произойдет обновление данных)

Маршрут:

<sso:CurrentRoute>содержит маршрут командировки</sso:CurrentRoute>
<sso:RoutePart>содержит часть маршрута</sso:RoutePart>
<sso:CustomRoute>содержит полный

маршрут и указываются необходимые услуги</sso:CustomRoute>

<sso:DateDepart> –datetime,  дата отправления пассажира в пункт назначения,
<sso:Origin>-string, начальная точка маршрута. Здесь маршрут начинается в Москве.
<sso:Destination>-string, конечная точка маршрута. Путешествие заканчивается в Санкт-Петербурге.
<sso:ServiceType>Тип услуги.
<sso:ServiceType>transport,lodging</sso:ServiceType> - в этом случае транспорт и проживание (в тамлайне командировки будет показан блок проживание).
<sso:ServiceType>transport</sso:ServiceType> - в этом случае услуга относится к транспортной категории (в тамлайне командировки будт показаны услуги только транспортной категории).
<sso:DepartureAdvanceShiftDays> - количество дней до даты отправления, когда возможно забронировать билет. Здесь оно равно нулю, значит бронирование доступно только в день отправления.
<sso:DeparturePostShiftDays> - период после даты отправления, в течение которого еще возможно забронировать билет. Здесь также равно нулю, значит после даты отправления билеты уже недоступны для бронирования.
<sso:ReturnAdvanceShiftDays>0</sso:ReturnAdvanceShiftDays>-количество дней до даты прибытия, когда возможно забронировать билет. Здесь оно равно нулю, значит бронирование доступно только в день отправления.
<sso:ReturnPostShiftDays>0</sso:ReturnPostShiftDays>-количество дней после даты прибытия, когда возможно забронировать билет. Здесь оно равно нулю, значит бронирование доступно только в день отправления.
<sso:BookingSequence>- в том случае, если нам нужно бронировать услуги друг за другом(например, сперва один участок, а потом другой), то тут передаем последовательность этой процедуры бронирования. Если мы работаем в стандартном режиме: сперва транспорт, потом гостиницы, потом сервисы, то всегда передаем 1

Бизнес-правила:
<sso:CustomOption>-контейнер бизнес-правил в формате ключ-значение(строки), которые содержат информацию о том, как должна система вести себя с командировкой</sso:CustomOption>

<sso:Key>routeControl</sso:Key>- включает или выключает логику контроля маршрута,true для командировок, false для личных поездок

<sso:Key>automaticServices</sso:Key>- transport,hotel - какие услуги можно бронировать в автоматическом режиме(типы услуг, доступны transport - авиа или жд и hotel - гостиница)

<sso:Key>updateMode</sso:Key> - говорит о том, что нужно обновить информацию о командировке

Данные о пассажире:

LastName-string, фамилия персоны на русском языке,
FirstName-string, имя персоны на русском языке,
MiddleName-string, отчество персоны, если нет - передаем пробельный символ,
LastNameLatin FirstNameLatin MiddleNameLatin-string, все то же самое, но на английском языке, строка. Если у вас в системе эти данные не хранятся, то русский аналог необходимо транслитерировать по ГОСТ 7.79-2000 (система Б)
Gender- true - мужчина, false - женщина,
DateBirth -datetime, дата рождения,
INN -int, ИНН организации, в которой работает персона,
KPP -int, КПП организации, в которой работает персона
По полям ИНН и КПП мы привязываем персону к нужной компании.
CountryAlpha2- код страны, гражданином которой является персона,
Document CountryCode- документ какой страны, код страны,
DocumentNumber- номер документа,
DocumentType - какой документ,
DateValid - срок действия документа,
ContactType - тип контакта,
Value- номер телефона,
DictionaryName - название справочника структурных кодов
CodeValue -значение кода, предполагается, что оно должно быть уникально внутри справочника,
IsPrimaryKey - true позволяет определить, какой код отвечает за идентификатор пользователя. По этому параметру синхронизируются данные из запроса с данными в БД и обновляются значениями, передаваемыми в запросе.

Данные для авторизации пользователя из внутренней клиентской системы Corteos:

AccountDetails - данные для авторизации пользователя из внутренней клиентской системы Corteos
id_Group-int, идентификатор компании заказчика,
GroupSecurityKey- ключ для SSO,
Email - это логин пользователя, который создает командировку,
id_Role - роль пользователя, который создает командировку,
Параметры id_Group и GroupSecurityKey для AccountDetails предоставляются агентством,также их можно определить в настройках договора:

Open

Пример ответа:

В ответе веб-сервиса нам следует обратить внимание на поле CorteosId (69строка)
Значение выглядит таким образом:

Данный идентификатор мы используем при SSO переходе на адрес:
https://домен/mods/ssoentrance/go?portalId=CorteosId

В процессе перехода по ссылке будет создана или изменена командировка с указанным номером в запросе OuterId и пользователь попадёт на страницу созданной (измененной) командировки.

При подключенном "Контейнер командировки: жесткое сохранение структуры маршрута" (ModComplexReserveRouteValidation) будет автоматически отрисован таймлайн поездки на основании тех параметров, которые были указаны при создании командировки.

Open