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

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

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

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

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


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>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

Поле

Тип данных

Описание

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

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

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

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

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:getPresentCardsInfoByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>7810001</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>
Пример ответа
<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>

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

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>


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

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