...

amount

...

Long

...

Номинал

...

Статус:

Activate
Blocked
Changed
Create
EXTEND
Inactive
PARTIAL_USE
UNDO_USE
Used

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

Блок кода

language	xml
title	Пример запроса на активацию подарочной карты

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:activatePresentCard>
         <!--Optional:-->
         <cardNumber>789222</cardNumber>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>2</cashNum>
            <!--Optional:-->
            <checkNum>4</checkNum>
            <!--Optional:-->
            <createDate>2019-05-13</createDate>
            <!--Optional:-->
            <shiftNum>8</shiftNum>
            <!--Optional:-->
            <shopNum>3382</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <amount>50000</amount>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->
         <userTabNumber>1</userTabNumber>
      </ser:activatePresentCard>
   </soapenv:Body>
</soapenv:Envelope>

-

...

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

...

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

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

cardNumber

...

String

...

Номер карты

...

Дата регистрации чека

Формат

...

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

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

Отменить выдачу подарочной карты. После применения карты её статус будет отображаться "Еще не выдана" "Неактивна"

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

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

Поле		Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber		String	Номер карты		Да
purchaseUid		Collection	Набор полей чека	Нет
	cashNum	Long	Номер кассы	Нет
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	Нет
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Нет
	shiftNum	Long	Номер смены	Нет
	shopNum	Long	Номер магазина	Нет
amount		Long	Номинал	Нет
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
amount		Long	Номинал
balance		Long	Остаток на карте
cardNumber		String	Номер карты
expirationDate		dateTime	Дата окончания действия карты
status		Stringstring	Статус: Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

language	xml
title	Пример запроса на активацию подарочной карты

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:activatePresentCard>
         <cardNumber>445666</cardNumberNew><!--Optional:-->
         <cardNumber>10000002233</cardNumber>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>2</cashNum>
            <!--Optional:-->
            <checkNum>4</checkNum>
            <!--Optional:-->
            <createDate>2019-05-13</createDate>
            <!--Optional:-->
            <shiftNum>8</shiftNum>
            <!--Optional:-->
            <shopNum>3382</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <amount>50000</amount>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->
         <userTabNumber>1</userTabNumber>
      </ser:activatePresentCard>
   </soapenv:Body>
</soapenv:Envelope>

-

URL

Блок кода

Погасить подарочную карту

МетодpaymentPresentCard

title	Пример ответа на запроса активации подарочной карты

<soap:Envelope xmlns:soap="http://

IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManagerWSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdlКомментарийОтменить выдачу подарочной карты. После применения карты её статус будет отображаться "Еще не выдана" "Неактивна"

Поле

Тип данных

Описание

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

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

cardNumberStringНовый номер карты из существующих диапазоновДаpurchaseUidCollectionНабор полей чекаДаcashNumLongНомер кассыДаcheckNumLongНомер чека к которому будет привязана активация подарочной картыДаcreateDatedateTime

Дата регистрации чека

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

ДаshiftNumLongНомер сменыДаshopNumLongНомер магазинаДаuserNameStringИмя пользователяНетuserTabNumberStringID серверного пользователяНет

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

paymentPresentCardResponseОтображение наименования ответа paymentPresentCardResponse в

schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:activatePresentCardResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-10-05T14:37:57.367+03:00</activationDate>
            <amount>40000</amount>
            <balance>40000</balance>
            <cardNumber>10000002233</cardNumber>
            <maxAmount>0</maxAmount>
            <multiplicity>0</multiplicity>
            <status>Active</status>
         </return>
      </ns2:activatePresentCardResponse>
   </soap:Body>
</soap:Envelope>

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

Поле		Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumberOld		String	Номер старой подарочной карты, которая будет деактивирована	Да
cardNumberNew		String	Номер новой подарочной карты, которая будет активирована	Да
purchaseUid		Collection	Набор полей чека	Нет
	cashNum	Long	Номер кассы	Нет
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	Нет
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Нет
	shiftNum	Long	Номер смены	Нет
	shopNum	Long	Номер магазина	Нет
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
cardReplacementResponse			Отображение наименования ответа `cardReplacementResponse` в случае успешной обработки пакета

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

Блок кода

language	xml
title	Пример запроса на

...

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:

...

cardReplacement>
         <!--Optional:-->

...

<cardNumberOld>10000002233</cardNumberOld>
         <!--Optional:-->
         <cardNumberNew>10000002235</cardNumberNew>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->

...

<cashNum>23</cashNum>
            <!--Optional:-->

...

<checkNum>2</checkNum>
            <!--Optional:-->

...

<createDate>2023-05-

...

10</createDate>
            <!--Optional:-->

...

<shiftNum>2</shiftNum>
            <!--Optional:-->

...

<shopNum>779</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->

...

<userTabNumber>34</userTabNumber>
      </ser:

