{"type":"doc","content":[{"type":"table","attrs":{"layout":"default","localId":"5b638dc4-8a8d-40a5-991b-3117d5669a7d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[680.0]},"content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Для проведения данной операции необходимо пройти ","type":"text"},{"text":"авторизацию","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CD/pages/798390"}}]},{"text":", а также, если мы работаем от имени агента, ","type":"text"},{"text":"получить контекст клиента","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CD/pages/705994"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Для получения контекста клиента используется сервис OrchestratedPersonEditor.asmx","type":"text"}]},{"type":"paragraph","content":[{"text":"WSDL можно скачать с демо-сайта: ","type":"text"},{"text":"https://demo.corteos.ru/XmlGate/V3/Orchestrated/OrchestratedPersonEditor.asmx?WSDL","type":"text","marks":[{"type":"link","attrs":{"href":"https://demo.corteos.ru/XmlGate/V3/Orchestrated/OrchestratedPersonEditor.asmx?WSDL"}}]}]},{"type":"paragraph","content":[{"text":"Для работы в продуктовой среде необходимо заменить ","type":"text"},{"text":"demo.corteos.ru","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://demo.corteos.ru"}}]},{"text":" на свой домен (на котором работают пользователи вашей компании)","type":"text"}]},{"type":"paragraph","content":[{"text":"Метод для выгрузки персоны:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"https://demo.corteos.ru/XmlGate/V3/Orchestrated/OrchestratedPersonEditor.asmx?op=OrchestratedPersonGet","type":"text","marks":[{"type":"link","attrs":{"href":"https://demo.corteos.ru/XmlGate/V3/Orchestrated/OrchestratedPersonEditor.asmx?op=OrchestratedPersonGet"}}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Данный метод позволяет по идентификатору персоны в системе Кортеос получить все её данные и параметры связанных объектов:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Данные персоны ","type":"text","marks":[{"type":"strong"}]},{"text":"(ФИО, дата рождения, гражданство и так далее);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Документы ","type":"text","marks":[{"type":"strong"}]},{"text":"(1 персона может иметь 0...n документов);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Контактная информация ","type":"text","marks":[{"type":"strong"}]},{"text":"(1 персона может иметь 0...n контактов);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Мильные карты для авиаперелетов и ж/д","type":"text","marks":[{"type":"strong"}]},{"text":" (1 персона может иметь 0...n карт);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Тревел-политики","type":"text","marks":[{"type":"strong"}]},{"text":" (1 персона может иметь 0...n связей с политиками);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Структурные и структурные-меняемые коды ","type":"text","marks":[{"type":"strong"}]},{"text":"(1 персона может иметь 0...n кодов);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Данные аккаунта пользователя ","type":"text","marks":[{"type":"strong"}]},{"text":"(у персоны может быть / не быть пользовательский доступ в Кортеос. Также доступ может быть заблокирован).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"В качестве параметра передается идентификатор персоны (уникальный числовой ключ):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":509,"id":"5144f1e6-6420-47a1-9bc4-d323259cecb3","collection":"contentId-846608","type":"file","height":226}}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n\ndf67da97-****-****-84ce-c7c45381b310\n\n\n\n\n111\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"В пользовательском интерфейсе идентификатор персоны можно найти в разделе ","type":"text"},{"text":"\"Персоны и пользователи\".","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Он доступен через раздел ","type":"text"},{"text":"Travel Management","type":"text","marks":[{"type":"strong"}]},{"text":" в редакторе договора (","type":"text"},{"text":"для агента","type":"text","marks":[{"type":"em"}]},{"text":") или из меню \"Настройки\" (","type":"text"},{"text":"для клиента","type":"text","marks":[{"type":"em"}]},{"text":").","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":563,"id":"e6d7cf1e-1e48-4817-a1a5-5e2e184def41","collection":"contentId-846608","type":"file","height":190}}]},{"type":"paragraph","content":[{"text":"В списке персон первая колонка содержит в себе этот уникальный идентификатор:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1340,"id":"99a67bf8-cbdb-4601-aa79-e1ef294d3e79","collection":"contentId-846608","type":"file","height":289}}]},{"type":"paragraph","content":[{"text":"В ответе мы получаем информацию о персоне и всех связанных сущностях:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":740,"id":"f2796660-ee37-4221-894a-8808e94a1d9e","collection":"contentId-846608","type":"file","height":331}}]},{"type":"paragraph","content":[{"text":"В случае ошибки будет ответ следующего вида:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Формат используется как для выгрузки, так и для обратной загрузки персоны. Ниже мы разберем структуру ответа (или запроса на редактирование персоны) более подробно.","type":"text"}]},{"type":"paragraph","content":[{"text":"Обязательность и правило использования полей относятся именно к редактированию, при выгрузке с сервера приходит информация в том виде, в котором она в настоящий момент сохранена в БД Кортеос.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Персональные данные","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"В пользовательском интерфейсе персональные данные можно обнаружить в редакторе персоны:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":679,"id":"26bad1fa-6ca4-41c6-87d9-048044bbadc7","collection":"contentId-846608","type":"file","height":433}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Персональные данные содержатся в корневом элементе ","type":"text"},{"text":"OrchestratedPersonGetResponse","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":751,"id":"6452f73e-8fdc-4fb4-9475-0d6f9e87be93","collection":"contentId-846608","type":"file","height":333}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FirstName","type":"text","marks":[{"type":"strong"}]},{"text":" - имя на русском языке (например, \"Мариночка\"), ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MiddleName","type":"text","marks":[{"type":"strong"}]},{"text":" - отчество на русском языке (например, \"Федоровична\"), необязательное поле;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LastNameLatin","type":"text","marks":[{"type":"strong"}]},{"text":" - фамилия латиницей (например, \"Sokolova\"), ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FirstNameLatin","type":"text","marks":[{"type":"strong"}]},{"text":" - имя латиницей (например, \"Marina\"), ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MiddleNameLatin","type":"text","marks":[{"type":"strong"}]},{"text":" - отчество латиницей (например, \"Fedorovichna\"), необязательное поле;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Male","type":"text","marks":[{"type":"strong"}]},{"text":" - булевый признак пола персоны (является ли персона мужчиной), ","type":"text"},{"text":"true","type":"text","marks":[{"type":"strong"}]},{"text":" или ","type":"text"},{"text":"false","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BirthDate","type":"text","marks":[{"type":"strong"}]},{"text":" - дата рождения в SOAP-формате, например,\"1990-01-01T00:00:00\", ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CitizenshipAlpha2Code","type":"text","marks":[{"type":"strong"}]},{"text":" - ","type":"text"},{"text":"alpha2","type":"text","marks":[{"type":"link","attrs":{"href":"https://ru.wikipedia.org/wiki/ISO_3166-1"}}]},{"text":" код гражданства (например, \"RU\"), ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Organization","type":"text","marks":[{"type":"strong"}]},{"text":" - ссылка на организацию, в которой работает персона (например, \"68\"), ","type":"text"},{"text":"обязательное поле","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Если персона не работает ни в одной организации, то ","type":"text"},{"text":"следует все равно","type":"text","marks":[{"type":"em"}]},{"text":" создать в редакторе организаций некий контейнер для таких персон;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Person","type":"text","marks":[{"type":"strong"}]},{"text":" - уникальный номер персоны в БД (например, \"216\").","type":"text"},{"type":"hardBreak"},{"text":"Если поле заполнено, то редактируется объект с переданным идентификатором, если нет - создается новый объект.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Идентификатор организаций можно посмотреть под ТМ ","type":"text"},{"text":"клиента","type":"text","marks":[{"type":"em"}]},{"text":" (меню \"Настройки\" - \"Организации\"):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":619,"id":"8645240b-ef45-4603-b611-035f258362be","collection":"contentId-846608","type":"file","height":249}}]},{"type":"paragraph","content":[{"text":"или ","type":"text"},{"text":"агентом","type":"text","marks":[{"type":"em"}]},{"text":" через редактор договоров в разделе \"Тревел-менеджмент\":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1245,"id":"b53e302b-318e-49c2-9eed-d6ff5458476d","collection":"contentId-846608","type":"file","height":451}}]},{"type":"paragraph","content":[{"text":"ID организаций указаны в первой колонке списка.","type":"text"}]},{"type":"paragraph","content":[{"text":"Кроме того, список организаций можно получить при помощи CRUD API ","type":"text"},{"text":"списка ","type":"text","marks":[{"type":"link","attrs":{"href":"https://corteos-platform.atlassian.net/wiki/spaces/CD/pages/705961/ORG+Organization"}}]},{"text":"организаций.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Документы","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"На пользовательском интерфейсе документы можно обнаружить в редакторе персоны:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":675,"id":"0439b2c4-f078-4837-b1ba-8ad42d4f3cfd","collection":"contentId-846608","type":"file","height":350}}]},{"type":"paragraph","content":[{"text":"Документы содержатся в контейнере документов, в нем может быть 0...n элементов:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":954,"id":"3866c788-1354-4df0-84be-38376192db09","collection":"contentId-846608","type":"file","height":290}}]},{"type":"paragraph","content":[{"text":"Поля документа:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocumentType","type":"text","marks":[{"type":"strong"}]},{"text":" - строка, тип документа (поле обязательно для заполнения). Может принимать значения из списка:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"foreignpassport","type":"text","marks":[{"type":"strong"}]},{"text":" - загранпаспорт РФ;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"passport","type":"text","marks":[{"type":"strong"}]},{"text":" - национальный паспорт любой страны (определяется CountryAlpha2Code);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"birthcertificate","type":"text","marks":[{"type":"strong"}]},{"text":" - свидетельство о рождении РФ.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"strong"}]},{"text":" - номер документа (например, \"113456789\") (поле обязательно для заполнения).","type":"text"},{"type":"hardBreak"},{"text":"Если документ содержит номер и серию, то здесь их следует указать без пробелов. В частности, паспорт РФ - это просто 10 цифр подряд;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CountryAlpha2Code","type":"text","marks":[{"type":"strong"}]},{"text":" - код страны ","type":"text"},{"text":"alpha2","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.artlebedev.ru/country-list/"}}]},{"text":" (например, \"RU\") (поле обязательно для заполнения);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Document","type":"text","marks":[{"type":"strong"}]},{"text":" - первичный ключ документа (например, \"123\"). Если поле заполнено, то редактируется объект с переданным идентификатором, если нет - создается новый объект;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ValidityDate","type":"text","marks":[{"type":"strong"}]},{"text":" - срок годности документа (например, \"2031-07-27T00:00:00\"). Поле обязательно для заполнения для документов с известным сроком годности (например, для загранпаспорта или иностранного). Для паспорта РФ, свидетельства о рождении также лучше вычислять эти данные на основании данных о дате рождения персоны (в Кортеос автоматом этого НЕ делается).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Мильные карты","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"В разделе \"Мильные карты\" можно передавать карты авиакомпаний или карту \"РЖД Бонус\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Следует учитывать, что карты альянсов (например, \"Скай Тим\") все равно выданы какой-то авиакомпанией, поэтому тут будет использоваться её IATA-код.","type":"text"}]},{"type":"paragraph","content":[{"text":"В интерфейсе пользователя список карт можно обнаружить в редакторе персоны:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":678,"id":"baecaf95-b772-4831-87de-e0ca2df65d63","collection":"contentId-846608","type":"file","height":401}}]},{"type":"paragraph","content":[{"text":"В ответе сервиса эти же данные содержатся в элементе ","type":"text"},{"text":"MileCards","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":628,"id":"70b26f22-4c5b-46c5-b2de-1b9f4df61d06","collection":"contentId-846608","type":"file","height":317}}]},{"type":"paragraph","content":[{"text":"Карта состоит из трех полей:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provider","type":"text","marks":[{"type":"strong"}]},{"text":" - обязательный для заполнения код поставщика, тут может быть или ","type":"text"},{"text":"IATA-код","type":"text","marks":[{"type":"strong"}]},{"text":" авиакомпании, или значение ","type":"text"},{"text":"RzhdB","type":"text","marks":[{"type":"strong"}]},{"text":" для карт \"РЖД Бонус\". Пример - \"SU\";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"strong"}]},{"text":" - обязательный для заполнения номер карты (например, \"3546845\");","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_MileCard","type":"text","marks":[{"type":"strong"}]},{"text":" - уникальный идентификатор объекта. Если поле заполнено, то редактируется объект с переданным идентификатором, если нет - создается новый объект.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Контактная информация (она же \"Контакты\")","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Это сведения для связи с персоной. Здесь могут быть указаны адрес электронной почты, мобильный телефон или контакт другого типа.","type":"text"}]},{"type":"paragraph","content":[{"text":"Следует учитывать, что адреса электронной почты и мобильные телефоны вносятся в некоторые системы бронирования (в частности, в системы бронирования авиабилетов), поэтому они обязательно должны содержать корректные значения в соответствии с тем, какие именно системы вы используете. Например, если вы используете ","type":"text"},{"text":"Amadeus","type":"text","marks":[{"type":"em"}]},{"text":" и ","type":"text"},{"text":"Sirena","type":"text","marks":[{"type":"em"}]},{"text":", то следует уточнить в службе поддержки каждой GDS, в каком виде следует передавать мобильный телефон. чтобы его приняла авиакомпания (обычно это формат вида +7(916)222-33-22, но могут быть исключения - например, знак \"+\" может быть запрещен) и выработать нейтральный формат. На стороне Кортеос для контактной информации никакой валидации не предусмотрено, поэтому корректность форматов лежит на стороне разработчика.","type":"text"}]},{"type":"paragraph","content":[{"text":"В интерфейсе контактная информация выглядит так:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":678,"id":"475fa264-1f9b-44c2-b6c2-ea9d2020ba16","collection":"contentId-846608","type":"file","height":389}}]},{"type":"paragraph","content":[{"text":"А вот ее представление в ответе API:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":928,"id":"f9b91c71-35e3-4cc5-9936-e7583a64fb2b","collection":"contentId-846608","type":"file","height":320}}]},{"type":"paragraph","content":[{"text":"Контакт содержит в себе следующие поля:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ContactContent","type":"text","marks":[{"type":"strong"}]},{"text":" - содержимое контакта (например, \"+7(916)222-33-22\"), обязательно к заполнению.","type":"text"},{"type":"hardBreak"},{"text":"Также следует валидировать на стороне клиента адрес электронной почты, например, при помощи ","type":"text"},{"text":"регулярного выражения","type":"text","marks":[{"type":"link","attrs":{"href":"https://emailregex.com/"}}]},{"text":". Для контакта с типом \"email\" поле содержит адрес электронной почты персоны;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ContactType","type":"text","marks":[{"type":"strong"}]},{"text":" - тип контакта:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mobile","type":"text","marks":[{"type":"strong"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"email","type":"text","marks":[{"type":"strong"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"other","type":"text","marks":[{"type":"strong"}]},{"text":";","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Contact","type":"text","marks":[{"type":"strong"}]},{"text":" - уникальный идентификатор объекта. Если поле заполнено, то редактируется объект с переданным идентификатором, если нет - создается новый объект.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Аккаунт","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Предоставляет персоне права на доступ к системе. В списке персон в пользовательском интерфейсе у персон без аккаунта в системе роль пуста:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":811,"id":"7b20f58b-2257-46c9-9ecf-ce6f01d50180","collection":"contentId-846608","type":"file","height":107}}]},{"type":"paragraph","content":[{"text":"В редакторе персоны данные аккаунта выглядят таким образом:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":421,"id":"e4ab07cb-6fa5-489c-bd10-fb69a21d304f","collection":"contentId-846608","type":"file","height":182}}]},{"type":"paragraph","content":[{"text":"В ответе API это выглядит вот так:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":320,"id":"6abcb72e-9839-4c5f-96cb-0de9bc5f4d96","collection":"contentId-846608","type":"file","height":100}}]},{"type":"paragraph","content":[{"text":"Если персона не является пользователем, то узел ","type":"text"},{"text":"Account","type":"text","marks":[{"type":"strong"}]},{"text":" будет пустым.","type":"text"}]},{"type":"paragraph","content":[{"text":"Рассмотрим структуру этого элемента:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Email","type":"text","marks":[{"type":"strong"}]},{"text":" - адрес электронной почты, должен быть корректный email (обязательно для заполнения);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IsBlocked","type":"text","marks":[{"type":"strong"}]},{"text":" - булевый признак, заблокирован аккаунт или нет (обязательное поле).","type":"text"},{"type":"hardBreak"},{"text":"Важный момент","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" - после создания аккаунта его нельзя удалить, а можно только заблокировать потому, что к нему могут быть привязаны какие-то заказы;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Client","type":"text","marks":[{"type":"strong"}]},{"text":" - уникальный идентификатор объекта. Если поле заполнено, то редактируется объект с переданным идентификатором, если нет - создается новый объект;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Role","type":"text","marks":[{"type":"strong"}]},{"text":" - пользовательская роль, может принимать значения из списка:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1","type":"text","marks":[{"type":"strong"}]},{"text":" (селф-букер);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2","type":"text","marks":[{"type":"strong"}]},{"text":" (тревел-координатор);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3","type":"text","marks":[{"type":"strong"}]},{"text":" (тревел-менеджер).","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Также это может быть идентификатор кастомизированной пользовательской роли. Эти идентификаторы можно получить в пользовательском интерфейсе:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":596,"id":"f193af59-6d8f-4a3d-8841-79f46ed6a706","collection":"contentId-846608","type":"file","height":391}}]},{"type":"paragraph","content":[{"text":"Первая колонка в списке содержит идентификатор:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":755,"id":"83cfad3d-d9af-469f-a53e-b96c136257ed","collection":"contentId-846608","type":"file","height":520}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Тревел-политики","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"В редакторе персоны тревел-политики, привязанные к конкретной персоне, отображаются в списке:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":669,"id":"84409177-fbe1-4b15-834a-040784e8bd86","collection":"contentId-846608","type":"file","height":404}}]},{"type":"paragraph","content":[{"text":"В ответе метода API за это отвечает элемент-контейнер ","type":"text"},{"text":"PersonalPolicies","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":999,"id":"55274b22-7dcf-44cb-9be0-9cd563349415","collection":"contentId-846608","type":"file","height":449}}]},{"type":"paragraph","content":[{"text":"Поля элемента:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PolicyName","type":"text","marks":[{"type":"strong"}]},{"text":" - название политики, строка, не пустое;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ServiceType","type":"text","marks":[{"type":"strong"}]},{"text":" - тип услуги, не пустое:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"avia","type":"text","marks":[{"type":"strong"}]},{"text":";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"rail;","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"hotel.","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Другие типы услуг в настоящее время недоступны, на них нет тревел-политик.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CorteosVersions","type":"text","marks":[{"type":"strong"}]},{"text":" - массив значений типа ","type":"text"},{"text":"int","type":"text","marks":[{"type":"strong"}]},{"text":", в какой версии Кортеос надо создать привязку (может быть \"2\" или \"3\"). Несмотря на то, что сами идентификаторы политик одинаковы в старой и новой версиях, привязки создаются отдельно, так как там реализуется связь \"многие-ко-многим\";","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_TravelPolicy","type":"text","marks":[{"type":"strong"}]},{"text":" - идентификатор политики, его можно увидеть в списке тревел-политик по соответствующей услуге:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1351,"id":"5c8ea2be-b8c2-48f0-a179-93b1b26d94ac","collection":"contentId-846608","type":"file","height":560}}]},{"type":"paragraph","content":[{"text":"Данный идентификатор одинаков для v. 2 и v. 3.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"hardBreak"},{"text":"Структурные и меняемые структурные коды персон","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"На интерфейсе они отображаются в списке кодов:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":647,"id":"d9854802-856a-4443-8736-27326e31498b","collection":"contentId-846608","type":"file","height":339}}]},{"type":"paragraph","content":[{"text":"В ответе метода API они содержатся в ноде ","type":"text"},{"text":"MetaCodes","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":574,"id":"fcde2f9b-aa94-4672-9b62-ad6bf6a5e488","collection":"contentId-846608","type":"file","height":493}}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Код состоит из следующих элементов:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DictionaryName","type":"text","marks":[{"type":"strong"}]},{"text":" - название справочника кодов (обязательно для заполнения, не может быть пустым, строка);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CodeValue","type":"text","marks":[{"type":"strong"}]},{"text":" - значение кода, предполагается, что оно должно быть уникально внутри справочника с названием ","type":"text"},{"text":"DictionaryName","type":"text","marks":[{"type":"strong"}]},{"text":" - данное ограничение должен отслеживать разработчик клиентского приложения (обязательно для заполнения, не может быть пустым, строка);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"V3Id","type":"text","marks":[{"type":"strong"}]},{"text":" - ID персоны в конкретном справочнике версии 3;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CorteosVersions","type":"text","marks":[{"type":"strong"}]},{"text":" - массив значений типа int, в какую версию Кортеос отправить код. Может быть \"2\" или \"3\".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"В отличие от других сущностей код не содержит уникального идентификатора, так как он разный в разных версиях системы и вместо него используется составной ключ (","type":"text"},{"text":"DictionaryName","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"CodeValue","type":"text","marks":[{"type":"strong"}]},{"text":").","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Примеры:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Код, который будет добавлен ","type":"text"},{"text":"только во вторую версию","type":"text","marks":[{"type":"underline"}]},{"text":", в справочник с названием \"Финальный авторизатор\" со значением кода \"Y\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Код, который будет добавлен ","type":"text"},{"text":"и во вторую, и в третью версию одновременно","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":671,"id":"7b47f1d6-ecfc-4e0d-a1ea-aeec888e300a","collection":"contentId-846608","type":"file","height":82}}]},{"type":"paragraph","content":[{"text":"Логика работает следующим образом: система ищет в БД справочник с названием, точно совпадающим со значением из поля ","type":"text"},{"text":"DictionaryName","type":"text","marks":[{"type":"strong"}]},{"text":" в таблице соответствующей версии. Если такого справочника нет - выдается ошибка; если он есть, то система ищет в нем код со значением ","type":"text"},{"text":"CodeValue.","type":"text","marks":[{"type":"strong"}]},{"text":" Если такого кода нет, то в справочнике создается новый код и происходит привязка кода к персоне, а если код уже есть, то просто создается привязка.","type":"text"}]},{"type":"paragraph","content":[{"text":"Название справочников кодов в интерфейсе доступно в разделе \"Справочники кодов\":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":535,"id":"7f8edc72-a11f-4afa-b16f-a091265622fa","collection":"contentId-846608","type":"file","height":336}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"В колонке \"","type":"text"},{"text":"Название","type":"text","marks":[{"type":"strong"}]},{"text":"\" мы видим текст, который должен соответствовать полю ","type":"text"},{"text":"DictionaryName","type":"text","marks":[{"type":"strong"}]},{"text":" из ответа API:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1332,"id":"f8fdb546-f944-426f-8d60-9266ca0589ae","collection":"contentId-846608","type":"file","height":286}}]},{"type":"paragraph","content":[{"text":"Если перейти в справочник и зайти в раздел \"Коды справочника\":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":833,"id":"6a57b5eb-62e6-4247-8210-23bb6fd24391","collection":"contentId-846608","type":"file","height":171}}]},{"type":"paragraph","content":[{"text":"то в полученном списке нас интересует поле \"","type":"text"},{"text":"Значение кода","type":"text","marks":[{"type":"strong"}]},{"text":"\", соответствующее полю ","type":"text"},{"text":"CodeValue","type":"text","marks":[{"type":"strong"}]},{"text":" в API.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1278,"id":"c56120cc-dae2-4399-a4dc-f7ade7832c96","collection":"contentId-846608","type":"file","height":287}}]},{"type":"paragraph","content":[{"text":"____","type":"text"}]}],"version":1}

Browser not supported