SSO: создание пользователя на лету

1 Общее описание
2 Важные замечания

Общее описание

Классически, SSO позволяет перейти в систему пользователю, который уже в ней зарегистрирован. Однако, возможен сценарий, когда такого пользователя в Кортеос нет, и его нужно зарегистрировать в момент первого перехода в систему, условно говоря, “на лету”.

Для того, чтобы создать пользователя на лету, необходимо заполнить структуру AccountDetails так, как показано в примере:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sso="https://sso.corteos.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <sso:Set>
         <!--Optional:-->
         <sso:request>
            <sso:AccountDetails id_Group="ХХ" GroupSecurityKey="ХХХХХХХХХХХ" Email="themax1@elmotest.ru">
               <!--Optional:-->
               <sso:PersonToCreate LastName="Админских" FirstName="Максим" MiddleName="Валерьевич" 
               	LastNameLatin="Adminskih" FirstNameLatin="Maksim" MiddleNameLatin="Valerievich" Gender="true" DateBirth="2000-01-02">
                  <!--Optional:-->
                  <sso:INN>987987987</sso:INN>
                  <!--Optional:-->
                  <sso:KPP>779901001</sso:KPP>
                  <!--Optional:-->
                  <sso:CountryAlpha2>RU</sso:CountryAlpha2>
                  <!--Optional:-->
               </sso:PersonToCreate>
               <sso:id_Role>1</sso:id_Role>
            </sso:AccountDetails>
         </sso:request>
      </sso:Set>
   </soapenv:Body>
</soapenv:Envelope>

В этом случае, если пользователя с Email(в нашем примере - themax1@elmotest.ru - нет в системе, то он будет создан на лету.

Данные для персоны берутся из контейнера PersonToCreate, который имеет тип данных персона. Минимальный набор полей показан в примере, нужно передать:

LastName - фамилия персоны на русском языке, строка
FirstName - имя персоны на русском языке, строка
MiddleName - отчество персоны, если нет - передаем пробельный символ, строка.
LastNameLatin, FirstNameLatin, MiddleNameLatin - все то же самое, но на английском языке, строка. Если у вас в системе эти данные не хранятся, то русский аналог необходимо транслитерировать по ГОСТ 7.79-2000 (система Б)
Gender - true - мужчина, false - женщина
DateBirth - дата рождения, datetime
INN - ИНН организации, в которой работает персона, строка
KPP - КПП организации, в которой работает персона, строка. По полям ИНН и КПП мы привязываем персону к нужной компании
CountryAplha2 - alpha2 код страны, гражданином которой является персона.
id_Role - идентификатор роли пользователя, который будет создан в процессе SSO

Посмотреть идентификаторы, доступные в вашей компании, можно из-под пользователя с правами Тревел-Менеджера в меню “Настройки” - “Роли”:

Идентификаторы ролей показаны в первом столбце:

Дополнительно можно передавать контактные данные, структурные коды, документы по создаваемой персоне, аналогично тому, как мы передаем при передаче пассажира - детально можно посмотреть на SSO портале.

Важные замечания

Нужно ли дублировать данные персоны в пассажирах, если она передана как пользователь?

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

Что будет, если передать детали пользователя, а такой пользователь уже зарегистрирован в системе? Обновятся ли его данные?

Если пользователь уже зарегистрирован, элемент PersonToCreate не обрабатывается в принципе, обновить данные можно только через данные пассажиров.

Нужно ли активировать созданного через SSO пользователя в редакторе договора?

Нет. Пользователь активируется автоматически.