Note |
---|
Для работы с “жёстким” или “мягким” контейнером командировки необходимо: |
...
Code Block |
---|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sso="https://sso.corteos.ru/"> <soapenv:Header/> <soapenv:Body> <sso:Set> <sso:request> <sso:OuterId>2090991100</sso:OuterId> <sso:CustomRoute> <sso:RoutePart> <sso:DateDepart>2024-10-09</sso:DateDepart> <sso:DateReturn>2024-10-09</sso:DateReturn> <sso:Origin>Москва</sso:Origin> <sso:Destination>Санкт-Петербург</sso:Destination> <sso:ServiceType>transport</sso:ServiceType> <!--sso:ServiceType>transport,lodging</sso:ServiceType> <sso:ServiceType>transport</sso:ServiceType> <ssoServiceType--> <!--sso:ServiceType>lodging</sso:ServiceType--> <sso:DepartureAdvanceShiftDays>0</sso:DepartureAdvanceShiftDays> <sso:DeparturePostShiftDays>0</sso:DeparturePostShiftDays> <sso:ReturnAdvanceShiftDays>0</sso:ReturnAdvanceShiftDays> <sso:ReturnPostShiftDays>0</sso:ReturnPostShiftDays> <sso:BookingSequence>1</sso:BookingSequence> </sso:RoutePart> <!--sso<sso:RoutePart> <sso:DateDepart>2024-10-15</sso:DateDepart> <sso:Origin>Санкт-Петербург</sso:Origin> <sso:Destination>Москва</sso:Destination> <sso:ServiceType>transport</sso:ServiceType> <sso:DepartureAdvanceShiftDays>0</sso:DepartureAdvanceShiftDays> <sso:DeparturePostShiftDays>0</sso:DeparturePostShiftDays> <sso:ReturnAdvanceShiftDays>0</sso:ReturnAdvanceShiftDays> <sso:ReturnPostShiftDays>0</sso:ReturnPostShiftDays> <sso:BookingSequence>1</sso:BookingSequence> </sso:RoutePart-->RoutePart> </sso:CustomRoute> <sso:CustomOptions> <sso:CustomOption> <sso:Key>routeControl</sso:Key> <sso:Value>true</sso:Value> </sso:CustomOption> <sso:CustomOption> <sso:Key>automaticServices</sso:Key> <sso:Value>transport,hotel</sso:Value> </sso:CustomOption> <sso:CustomOption> <sso:Key>updateMode</sso:Key> <sso:Value>update</sso:Value> </sso:CustomOption> </sso:CustomOptions> <sso:Persons> <sso:Person LastName="Лапочкина" FirstName="Елена" MiddleName="Александровна" LastNameLatin="Lapochkina" FirstNameLatin="Elena" MiddleNameLatin="Aleksandrovna" Gender="false" DateBirth="1980-02-06"> <sso:INN>222222222222</sso:INN> <sso:KPP>222222222</sso:KPP> <sso:CountryAlpha2>RU</sso:CountryAlpha2> <sso:Documents> <sso:Document CountryCode="RU" DocumentNumber="2323222222" DocumentType="NationalPassport" DateValid="2044-09-04"/> </sso:Documents> <sso:Contacts> <sso:Contact ContactType="MobilePhone" Value="+72222222222"/> </sso:Contacts> <sso:PersonalCodes> <sso:Code DictionaryName="тестнв" CodeValue="1234" IsPrimaryKey="true"/> </sso:PersonalCodes> </sso:Person> </sso:Persons> <sso:AccountDetails id_Group="8418" GroupSecurityKey="2D6DE573-CBAD-4437-90E6-0F4CFE31936C" Email="usr8418@corteos.travel"> <sso:id_Role>1</sso:id_Role> </sso:AccountDetails> </sso:request> </sso:Set> </soapenv:Body> </soapenv:Envelope> |
<sso:OuterId>
-идентификатор командировки во внешней системе,, уникальный номер ( если такой номер командировки уже существует, то произойдет обновление данных)
<sso:DateDepart>
–datetime, дата отправления пассажира в пункт назначения,<sso:Origin>
-string, начальная точка маршрута. , название города из справочника городов,Здесь маршрут начинается в Москве.<sso:Destination>
-string, город следующего назначения,название города из справочника городов,конечная точка маршрута. Путешествие заканчивается в Санкт-Петербурге.<sso:ServiceType>
Тип услуги.
<sso:ServiceType>transport,lodging</sso:ServiceType>
- в этом случае транспорт и проживание, .
<sso:ServiceType>transport</sso:ServiceType>
- в этом случае услуга относится к транспортной категории. <sso:ServiceType>lodging</sso:ServiceType>
- в этом случае транспорт и проживание,
ReturnDate -datetime, дата отправления пассажира обратно,проживание.
LastName -string, фамилия персоны на русском языке,
FirstName -string, имя персоны на русском языке,
MiddleName -string,отчество персоны, если нет - передаем пробельный символ,
LastNameLatin, FirstNameLatin, MiddleNameLatin -string, все то же самое, но на английском языке, строка. Если у вас в системе эти данные не хранятся, то русский аналог необходимо транслитерировать по ГОСТ 7.79-2000 (система Б)
Gender - true - мужчина, false - женщина,
DateBirth -datetime, дата рождения,
INN -int, ИНН организации, в которой работает персона,
KPP -int, КПП организации, в которой работает персона.
По полям ИНН и КПП мы привязываем персону к нужной компании.
CountryAlpha2-код страны, гражданином которой является персона
CodeValue-значение кода, предполагается, что оно должно быть уникально внутри справочника с названием DictionaryName - данное ограничение должен отслеживать разработчик клиентского приложения (обязательно для заполнения, не может быть пустым, строка);
IsPrimaryKey- К персоне может быть привязано несколько кодов из разных справочников. Например, Табельный номер (это может быть идентификатор в учетной системе клиента), Категория должности (для применения тревел-политики) и т.п.
...
Данный идентификатор мы используем при SSO переходе на адрес:
https://домен/mods/ssoentrance/go?portalId=CorteosId
Перейдя по этой ссылке мы попадаем на страницу созданной командировки.
Если был включен мод Контейнер командировки: жесткое сохранение структуры маршрута будет автоматически отрисован таймлайн поездки на основании тех параметров которые вы указали при создании командировки
...