Мильная / бонусная карта (RW_MileCards)

Мильная или бонусная карта (RW_MileCards) - это карта, дающая дополнительные опции при перелете или ж/д-переезде. Карта привязана к конкретному человеку через ссылку id_Person:

id_Card (пример: "123") - первичный ключ карты (обязательное поле, число);
id_Person (пример: "123") - ссылка на идентификатор человека из класса RealWord.Person (обязательное поле, число);
Number (пример: "55555") - номер мильной карты (обязательное поле, строка);
AirlineCode (пример: "SU") - код авиакомпании, которой принадлежит мильная карта, состоит из двух символов английского алфавита (обязательное поле, строка);
OuterId (пример: "8d47f436-2fbe-4116-bb64-68be437c2270") - идентификатор внешней системы (опциональное поле, строка).

В интерфейсе редактирование мильных карт доступно в редакторе персон, в который агент попадает через раздел "Travel management" в редакторе договоров, а клиент может попасть из меню "Настройки", если в соответствии с его ролью ему доступно редактирование персональных данных.

Под клиентом:

Здесь мы попадаем в список персон и, кликнув по любой, в открывшемся окне видим список мильных карт:

Соответствие полей интерфейса полям модели:

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

WSDL можно скачать с демо-сайта: https://demo.corteos.ru/XmlGate/V3/StaticData/MileCards/MileCardManagement.asmx?wsdl

Для работы в продуктовой среде необходимо заменить demo.corteos.ru на свой домен (на котором работают пользователи вашей компании).

В API реализованы следующие методы для работы с кодом:

GetV2 - Получение мильной карты по первичному ключу (RW_MileCards.id_Card);
SaveV2 - Сохраняет переданную мильную карту (или создает новую, если id_Card == null);
ListV2 - Получение списка мильных карт для персоны;
DeleteV2 - Удаление мильной карты.

Разберем эти методы более подробно.

1. Получение списка мильных карт (ListV2)

Получить список мильных карт можно по идентификатору персоны (id_Person), которой эти карты принадлежат.

Данный параметр является обязательным.

Запрос / Ответ
2. Запрос на получение одной мильной карты

Запрос / Ответ
3. Создание одной мильной карты или редактирование существующей

Запрос на создание / Запрос на изменение / Ответ

4. Запрос на удаление мильной карты

Запрос / Ответ

____

Актуальный список AirlineCode на 18.11.2024