...

cardReplacement>
   </soapenv:Body>
</soapenv:Envelope>

-

...

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

...

Поле

...

Тип данных

...

Описание

...

Блок кода

title	Пример ответа на запрос по замене подарочной карты

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:cardReplacementResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return/>
      </ns2:cardReplacementResponse>
   </soap:Body>
</soap:Envelope>

-

Деактивация подарочной карты
Метод	deActivatePresentCard
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	Новый номер карты из существующих диапазонов	Да
amountpurchaseUid		Collection	Набор полей чека	Нет
	cashNum	Long	Сумма списания в размере номинала подарочной карты. Нельзя списать сумму превышающую номинал подарочной карты.
	purchaseUid		Collection	Набор полей чека	Да
	cashNum	Long	Номер кассы	Да	Номер кассы	Нет
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	ДаНет
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Да
shiftNum	Long	Номер смены	Да
shopNum	Long	Номер магазина	Да
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
redeemPresentCardResponse		Отображение наименования ответа `paymentPresentCardResponse` в случае успешной обработки пакета

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

Блок кода

title	Списание суммы в размере 11руб.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <ser:redeemPresentCard>

: YYYY-MM-DD	Нет
shiftNum	Long	Номер смены	Нет
shopNum	Long	Номер магазина	Нет
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
amount		Long	Номинал
balance		Long	Остаток на карте
cardNumber		String	Номер карты
expirationDate		dateTime	Дата окончания действия карты
status		String	Статус: Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

language	xml
title	Пример запроса на деактивацию подарочной карты

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:deActivatePresentCard>
         <!--Optional:-->
         <cardNumber>10000002233</cardNumber>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>3</cashNum>
            <!--Optional:-->
            <checkNum>23</checkNum>
            <!--Optional:-->
            <createDate>2023-10-04</createDate>
            <!--Optional:-->
            <shiftNum>3</shiftNum>
            <!--Optional:-->
            <shopNum>779</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->
         <userTabNumber>3</userTabNumber>
      </ser:deActivatePresentCard>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

title	Пример ответа на запрос по деактивации подарочной карты

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:deActivatePresentCardResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <amount>40000</amount>
            <balance>40000</balance>
            <cardNumber>10000002233</cardNumber>
            <maxAmount>0</maxAmount>
            <multiplicity>0</multiplicity>
            <status>Create</status>
         </return>
      </ns2:deActivatePresentCardResponse>
   </soap:Body>
</soap:Envelope>

Получить информацию по подарочной карте
Метод	getPresentCardInfo
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	Новый номер карты из существующих диапазонов	Да
msrCardNumber	String	Номер карты из магнинтой дорожки (полосы)	Нет
shopNumber	Long	Набор полей чека	Нет
Возвращаемые параметры
activationDate	dateTime	Дата активации
amount	Long	Номинал
balance	Long	Остаток на карте
cardNumber	String	Номер карты
maxAmount	String	Максимальный номинал
multiplicity	String	Кратность
status	String	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

language	xml
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
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	Новый номер карты из существующих диапазонов	Да
Возвращаемые параметры
activationDate	dateTime	Дата активации
amount	Long	Номинал
balance	Long	Остаток на карте
cardNumber	String	Номер карты
maxAmount	String	Максимальный номинал
multiplicity	String	Кратность
status	String	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

language	xml
title	Пример запроса на получение информации по подарочной карте

<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>10000002234</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

title	Пример ответа на запрос получение информации о подарочной карте по номеру

<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-10-05T12:43:34.256+03:00</activationDate>
            <amount>40000</amount>
            <balance>0</balance>
            <cardNumber>10000002234</cardNumber>
            <maxAmount>0</maxAmount>
            <multiplicity>0</multiplicity>
            <status>Used</status>
         </return>
      </ns2:getPresentCardInformationResponse>
   </soap:Body>
</soap:Envelope>

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

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
msrCardNumber	String	Номер карты из магнинтой дорожки (полосы)	Да
Возвращаемые параметры
activationDate	dateTime	Дата активации
amount	Long	Номинал
balance	Long	Остаток на карте
cardNumber	String	Номер карты
maxAmount	String	Максимальный номинал
multiplicity	String	Кратность
status	String	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

language	xml
title	Пример запроса на получение информации о подарочной карте по номеру магнитной полосы

<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>10000002235</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

title	Пример ответа на запрос по получению информации о подарочной карте по номеру магнитной полосы

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationByMSRNumberResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <amount>40000</amount>
            <balance>40000</balance>
            <cardNumber>10000002235</cardNumber>
            <maxAmount>0</maxAmount>
            <multiplicity>0</multiplicity>
            <status>Create</status>
         </return>
      </ns2:getPresentCardInformationByMSRNumberResponse>
   </soap:Body>
