Экспорт информации по подарочным картам из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)

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

10.2.59.0

SR-2502 - Getting issue details... STATUS

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

МетодgetPresentCardInformation
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

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


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.


  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformation>
         <!--Optional:-->
         <cardNumber>654987</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>


По номеру магнитной полосы MSR подарочной карты

МетодgetPresentCardInformationByMSRNumber
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

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


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformationByMSRNumber>
         <!--Optional:-->
         <msrNumber>654987</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>


По фильтрам

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

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Нет
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Нет
statuscardStatus

Статус подарочной карты:

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway
Нет

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

return

base64

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


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardsInfoByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>654987</cardNumber>
            <!--Optional:-->
            <endDateFrom>2019-01-30</endDateFrom>
            <!--Optional:-->
            <endDateTo>2019-06-30</endDateTo>
            <!--Optional:-->
            <operationDateFrom>2019-01-30</operationDateFrom>
            <!--Optional:-->
            <operationDateTo>2019-06-30</operationDateTo>
            <!--Optional:-->
            <paymentDate>2019-04-08</paymentDate>
            <!--Optional:-->
            <saleDate>2019-04-08</saleDate>
            <!--Optional:-->
            <startDateFrom>2019-04-08</startDateFrom>
            <!--Optional:-->
            <startDateTo>2019-04-08</startDateTo>
            <!--Optional:-->
            <status>Active</status>
         </filter>
      </ser:getPresentCardsInfoByFilter>
   </soapenv:Body>
</soapenv:Envelope>


По HEX-представлению

10.2.60.0

МетодgetCardInformationByNumberAsHex
URLhttp://IP-адрес_сервера:8090//SET-Cards/SET/Cards/ExternalSystemCardsProcessing
WSDLhttp://IP-адрес_сервера:8090//SET-Cards/SET/Cards/ExternalSystemCardsProcessing?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Нет

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

return

base64

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


Работает как и метод getCardInformationByNumber, но дополнительно проверяет корректность записи номера в 16-ичной системы счисления.

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

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:proc="http://processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <proc:getCardInformationByNumberAsHex>
         <cardNumber>FFFFFFFE</cardNumber>
      </proc:getCardInformationByNumberAsHex>
   </soapenv:Body>
</soapenv:Envelope>

Формат данных

presentCards/presentCard

Наименование атрибута

Тип данных

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

Описание

cardNumber

StringДаНомер карты
amountLongДаНоминал
balanceLongНетОстаток на карте
statusStringДа

Статус:

  • Activate
  • Blocked
  • Changed
  • Create
  • EXTEND
  • Inactive
  • PARTIAL_USE
  • UNDO_USE
  • Used
startDateDateДа

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

Формат: yyyy-MM-dd hh:mm:ss.mmm

endDateDateНет

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

Формат: yyyy-MM-dd hh:mm:ss.mmm

replacedCardNumberStringНетНомер карты замены
actionsCollectionДаНабор действий с картой

typeStringДаНазвание действия
dateDateДаДата совершения действия
loginStringНетФИО или логин совершившего действие
sourceStringДа

Инициатор действия:

  • CASH
  • ERP
  • SERVER
  • UNKNOWN
cashStringНетНомер кассы
shopStringДаНомер магазина