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

10.2.59.0

SR-2502 - Получение подробных данных проблемы… СТАТУС

По номеру подарочной карты
Метод	getPresentCardInformation
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Да
Возвращаемые параметры
return	xml	Информация по подарочное карте
amount	Long	Сумма подарочной карты
balance	Long	Остаток суммы подарочной карты
cardNumber	String	Номер подарочной карты
expirationDate	dateTime	Дата окончания действия
status	cardStatus	Статус подарочной карты: В этом методе может быть статус карты 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
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Да
Возвращаемые параметры
return	xml	Информация по подарочное карте
amount	Long	Сумма подарочной карты
balance	Long	Остаток суммы подарочной карты
cardNumber	String	Номер подарочной карты
expirationDate	dateTime	Дата окончания действия
status	cardStatus	Статус подарочной карты: В этом методе может быть статус карты 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
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Нет
endDateFrom	dateTime	Дата окончания действия карты [от] в формате YYYY-MM-DD	Нет
endDateTo	dateTime	Дата окончания действия карты [до] в формате YYYY-MM-DD	Нет
operationDateFrom	dateTime	Дата операций по подарочной карте [от] в формате YYYY-MM-DD	Нет
operationDateTo	dateTime	Дата операций по подарочной карте [до] в формате YYYY-MM-DD	Нет
paymentDate	dateTime	Дата оплаты подарочной картой в формате YYYY-MM-DD	Нет
saleDate	dateTime	Дата продажи подарочной картой в формате YYYY-MM-DD	Нет
startDateFrom	dateTime	Дата начала действия карты [от] в формате YYYY-MM-DD	Нет
startDateTo	dateTime	Дата начала действия карты [до] в формате YYYY-MM-DD	Нет
status	cardStatus	Статус подарочной карты: 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
URL	http://IP-адрес_сервера:8090//SET-Cards/SET/Cards/ExternalSystemCardsProcessing
WSDL	http://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	Да	Номер карты
amount		Long	Да	Номинал
balance		Long	Нет	Остаток на карте
status		String	Да	Статус: Activate Blocked Changed Create EXTEND Inactive PARTIAL_USE UNDO_USE Used
startDate		Date	Да	Дата начала действия карты Формат: yyyy-MM-dd hh:mm:ss.mmm
endDate		Date	Нет	Дата окончания действия карты Формат: yyyy-MM-dd hh:mm:ss.mmm
replacedCardNumber		String	Нет	Номер карты замены
actions		Collection	Да	Набор действий с картой
	type	String	Да	Название действия
	date	Date	Да	Дата совершения действия
	login	String	Нет	ФИО или логин совершившего действие
	source	String	Да	Инициатор действия: CASH ERP SERVER UNKNOWN
	cash	String	Нет	Номер кассы
	shop	String	Да	Номер магазина

Интеграция

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

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

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

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

По фильтрам

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

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