</soap: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	Коллекция статусов	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна	Нет
Возвращаемые параметры
getPresentCardsInfoByFilterResponse	Base64	Информация по подарочной карте в формате 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	Комплексный	Причина продления

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

Блок кода

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

<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>10000002234</cardNumber>
            <!--Optional:-->
            <endDateFrom>2023-10-05</endDateFrom>
            <!--Optional:-->
            <endDateTo>2024-10-05</endDateTo>
            <!--Optional:-->
            <operationDateFrom>2023-10-02</operationDateFrom>
            <!--Optional:-->
            <operationDateTo>2024-10-05</operationDateTo>
            <!--Optional:-->
            <paymentDate>2023-10-05</paymentDate>
            <!--Optional:-->
            <saleDate>2023-10-05</saleDate>
            <!--Optional:-->
            <startDateFrom>2023-10-05</startDateFrom>
            <!--Optional:-->
            <startDateTo>2023-10-05</startDateTo>
            <!--Optional:-->
            <status>Active</status>
         </filter>
      </ser:getPresentCardsInfoByFilter>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<presentCards xmlns="http://crystals.ru/cards/presentcards/report">
	<presentCard>
		<cardNumber>10000002234</cardNumber>
		<amount>40000</amount>
		<balance>40000</balance>
		<status>Active</status>
		<startDate>2023-10-05T12:43:34.256+03:00</startDate>
		<endDate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
		<replacedCardNumber/>
		<actions>
			<action type="Create" date="2023-10-05T12:43:34.256+03:00" source="SERVER"/>
			<action type="Activate" date="2023-10-05T12:43:34.257+03:00" 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>

Погасить подарочную карту (перевести в статус "использована/погашена")
Метод	paymentPresentCard
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	Новый номер карты из существующих диапазонов	Да
purchaseUid		Collection	Набор полей чека	Нет
	cashNum	Long	Номер кассы	Нет
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	Нет
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Нет
	shiftNum	Long	Номер смены	Нет
	shopNum	Long	Номер магазина	Нет
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
paymentPresentCardResponse			Отображение наименования ответа `paymentPresentCardResponse` в случае успешной обработки пакета

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

Блок кода

language	xml
title	Пример запроса на гашение подарочной карты

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:paymentPresentCard>
         <!--Optional:-->
         <cardNumber>654987</cardNumber>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>2</cashNum>
            <!--Optional:-->
            <checkNum>4</checkNum>
            <!--Optional:-->
            <createDate>2019-05-15</createDate>
            <!--Optional:-->
            <shiftNum>8</shiftNum>
            <!--Optional:-->
            <shopNum>3382</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->
         <userTabNumber>1</userTabNumber>
      </ser:paymentPresentCard>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

title	Пример ответа на запрос Пример запроса гашения подарочной карты

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:paymentPresentCardResponse xmlns:ns2="http://services.processing.cards.crystals.ru/"/>
   </soap:Body>
</soap:Envelope>

-ыы

Списать сумму с подарочной карты
Метод	redeemPresentCard
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	Новый номер карты из существующих диапазонов	Да
amount		Long	Сумма списания в размере номинала подарочной карты. Нельзя списать сумму превышающую номинал подарочной карты.	Да
purchaseUid		Collection	Набор полей чека	Да
	cashNum	Long	Номер кассы	Да
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	Да
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Да
	shiftNum	Long	Номер смены	Да
	shopNum	Long	Номер магазина	Да
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
redeemPresentCardResponse			Отображение наименования ответа `redeemPresentCardResponse` в случае успешной обработки пакета

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

Блок кода

title	Пример запроса на списание суммы в размере 26руб.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:redeemPresentCard>
         <!--Optional:-->
         <cardNumber>111333</cardNumber>
         <!--Optional:-->
         <amount>2600</amount>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>2</cashNum>
            <!--Optional:-->
            <checkNum>4</checkNum>
            <!--Optional:-->
            <createDate>2019-05-15</createDate>
            <!--Optional:-->
            <shiftNum>8</shiftNum>
            <!--Optional:-->
            <shopNum>3382</shopNum>
         </purchaseUid>
         <!--Optional:-->
         <userName>manager</userName>
         <!--Optional:-->
         <userTabNumber>1</userTabNumber>
      </ser:redeemPresentCard>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

title	Пример ответ на запроса по списанию суммы с подарочной карты.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:redeemPresentCardResponse xmlns:ns2="http://services.processing.cards.crystals.ru/"/>
   </soap:Body>
</soap:Envelope>

Переотправить подарочные карты в SetESB/Kafka по фильтру
Метод	resendPresentCardsToKafkaByFilter
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	Коллекция статусов	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна	Нет
Возвращаемые параметры
resendPresentCardsToKafkaByFilter	Base64	Отображение наименования ответа `resendPresentCardsToKafkaByFilter` в случае успешной обработки пакета

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

