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

Публичный ресурс

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

дек. 06, 2023

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

10.2.59.0

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

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

Метод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

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


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

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

Параметр не возвращается, если карта бессрочная


maxAmountLongМаксимальная сумма произвольного номинала
multiplicityLongКратность для суммы произвольного номинала
pinCodeStringПин-код 
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>7810001</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>
Пример ответа
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-11-30T12:42:52.064+03:00</activationDate>
            <amount>400000</amount>
            <balance>400000</balance>
            <cardNumber>7810001</cardNumber>
            <maxAmount>500000</maxAmount>
            <multiplicity>100</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInformationResponse>
   </soap:Body>
</soap:Envelope>

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

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

Поле

Тип данных

Описание

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

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

msrNumber

String

Номер карты с магнитной дорожки

Да

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

return

XML

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


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

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

Параметр не возвращается, если карта бессрочная


maxAmountLongМаксимальная сумма произвольного номинала
multiplicityLongКратность для суммы произвольного номинала
pinCodeStringПин-код 
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>7810001</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>
Пример ответа
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationByMSRNumberResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-11-30T12:42:52.064+03:00</activationDate>
            <amount>400000</amount>
            <balance>400000</balance>
            <cardNumber>7810001</cardNumber>
            <maxAmount>500000</maxAmount>
            <multiplicity>100</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInformationByMSRNumberResponse>
   </soap:Body>
</soap: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
Нет

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

result

base64Binary

Информация по подарочным картам в формате XML, закодированного в 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>
         <filter>
			<startDateFrom>2025-10-10</startDateFrom>
			<startDateTo>2025-10-18</startDateTo>
			<status>Blocked</status>
         </filter>
      </ser:getPresentCardsInfoByFilter>
   </soapenv:Body>
</soapenv:Envelope>

Результатом метода является закодированный XML-документ, содержащий массив карт. Все карты соответствуют заданному в запросе фильтру.

Если какой-либо элемент не заполнен, то в теге присутствуют атрибуты: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"

Пример XML, декодированного из Base64 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<presentCards xmlns="http://crystals.ru/cards/presentcards/report">
 <presentCard>
	<cardNumber>50005121001</cardNumber>
	<amount>500000</amount>
	<balance>500000</balance>
	<status>Blocked</status>
	<startDate>2025-10-17T18:43:07.348+03:00</startDate>
	<endDate>2026-10-17T23:59:59.999+03:00</endDate>
	<replacedCardNumber/>
	<actions>
		<action type="Create" date="2025-10-17T18:43:07.348+03:00" login="manager" source="SERVER"/>
		<action type="Blocked" date="2025-10-17T18:43:07.349+03:00" login="manager" source="SERVER"/>
	</actions>
	<blockingCause>Данная карта была заблокирована по причине утраты ее владельцем</blockingCause>
	<prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
 </presentCard>
 <presentCard>
	<cardNumber>50005121002</cardNumber>
	<amount>500000</amount>
	<balance>500000</balance>
	<status>Blocked</status>
	<startDate>2025-10-17T18:43:07.354+03:00</startDate>
	<endDate>2026-10-17T23:59:59.999+03:00</endDate>
	<replacedCardNumber/>
	<actions>
		<action type="Create" date="2025-10-17T18:43:07.355+03:00" login="manager" source="SERVER"/>
		<action type="Blocked" date="2025-10-17T18:43:07.355+03:00" login="manager" source="SERVER"/>
	</actions>
	<blockingCause>Данная карта была заблокирована по причине утраты ее владельцем</blockingCause>
	<prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
 </presentCard>
</presentCards>

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

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ДаНомер магазина
Пример экспорта
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<presentCards xmlns="http://crystals.ru/cards/presentcards/report">
	<presentCard>
		<cardNumber>3243242354</cardNumber>
		<amount>50000</amount>
		<balance>50000</balance>
		<status>Expired</status>
		<startDate>2022-12-05T10:33:16.293+03:00</startDate>
		<endDate>2023-12-05T10:33:16.291+03:00</endDate>
		<replacedCardNumber/>
		<actions>
			<action type="EXPIRED" date="2023-12-05T23:59:55.525+03:00" source="SERVER"/>
			<action type="Create" date="2022-12-05T10:33:16.292+03:00" login="ivanov" source="SERVER"/>
			<action type="Activate" date="2022-12-05T10:33:16.294+03:00" login="ivanov" source="SERVER"/>
		</actions>
		<blockingCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
		<prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
	</presentCard>
</presentCards>


© 1995-2025, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных