1. Переход для создания новой командировки

Необходимо передать данные о маршруте следования, номере командировки, пассажирах, а также об инициаторе.

Пример запроса:

 <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:OuterId>123456789</sso:OuterId>
            <!--Optional:-->
            <sso:CurrentRoute>
               <!--Optional:-->
               <sso:Origin>Москва</sso:Origin>
               <!--Optional:-->
               <sso:Destination>Самара</sso:Destination>
               <sso:DepartureDate>2020-03-23</sso:DepartureDate>
               <sso:ReturnDate>2020-03-25</sso:ReturnDate>
            </sso:CurrentRoute>
            <!--Optional:-->
            <sso:Persons>
               <!--Zero or more repetitions:-->
               <sso:Person LastName="Аршавин" FirstName="Андрей" MiddleName="Сергеевич"
               LastNameLatin="Arshavin" FirstNameLatin="Andrey" MiddleNameLatin="Sergeevich" Gender="true" DateBirth="1986-05-30">
                  <!--Optional:-->
                  <sso:INN>111111111111</sso:INN>
                  <!--Optional:-->
                  <sso:KPP>11111111111</sso:KPP>
                  <!--Optional:-->
                  <sso:CountryAlpha2>RU</sso:CountryAlpha2>
                   <!--Optional:-->
                  <sso:PersonalCodes>
                     <!--Zero or more repetitions:-->
                     <sso:Code DictionaryName="Табельный номер" CodeValue="00003" IsPrimaryKey="true" />
                  </sso:PersonalCodes>
               </sso:Person>
            </sso:Persons>
            <!--Optional:-->
            <sso:AccountDetails id_Group="1111" GroupSecurityKey="7091-328347805873e9a9c700591812fb0ec2-1111-dat" Email="arshavin@fakeemails.com"/>
         </sso:request>
      </sso:Set>
   </soapenv:Body>
</soapenv:Envelope>

Ключевые поля:

● OuterId - номер командировки во внутренней клиентской системе, должен быть уникальным

● CurrentRoute - маршрут и даты командировки для автозаполнения

Параметры Origin и Destination передаются как текст, и должны содержать только названия городов.

Cправочник городов можно получить (или уточнить точное название населенного пункта) по API, используя метод:

Список городов - Документация системы Corteos - Corteos-platform documentation

Для заграничных командировок достаточно указать название города кириллицей.

Администратор со стороны агентства может проверить наличие необходимых городов в “Редакторе городов”, сравнить название (например, Санкт Петербург или Санкт-Петербург) и отредактировать координаты нужного города. При отсутствии населенного пункта в базе данных его возможно добавить:

● Persons/Person - участники командировки

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

Параметры id_Group и GroupSecurityKey для AccountDetails предоставляются агентством, их можно определить в настройках договора:

Параметр Email - это логин пользователя, который создает командировку и в дальнейшем будет выступать в роли инициатора.

Пользователь должен быть предварительно создан в системе Corteos.

Проверить, существует ли пользователь с определенным Email можно при помощи запроса CheckV2 (более подробно описано в разделе Пользователь (CL_Client) ).

Диаграмма для процесса проверки пользователя:

В полученном ответе интересно поле CorteosID - это токен запроса, который впоследствии используется для переадресации пользователя.

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