Блок кода

language	xml
title	Пример запроса на переотправку подарочные карты в SetESB/Kafka по фильтру

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:resendPresentCardsToKafkaByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>10000002234</cardNumber>
            <!--Optional:-->
            <endDateFrom>2023-10-05</endDateFrom>
            <!--Optional:-->
            <endDateTo>2024-10-05</endDateTo>
            <!--Optional:-->
            <operationDateFrom>2023-10-02</operationDateFrom>
            <!--Optional:-->
            <operationDateTo>2024-10-05</operationDateTo>
            <!--Optional:-->
            <paymentDate>2023-10-05</paymentDate>
            <!--Optional:-->
            <saleDate>2023-10-05</saleDate>
            <!--Optional:-->
            <startDateFrom>2023-10-05</startDateFrom>
            <!--Optional:-->
            <startDateTo>2023-10-05</startDateTo>
            <!--Optional:-->
            <status>Active</status>
         </filter>
      </ser:resendPresentCardsToKafkaByFilter>
   </soapenv:Body>
</soapenv:Envelope>

Блок кода

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:resendPresentCardsToKafkaByFilterResponse xmlns:ns2="http://services.processing.cards.crystals.ru/"/>
   </soap:Body>
</soap:Envelope>

-ыы

Отмена использования подарочной карты (возврат из статуса погашенной)
Метод	undoUsePresentCard
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	Новый номер карты из существующих диапазонов	Да
purchaseUid		Collection	Набор полей чека	Нет
	cashNum	Long	Номер кассы	Нет
	checkNum	Long	Номер чека к которому будет привязана активация подарочной карты	Нет
	createDate	dateTime	Дата регистрации чека Формат: YYYY-MM-DD	Нет
	shiftNum	Long	Номер смены	Нет
	shopNum	Long	Номер магазина	Нет
userName		String	Имя пользователя	Нет
userTabNumber		String	ID серверного пользователя	Нет
Возвращаемые параметры
activationDate		dateTime	Дата активации
amount		Long	Номинал
balance		Long	Остаток на карте
cardNumber		String	Номер карты
maxAmount		String	Максимальный номинал
multiplicity		String	Кратность
status		String	Статус Activate - активирована Blocked - заблокирована Changed - заменена Create - создана EXTEND - продлен срок действия Inactive - неактивирована PARTIAL_USE - частичное списана UNDO_USE - отмена использования (возврат из гашения) Used - использовна

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

Блок кода

title	Пример запроса на отмену использования подарочной карты

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:undoUsePresentCard>
         <!--Optional:-->
         <cardNumber>10000002234</cardNumber>
         <!--Optional:-->
         <purchaseUid>
            <!--Optional:-->
            <cashNum>3</cashNum>
            <!--Optional:-->
            <checkNum>2</checkNum>
            <!--Optional:-->
            <createDate>2023-10-05</createDate>
            <!--Optional:-->
            <shiftNum>34</shiftNum>
            <!--Optional:-->
         <cardNumber>111333</cardNumber>   <shopNum>57</shopNum>
      <!--Optional:-->          <amount>2600</amount></purchaseUid>
         <!--Optional:-->
         <purchaseUid><userName>manager</userName>
            <!--Optional:-->
            <cashNum>2</cashNum><userTabNumber>344</userTabNumber>
      </ser:undoUsePresentCard>
   </soapenv:Body>
 <!--Optional:-->
            <checkNum>4</checkNum>
   </soapenv:Envelope>

Блок кода

title	Пример ответа на запрос отмены использования подарочной карты

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
        <!--Optional:--<ns2:undoUsePresentCardResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
            <createDate>2019-05-15</createDate><return>
            <!--Optional:--><activationDate>2023-10-05T12:43:34.256+03:00</activationDate>
            <shiftNum>8<<amount>40000</shiftNum>amount>
            <!--Optional:--><balance>40000</balance>
            <shopNum>3382<<cardNumber>10000002234</shopNum>cardNumber>
         </purchaseUid>   <maxAmount>0</maxAmount>
      <!--Optional:-->      <multiplicity>0</multiplicity>
   <userName>manager</userName>          <!--Optional:--><status>Active</status>
          <userTabNumber>1<</userTabNumber>return>
      </serns2:redeemPresentCard>undoUsePresentCardResponse>
   </soapenvsoap:Body>
</soapenvsoap:Envelope>

-

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

Старая версия 5

Новая версия 6

Ключ

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

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

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

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

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

Погасить подарочную карту

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

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

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

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

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

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

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

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

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

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

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

Сравнение страниц

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

Старая версия 5

Новая версия 6

Ключ

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

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

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

Погасить подарочную карту

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

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

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

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

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

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

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

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

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

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

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