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

Owned by Corteos Platform (Unlicensed)
Last updated: Jul 31, 2024 by Виктория
2 min read

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

  • id_Card (пример: "123") - первичный ключ карты (обязательное поле, число);

  • id_Person (пример: "123") - ссылка на идентификатор человека из класса RealWord.Person (обязательное поле, число);

  • Number (пример: "55555") - номер бонусной карты (обязательное поле, строка);

  • AirlineCode (пример: "SU") - код авиакомпании, которой принадлежит бонусная карта, состоит из двух символов английского алфавита (обязательное поле, строка);

  • OuterId (пример: "8d47f436-2fbe-4116-bb64-68be437c2270") - идентификатор внешней системы (опциональное поле, строка).

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

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

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

image-20240508-075430.png

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

Соответственно, действие, аналогичное редактированию бонусной карты из API, можно произвести на интерфейсе в разделе бонусных карт персоны.

Перед использованием метода необходимо пройти аутентификацию и получить валидный токен. Подробнее об этом: Авторизация (получение токена)

Для получения контекста бонусной карты используется сервис MileCardManagement.asmx

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

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

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

  1. GetV2 - получение мильной карты по первичному ключу (RW_MileCards.id_Card);

  2. SaveV2 - создание новой мильной карты или редактирование существующей;

  3. ListV2 - получение списка мильных карт персоны;

  4. DeleteV2 - удаление мильной карты по первичному ключу.

Подробное описание методов с примерами:

  1. Получение мильной карты по первичному ключу (GetV2)

Для проведения выгрузки данных, необходимо передать первичный ключ мильной карты (id_Card).

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

  1. Создание новой мильной карты или редактирование существующей (SaveV2)

Для сохранения изменений в уже созданной мильной карте необходимо передать:

  • первичный ключ мильной карты (id_Card);

  • первичный ключ персоны (id_Person);

  • код авиакомпании (AirlineCode);

  • номер мильной карты (Number).

В том случае, если мы создаем новую мильную карту, первичный ключ не передаем.

Если нам надо удалить мильную карту, то в атрибуте deleted передаем значение true.

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

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

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

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

  1. Удаление мильной карты по первичному ключу (DeleteV2)

Для удаления мильной карты по первичному ключу (id_Card) используется метод DeleteV2.

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