Мильная или бонусная карта (RW_MileCards) - это карта, дающая дополнительные опции при перелете или ж/д-переезде. Карта привязана к конкретному человеку через ссылку id_Person:
id_Card (пример: "123") - первичный ключ карты (обязательное поле, число);
id_Person (пример: "123") - ссылка на идентификатор человека из класса RealWord.Person (обязательное поле, число);
Number (пример: "55555") - номер мильной карты (обязательное поле, строка);
AirlineCode (пример: "SU") - код авиакомпании, которой принадлежит мильная карта, состоит из двух символов английского алфавита (обязательное поле, строка);
OuterId (пример: "8d47f436-2fbe-4116-bb64-68be437c2270") - идентификатор внешней системы (опциональное поле, строка).
В интерфейсе редактирование мильных карт доступно в редакторе персон, в который агент попадает через раздел "Travel management" в редакторе договоров, а клиент может попасть из меню "Настройки", если в соответствии с его ролью ему доступно редактирование персональных данных.
Под клиентом:
Здесь мы попадаем в список персон и, кликнув по любой, в открывшемся окне видим список мильных карт:
Соответствие полей интерфейса полям модели:
Для проведения любой операции необходимо пройти авторизацию, а также, если мы работаем от имени агента, получить контекст клиента Для получения контекста клиента используется сервис MetaCodeOnOrganizationManagement.asmx WSDL можно скачать с демо-сайта: https://demo.corteos.ru/XmlGate/V3/StaticData/MetaCodeOnOrganization/MetaCodeOnOrganizationManagement.asmx Для работы в продуктовой среде необходимо заменить demo.corteos.ru на свой домен (на котором работают пользователи вашей компании). |
В API реализованы следующие методы для работы с кодом:
GetV2 - Получение мильной карты по первичному ключу (RW_MileCards.id_Card);
SaveV2 - Сохраняет переданную мильную карту (или создает новую, если id_Card == null);
ListV2 - Получение списка мильных карт для персоны;
DeleteV2 - Удаление мильной карты.
Разберем эти методы более подробно.
1. Получение списка мильных карт (ListV2)
Получить список мильных карт можно по идентификатору персоны (id_Person), которой эти карты принадлежат.
Данный параметр является обязательным.
Запрос / Ответ
2. Запрос на получение одной мильной карты
Запрос / Ответ
3. Создание одной мильной карты или редактирование существующей
Запрос на создание / Запрос на изменение / Ответ
4. Запрос на удаление мильной карты
____