Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Методы веб-сервиса для импорта операций по подарочным картам


Активация подарочной карты

МетодactivatePresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийАктивация подарочных карт, в качестве входных параметров принимает фильтр, по которому и будут отобраны карты для активации.


...

Замена подарочной карты

МетодcardReplacement
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийЗамена подарочной карты. Указываются номер двух карт, старой (которую требуется заменить), и новую (которая будет выдана вместо старой).

...

-

Деактивация подарочной карты

МетодdeActivatePresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийГашение подарочной карты, полное списание. После вызова метода с номером карты, её статус будет "использована/погашена".


...


Получить информацию по подарочной карте

МетодgetPresentCardInfo
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийПолучить информацию по подарочно подарочной карте


Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

cardNumberStringНовый номер карты из существующих диапазоновДа
msrCardNumberStringНомер карты из магнитной дорожки (полосы)Нет
shopNumberLongНабор полей чекаНет

Возвращаемые параметры

activationDatedateTimeДата активации
amountLongНоминал
balanceLongОстаток на карте
cardNumberStringНомер карты
maxAmountStringМаксимальный номинал
multiplicityStringКратность
statusString

Статус

  • Activate - активирована
  • Blocked - заблокирована
  • Changed - заменена
  • Create - создана
  • EXTEND - продлен срок действия
  • Inactive - неактивирована
  • PARTIAL_USE - частичное списана 
  • UNDO_USE - отмена использования (возврат из гашения)
  • Used - использована

Описание формата данных

Блок кода
languagexml
titleПример запроса на получение информации по подарочной карте
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInfo>
         <!--Optional:-->
         <request>
            <!--Optional:-->
            <cardNumber>10000002233</cardNumber>
            <!--Optional:-->
            <msrCardNumber>100000022339098213</msrCardNumber>
            <!--Optional:-->
            <shopNumber>779</shopNumber>
         </request>
      </ser:getPresentCardInfo>
   </soapenv:Body>
</soapenv:Envelope>


Блок кода
titleПример ответа на запрос по получение информации о подарочной карте
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInfoResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-10-05T12:41:10.658+03:00</activationDate>
            <amount>40000</amount>
            <balance>40000</balance>
            <cardNumber>10000002233</cardNumber>
            <maxAmount>0</maxAmount>
            <multiplicity>0</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInfoResponse>
   </soap:Body>
</soap:Envelope>


...

Получить информацию по подарочной карте только по номеру

МетодgetPresentCardInformation
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийПолучить информацию по подарочно подарочной карте


Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

cardNumberStringНовый номер карты из существующих диапазоновДа

Возвращаемые параметры

activationDatedateTimeДата активации
amountLongНоминал
balanceLongОстаток на карте
cardNumberStringНомер карты
maxAmountStringМаксимальный номинал
multiplicityStringКратность
statusString

Статус

  • Activate - активирована
  • Blocked - заблокирована
  • Changed - заменена
  • Create - создана
  • EXTEND - продлен срок действия
  • Inactive - неактивирована
  • PARTIAL_USE - частичное списана 
  • UNDO_USE - отмена использования (возврат из гашения)
  • Used - использована

...

Получить информацию по подарочной карте по номеру магнитной дорожки

МетодgetPresentCardInformationByMSRNumber
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийПолучить информацию по подарочно подарочной карте по номеру магнитной полосы (дорожки)

...

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

МетодgetPresentCardsInfoByFilter
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
Комментарий

Произвести поиск подробной информации по подарочной карте, используя фильтры поиска по реквизитам. Отображается информация в том числе и по действиям с подарочной картой.

...

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

cardNumberStringНомер картыНет
endDateFromdateTime

Дата окончания срока действия от

Формат: YYYY-MM-DD

Нет
endDateTodateTime

Дата окончания срока действия до

Формат: YYYY-MM-DD

Нет
operationDateFromdateTime

Дата начала действия по карте от

Формат: YYYY-MM-DD

Нет
operationDateTodateTime

Дата начала действия по карте до

Формат: YYYY-MM-DD

Нет
paymentDatedateTime

Дата гашения

Формат: YYYY-MM-DD

Нет
saleDatedateTime

Дата продажи 

Формат: YYYY-MM-DD

Нет
startDateFromdateTime

Дата начала срока действия от

Формат: YYYY-MM-DD

Нет
startDateTodateTime

Дата окончания срока действия до

Формат: YYYY-MM-DD

Нет
statusКоллекция статусов

Статус

  • Activate - активирована
  • Blocked - заблокирована
  • Changed - заменена
  • Create - создана
  • EXTEND - продлен срок действия
  • Inactive - неактивирована
  • PARTIAL_USE - частичное списана 
  • UNDO_USE - отмена использования (возврат из гашения)
  • Used - использовна
Нет

Возвращаемые параметры

getPresentCardsInfoByFilterResponseBase64

Информация по подарочной карте в формате Base64

Пример ответа в base64.


  • cardNumber
LongНоминалНомер карты
  • amount
LongОстаток на картеНоминал
  • status
String

Статус

  • Activate - активирована
  • Blocked - заблокирована
  • Changed - заменена
  • Create - создана
  • EXTEND - продлен срок действия
  • Inactive - неактивирована
  • PARTIAL_USE - частичное списана 
  • UNDO_USE - изъятия из использования
  • Used - использовна

  • startDate
StringДата начала действия
  • endDate
StringДата окончания
  • replacedCardNumber
StringНомер новой карты в замен этой, если есть
  • actions
Комплексный

Действия с картой:

  • type - тип
    • Activate - активирована
    • Blocked - заблокирована
    • Changed - заменена
    • Create - создана
    • EXTEND - продлен срок действия
    • Inactive - неактивирована
    • PARTIAL_USE - частичное списана 
    • UNDO_USE - отмена использования (возврат из гашения)
    • Used - использована
  • source - источник/пользователь
    • SERVER - по умолчанию

  • blockingCause
КомплексныйПричина блокировки
  • prolongationCause
КомплексныйПричина продления

...


Погасить подарочную карту (перевести в статус "использована/погашена")

МетодpaymentPresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийГашение подарочной карты, полное списание. После вызова метода с номером карты, её статус будет "использована/погашена".


...


Списать сумму с подарочной карты

МетодredeemPresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийСписать частично указанную сумму с подарочной карты. Используется только при возможности частичного гашения/списания подарочной карты.


...

Переотправить подарочные карты в SetESB/Kafka по фильтру

МетодresendPresentCardsToKafkaByFilter
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
Комментарий

Переотправить подарочные карты, используя фильтры поиска по реквизитам. Отображается информация в том числе и по действиям с подарочной картой.

...


Отмена использования подарочной карты (возврат из статуса погашенной)

МетодundoUsePresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийОтменить использование подарочной карты


...

  

Разблокировка подарочной карты (возврат из статуса заблокированной)

МетодunblockPresentCard
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
КомментарийРазблокировать подарочную карту.

Устаревшая версия Jira
serverSystem Jira
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-7050

Устаревшая версия Jira
serverSystem Jira
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-9726

...