Необходимо передать данные о маршруте следования, номере командировки, пассажирах, а также об инициаторе.
Пример запроса:
<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 передаются как текст, и должны содержать только названия городов. Эталонный справочник: http://randcity.ru/download/
Администратор со стороны агентства может проверить наличие необходимых городов, сравнить название (например, Санкт Петербург или Санкт-Петербург) и отредактировать координаты нужного города:
UNKNOWN ATTACHMENT
UNKNOWN ATTACHMENT
● Persons/Person - участники командировки
● AccountDetails - данные для авторизации пользователя внутренней клиентской системы в Corteos
Параметры id_Group и GroupSecurityKey для AccountDetails предоставляются агентством, их можно определить в настройках договора:
UNKNOWN ATTACHMENT
Параметр Email - это логин пользователя, который создает командировку и в дальнейшем будет выступать в роли инициатора.
Пользователь должен быть предварительно создан в системе Corteos.
Проверить, существует ли пользователь с определенным Email можно при помощи запроса CheckV2 (более подробно описано в разделе Пользователь (CL_Client) ).
Диаграмма для процесса проверки пользователя:
UNKNOWN ATTACHMENT
В полученном ответе интересно поле CorteosID - это токен запроса, который впоследствии используется для переадресации пользователя.
После переадресации пользователя в Corteos, командировка считается созданной и далее можно использовать уже второй набор реквизитов.