/
Загрузка информации по подарочным картам

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

Загрузка информации по подарочным картам

нояб. 02, 2020

Функциональность обновлена и расширена в версии 10.2.59.0

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

https://crystals.atlassian.net/browse/SR-2083

10.2.47.0

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

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

Да

Номер магазина

 

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

Метод

activatePresentCard

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

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

Формат 

Нет

shiftNum

Long

Номер смены

Нет

shopNum

Long

Номер магазина

Нет

amount

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

 

Пример запроса на активацию подарочной карты
<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>

-

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

Метод

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

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

Да

purchaseUid

Collection

Набор полей чека

Нет

 

cashNum

Long

Номер кассы

Нет

checkNum

Long

Номер чека к которому будет привязана активация подарочной карты

Нет

createDate

dateTime

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

Формат: 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

 

Пример запроса на активацию подарочной карты
<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:--> <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:--> <userName>manager</userName> <!--Optional:--> <userTabNumber>1</userTabNumber> </ser:activatePresentCard> </soapenv:Body> </soapenv:Envelope>

-

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

Метод

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