Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

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

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

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

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

...

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

...

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

...

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

...

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

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

Info

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

WSDL можно скачать с демо-сайта: https://

...

stage1.corteos.ru/XmlGate/V3/StaticData/

...

MileCards/

...

MileCardManagement.asmx?wsdl

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

...

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

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

...

бонусными /мильными картами:

  1. GetV2 -

...

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

  2. SaveV2 -

...

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

  2. ListV2 -

...

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

...

  1. персоны;

  2. DeleteV2 -

...

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

...

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

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

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

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

Запрос Ответ

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

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

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

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

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

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

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

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

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

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

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

Запрос Ответ2. Запрос на получение одной

  1. Удаление мильной карты

...

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

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

...

  1. по первичному ключу (DeleteV2)

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

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