Table of Contents
...
Anchor wsbonus wsbonus
URL | http://IP-адрес_сервера:8090/SET-Cards/SET/Cards/ExternalSystemCardsProcessing |
WSDL | http://IP-адрес_сервера:8090/SET-Cards/SET/Cards/ExternalSystemCardsProcessing?wsdl |
...
Информация по номеру карты размера и даты следующей активации бонусных баллов на счету | ||||||||||
Также можно получить размер и дату следующего сгорания бонусных баллов. | ||||||||||
Метод | getBonusAccountsInformation | |||||||||
Поле | Тип данных | Описание | Обязательное | |||||||
Принимаемые параметры | ||||||||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | |||||||
Возвращаемые параметры | ||||||||||
return | Комплексный | Коллекция элементов с данными по бонусному счёту. | Да | |||||||
errorCode | Long | Код ошибки при вызове метода. Базовый список кодов ошибок для всех методов:
| Да | |||||||
errorText | String | Текст ошибки. | Да | |||||||
accounts | tns:bonusAccountInformationVO | Коллекция элементов с информацией по бонусным счетам. | Нет | |||||||
activeBonuses | Long | Действующие бонусные баллы. | Нет | |||||||
bonusAccountTypeId | Long | Идентификатор типа бонусного счета.
| Нет | |||||||
nextActivationDate | DateTime | Следующая дата активации бонусных баллов. | Нет | |||||||
nextActivationSum | Long | Следующая сумма активации бонусных баллов. | Нет | |||||||
nextCancelingDate | DateTime | Следующая дата сгорания бонусных баллов. | Нет | |||||||
nextCancelingSum | Long | Следующая сумма сгорания бонусных баллов. | Нет | |||||||
nonActiveBonuses | Long | Неактивированные бонусные баллы. | Нет |
...
Получить по номеру карты подробную информацию (данные категории карты, анкета владельца) | |||||||||||||||
Метод | getCardInformationByNumber | ||||||||||||||
Поле | Тип данных | Описание | Обязательное | ||||||||||||
Принимаемые параметры | |||||||||||||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | ||||||||||||
Возвращаемые параметры | |||||||||||||||
return | Комплексный | Коллекция элементов с данными по бонусному счёту и информацией по клиенту. | Да | ||||||||||||
bonus | Boolean | Бонусный счет:
| Нет | ||||||||||||
bonusAccounts | Комплексный | Коллекция бонусных счетов клиента. | Нет | ||||||||||||
balance | Long | Баланс бонусного счета. | Нет | ||||||||||||
bonusAccountId | Long | Уникальный идентификатор бонусного счета. | Нет | ||||||||||||
bonusAccountsTypeVO | Комплексный | Коллекция элементов бонусного счета. | Нет | ||||||||||||
accountsType | tns:bonusAccountsType | Тип бонусного счёта:
| Нет | ||||||||||||
bonusAccountTypeCode | Long | Код типа бонусного счёта - уникальная сущность в рамках всей сети. Данный код будет отдаваться при создании плагина результата. | Нет | ||||||||||||
bonusAccountTypeId | Long | Идентификатор типа бонусного счета. | Нет | ||||||||||||
bonusAccountsTypeName | String | Нименование типа счета. | Нет | ||||||||||||
bonusCourse | Long | Курс бонусов к валюте. | Нет | ||||||||||||
currencyCourse | Long | Курс валюты счета. | Нет | ||||||||||||
entirePurchase | Boolean | Оплата бонусами чека:
| Нет | ||||||||||||
writeOffAllAmountAtOnce | Boolean | Списывать всю сумму бонусов за одно применение карты.
| Нет | ||||||||||||
enabled | Boolean | Статус бонусного счёта:
| Нет | ||||||||||||
cardNumber | String | Номер карты. | Да | ||||||||||||
cardTypeVO
| Комплексный | Коллекция элементов категории карты. | Да | ||||||||||||
id | Long | Идентификатор категории карты. | Да | ||||||||||||
classType | String | Тип внутреннего класса карты. | Да | ||||||||||||
color | tns:displayColor | Коллекция элементов для цветовой маркировки карты в формате RGB. | Да | ||||||||||||
blue | Integer | Синий | Да | ||||||||||||
green | Integer | Зеленый | Да | ||||||||||||
red | Integer | Красный | Да | ||||||||||||
deleted | Boolean | Статус категории:
| Да | ||||||||||||
guid | Long | Уникальный GUID категории карт. | Да | ||||||||||||
name | String | Наименование категории карт. | Да | ||||||||||||
personalized | Boolean | Персонифицированная (к картам в этой категории можно заполнить анкету клиенты):
| Да | ||||||||||||
accumulative | Boolean | Накопительная (для перехода из категории в категории. Не бонусные баллы!):
| Да | ||||||||||||
bonus | Boolean | Бонусная:
| Да | ||||||||||||
domesticCredit | Boolean | Внутренний кредит:
| Да | ||||||||||||
finish | DateTime | Окончание срока действия. | Да | ||||||||||||
percentageDiscount | Long | Размер скидки в процентах. | Да | ||||||||||||
showCardFromRangeNotification | Boolean | Наличие правил перехода из одной категории в другую:
| Нет | ||||||||||||
start | DateTime | Начало срока действия. | Да | ||||||||||||
withoutFinishDate | Boolean | Без срока окончания срока действия.
| Нет | ||||||||||||
cardVO | Комплексный | Коллекция элементов данных по экземпляру привязанной карты к счету. | Да | ||||||||||||
id | Long | Идентификатор экземпляра привязаной карты. | Да | ||||||||||||
activationDate | DateTime | Дата активации карты. | Да | ||||||||||||
amount | Long | Количество накоплений для перехода из одной категории в другую. | Да | ||||||||||||
balance | Long | Общий баланс накоплений (не бонусных). | Да | ||||||||||||
blockDate | DateTime | Дата блокировки. | Нет | ||||||||||||
blocked | Boolean | Статус блокировки:
| Да | ||||||||||||
cardTypeVO | Комплексный | Коллекция элементов категории карты. | Нет | ||||||||||||
clientVO | Комплексный | Коллекция элементов анкеты клиента. | Нет | ||||||||||||
id | Long | Уникальный идентификатор анекты клиента. | Да | ||||||||||||
auto | Boolean | Наличие автомобиля:
| Нет | ||||||||||||
birthDate | DateTime | Дата рождения. | Нет | ||||||||||||
bonusBalance | Long | Количество бонусных баллов на счете. | Нет | ||||||||||||
childrenAge | String | Дети. | Нет | ||||||||||||
clientAddress | Комплексный | Коллекция элементов адреса анкеты клиента. | Нет | ||||||||||||
appartment | String | Квартира. | Нет | ||||||||||||
building | String | Корпус. | Нет | ||||||||||||
city | String | Город. | Нет | ||||||||||||
district | String | Район (НЕ ИСПОЛЬЗУЕТСЯ). | Нет | ||||||||||||
districtArea | String | Район. | Нет | ||||||||||||
house | String | Дом. | Нет | ||||||||||||
other | String | Другое. | Нет | ||||||||||||
region | String | Область (регион). | Нет | ||||||||||||
street | String | Улица | Нет | ||||||||||||
zip | String | Индекс | Нет | ||||||||||||
clientType | tns:clientType | Тип клиента:
| Да | ||||||||||||
creationDate | DateTime | Дата создания анкеты. | Да | ||||||||||||
deleted | Boolean | Статус анкеты:
| Да | ||||||||||||
String | Адрес элетронной почты. | Нет | |||||||||||||
firstName | String | Имя. | Да | ||||||||||||
guid | Long | Уникальный GUID анекты клиента. | Да | ||||||||||||
isCompleted | Booelan | Статус анкеты:
| Да | ||||||||||||
lastChangeDate | DateTime | Дата последних изменений в анкете. | Да | ||||||||||||
lastName | String | Фамилия. | Да | ||||||||||||
marital | Boolean | Женат/замужем:
| Нет | ||||||||||||
middleName | String | Отчество. | Нет | ||||||||||||
mobileOperator | String | Оператор мобильной связи. | Нет | ||||||||||||
mobilePhone | String | Мобильный телефон. | Нет | ||||||||||||
passport | Комплексный | Коллекция элементов паспортных данных. | Нет | ||||||||||||
delivery | String | Кем выдан. | Нет | ||||||||||||
deliveryDate | String | Дата выдачи. | Нет | ||||||||||||
passNumber | String | Номер. | Нет | ||||||||||||
passSerie | String | Серия. | Нет | ||||||||||||
phone | String | Домашний телефон | Нет | ||||||||||||
receiptFeedbackType | String | Уведомление обладателя карты о совершенной покупке для отправки чека:
| Да | ||||||||||||
sendBy | Комплексный | Комплекс элементов определяющих согласие на методы рассылки рекламного каталога. | Нет | ||||||||||||
byEMail | Boolean | Отправлять по электронной почте.
| Нет | ||||||||||||
byMail | Boolean | Отправлять по обычной почте.
| Нет | ||||||||||||
byPhone | Boolean | Оповещение по телефону.
| Нет | ||||||||||||
bySMS | Boolean | Отправлять SMS.
| Нет | ||||||||||||
sendCatalog | Boolean | Отправять рекламный каталог.
| Нет | ||||||||||||
sex | tns:sex | Пол:
| Нет | ||||||||||||
shopNumber | Integer | Номер магазина. | Нет | ||||||||||||
smartphoneType | String | Тип смартфона:
| Нет | ||||||||||||
wantsECard | Boolean | Признак хочет ли клиент получить элетронную карту.
| Нет | ||||||||||||
counterpartyId | String | Идентификатор привязки к юридическому лицу: ИНН;КПП | Нет | ||||||||||||
createDate | DateTime | Дата создания клиента. | Да | ||||||||||||
deleted | Boolean | Статус клиента.
| Да | ||||||||||||
guid | Long | Уникальный GUID клиента. | Да | ||||||||||||
number | Long | Номер карты | Да | ||||||||||||
signChangeOfCategoryCard | Boolean | Признак смены категории карты.
| Нет | ||||||||||||
signExtensionCard | Boolean | Признак продления карты.
| Нет | ||||||||||||
status | String | Статус карты:
| Да | ||||||||||||
domesticCredit | Boolean | Внутренний кредит:
| Да | ||||||||||||
personalized | Boolean | Персонифициарованная Персонифицированная карта:
| Да |
...
Информация по номеру карты об анкете клиента | ||||||||
Метод | getClientInfoByCardNumber | |||||||
Поле | Тип данных | Описание | Обязательное | |||||
Принимаемые параметры | ||||||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | |||||
Возвращаемые параметры | ||||||||
return | Комплексный | Коллекция элементов с информацией из анкеты клиента. | Да | |||||
id | Long | Уникальный идентификатор анекты клиента. | Да | |||||
auto | Boolean | Наличие автомобиля:
| Нет | |||||
birthDate | DateTime | Дата рождения. | Нет | |||||
bonusBalance | Long | Количество бонусных баллов на счете. | Нет | |||||
childrenAge | String | Дети. | Нет | |||||
clientAddress | Комплексный | Коллекция элементов адреса анкеты клиента. | Нет | |||||
appartment | String | Квартира. | Нет | |||||
building | String | Корпус. | Нет | |||||
city | String | Город. | Нет | |||||
district | String | Район (НЕ ИСПОЛЬЗУЕТСЯ). | Нет | |||||
districtArea | String | Район. | Нет | |||||
house | String | Дом. | Нет | |||||
other | String | Другое. | Нет | |||||
region | String | Область (регион). | Нет | |||||
street | String | Улица | Нет | |||||
zip | String | Индекс | Нет | |||||
clientType | tns:clientType | Тип клиента:
| Да | |||||
creationDate | DateTime | Дата создания анкеты. | Да | |||||
deleted | Boolean | Статус анкеты:
| Да | |||||
String | Адрес элетронной почты. | Нет | ||||||
firstName | String | Имя. | Нет | |||||
guid | Long | Уникальный GUID анекты клиента. | Нет | |||||
isCompleted | Boolean | Статус анкеты:
| Да | |||||
lastChangeDate | DateTime | Дата последних изменений в анкете. | Да | |||||
lastName | String | Фамилия. | Да | |||||
marital | Boolean | Женат/замужем:
| Нет | |||||
middleName | String | Отчество. | Нет | |||||
mobileOperator | String | Оператор мобильной связи. | Нет | |||||
mobilePhone | String | Мобильный телефон. | Нет | |||||
passport | Комплексный | Коллекция элементов паспортных данных. | Нет | |||||
delivery | String | Кем выдан. | Нет | |||||
deliveryDate | String | Дата выдачи. | Нет | |||||
passNumber | String | Номер. | Нет | |||||
passSerie | String | Серия. | Нет | |||||
phone | String | Домашний телефон | Нет | |||||
receiptFeedbackType | String | Уведомление обладателя карты о совершенной покупке для отправки чека:
| Да | |||||
sendBy | Комплексный | Комплекс элементов определяющих согласие на методы рассылки рекламного каталога. | Нет | |||||
byEMail | Boolean | Отправлять по электронной почте.
| Нет | |||||
byMail | Boolean | Отправлять по обычной почте.
| Нет | |||||
byPhone | Boolean | Оповещение по телефону.
| Нет | |||||
bySMS | Boolean | Отправлять SMS.
| Нет | |||||
sendCatalog | Boolean | Отправять рекламный каталог.
| Нет | |||||
sex | tns:sex | Пол:
| Нет | |||||
shopNumber | Integer | Номер магазина. | Нет | |||||
smartphoneType | String | Тип смартфона:
| Нет | |||||
wantsECard | Boolean | Признак хочет ли клиент получить элетронную карту.
| Нет |
...
Начислить бонусные баллы на счет клиента | ||||||
Метод | chargeOnBonusAccount | |||||
Поле | Тип данных | Описание | Обязательное | |||
Принимаемые параметры | ||||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | |||
bonusAccountType | Long | Идентификатор типа бонусного счета.
| Нет | |||
shopNum | Long | Номер магазина. | Да | |||
cashNum | Long | Номер кассы. | Да | |||
shiftNum | Long | Номер смены. | Да | |||
checkNum | Long | Номер чека. | Да | |||
chargeSum | Long | Сумма начисления в копейках: Например: нужно начислисть 200.22 бонусных балла, тогда значение = 20022 | Да | |||
activatingDate | DateTime | Дата активации бонусных баллов. | Да | |||
expirationDate | DateTime | Дата сгорания бонусных баллов | Нет | |||
Возвращаемые параметры | ||||||
return | Комплексный | Коллекция элементов обратной связи при вызове метода. | Да | |||
errorCode | Long | Код ошибки при вызове метода. Базовый список кодов ошибок для всех методов:
| Да | |||
errorText | String | Текст ошибки. | Нет | |||
transactionId | Long | Идентификатор тразнакции/операции по бонусному счету | Да |
...
Отмена начисления бонусных баллов на счет клиента (отмена по возврату) | ||||||
Метод | cancelChargeOnBonusAccount | |||||
Поле | Тип данных | Описание | Обязательное | |||
Принимаемые параметры | ||||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | |||
bonusAccountType | Long | Идентификатор типа бонусного счета.
| Нет | |||
shopNum | Long | Номер магазина. | Нет | |||
cashNum | Long | Номер кассы. | Нет | |||
shiftNum | Long | Номер смены. | Нет | |||
checkNum | Long | Номер чека. | Нет | |||
cancelSum | Long | Сумма отмены в копейках: Например: нужно отменить 200.22 бонусных балла, тогда значение = 20022 | Нет | |||
Возвращаемые параметры | ||||||
return | Комплексный | Коллекция элементов обратной связи при вызове метода. | Да | |||
errorCode | Long | Код ошибки при вызове метода. Базовый список кодов ошибок для всех методов:
| Нет | |||
errorText | String | Текст ошибки. | Нет | |||
cancelActiveSum | Long | Количество отмененных активных бонусных баллов. | Нет | |||
cancelNonActiveSum | Long | Количество отмененных неактивных баллов. | Нет |
...
Списание активных бонусных баллов со счета клиента | |||||||
Метод | writeOffFromBonusAccount | ||||||
Поле | Тип данных | Описание | Обязательное | ||||
Принимаемые параметры | |||||||
accountTypeCode | Long | Идентификатор бонусного счета.
| Да | ||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Нет | ||||
writeOffSum | Double | Сумма отмены в копейках c разделителем в виде точки: Например: нужно отменить 200.22 бонусных балла, тогда значение = 200.22 Если сумма указана без точки, тогда будет начислено целое число. | Да | ||||
purchaseUid | Комплексный | Коллекция элементов с информацией по чеку. | Нет | ||||
cashNum | Long | Номер кассы. | Нет | ||||
checkNum | Long | Номер чека. | Нет | ||||
createDate | Long | Дата чека. | Нет | ||||
shiftNum | Long | Номер смены. | Нет | ||||
shopNum | Long | Номер магазина. | Нет | ||||
Возвращаемые параметры | |||||||
return | Boolean | Результат операции:
| Да |
...
Возврат бонусных баллов на счет клиента | |||||||
Метод | returnPaymentToBonusAccount | ||||||
Поле | Тип данных | Описание | Обязательное | ||||
Принимаемые параметры | |||||||
accountTypeCode | Long | Идентификатор бонусного счета.
| Да | ||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Нет | ||||
chargeSum | Double | Сумма возврата бонусных баллов в копейках c разделителем в виде точки: Например: нужно вернуть 200.22 бонусных балла, тогда значение = 200.22 Если сумма указана без точки, тогда будет начислено целое число. | Да | ||||
purchaseUid | Комплексный | Коллекция элементов с информацией по чеку. | Нет | ||||
cashNum | Long | Номер кассы. | Нет | ||||
checkNum | Long | Номер чека. | Нет | ||||
createDate | Long | Дата чека. | Нет | ||||
shiftNum | Long | Номер смены. | Нет | ||||
shopNum | Long | Номер магазина. | Нет | ||||
Возвращаемые параметры | |||||||
ns2:returnPaymentToBonusAccountResponse | Результат операции. Успешная операция без текста ответа. | Да |
...
Пакетное начисление бонусных баллов на счета клиентов | |||||||
Предназначен для начисления бонусов определенному сегменту клиентов. При этом каждому пакету назначается уникальный номер | |||||||
Метод | packageChargeOnBonusAccounts | ||||||
Поле | Тип данных | Описание | Обязательное | ||||
Принимаемые параметры | |||||||
operations | Комплексный | Коллекция элементов по операциям с бонусными счетами | Да | ||||
activatingDate | DateTime | Дата активации бонусных баллов. | Да | ||||
bonusAccountType | Long | Идентификатор бонусного счета.
| Да | ||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Да | ||||
cashNum | Long | Номер кассы. | Да | ||||
chargeSum | Long | Сумма начисления в копейках: Например: нужно начислисть 200.22 бонусных балла, тогда значение = 20022 | Да | ||||
checkNum | Long | Номер чека. | Да | ||||
expirationDate | DateTime | Дата сгорания бонусных баллов. | Да | ||||
requestId | Long | Индентификатор операции внутри запроса | Да | ||||
createDate | Long | Дата чека. | Да | ||||
shiftNum | Long | Номер смены. | Да | ||||
shopNum | Long | Номер магазина. | Да | ||||
externalId | Long | Уникальный номер пакета для отслеживания операции. | Да | ||||
Возвращаемые параметры | |||||||
return | Boolean | Результат операции:
| Да |
...
Запрос статуса пакета с начислением бонусов выполненных пакетным сценарием | ||||||
Метод | getResultOfPackageChargeOnBonusAccounts | |||||
Поле | Тип данных | Описание | Обязательное | |||
Принимаемые параметры | ||||||
externalId | Long | Уникальный номер пакета для отслеживания операции. | Да | |||
Возвращаемые параметры | ||||||
return | Комплексный | Да | ||||
errorCode | Long | Код ошибки при вызове метода. Базовый список кодов ошибок для всех методов:
| Да | |||
errorText | String | Текст ошибки. | Да | |||
externalId | Long | Уникальный номер пакета для отслеживания операции. | Да |
...
Списать заблокированные бонусные баллы со счета клиента | |||||||
Метод | writeOffBlockedFromBonusAccount | ||||||
Поле | Тип данных | Описание | Обязательное | ||||
Принимаемые параметры | |||||||
accountTypeCode | Long | Идентификатор бонусного счета.
| Да | ||||
cardNumber | String | Номер карты. Допустимые значения: буквы или цифры. Без специальных символов. | Нет | ||||
writeOffSum | Double | Сумма отмены в копейках c разделителем в виде точки: Например: нужно отменить 200.22 бонусных балла, тогда значение = 200.22 Если сумма указана без точки, тогда будет начислено целое число. | Да | ||||
purchaseUid | Комплексный | Номер кассы. | Нет | ||||
cashNum | Long | Номер чека. | Нет | ||||
checkNum | Long | Дата чека. | Нет | ||||
createDate | Long | Дата чека. | Нет | ||||
shiftNum | Long | Номер смены. | Нет | ||||
shopNum | Long | Номер магазина. | Нет | ||||
Возвращаемые параметры | |||||||
return | Boolean | Результат операции:
| Да |
...
Подробная инструкция по работе SOAP UI.
1. Откройте SOAP → нажмите SOAP.
2. Введите настройки для подключения веб-сервиса управления бонусными счетами, который описан в интеграционной документации:
- [Project Name] - введите любое наименование проекта.
- Initalial WSDL - введите адрес веб-сервиса управления бонусными баллами на стороне сервера SetRetail10.
- Нажмите OK.
3. Разверните добавленный проект → разверните метод chargeOnBonusAccount → откройте двумя кликами мыши Request 1.
4. Создайте SOAP-запрос на основе примера и описания полей с данными из метода chargeOnBonusAccount вставьте его в окно запроса.
Code Block | ||||
---|---|---|---|---|
| ||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:proc="http://processing.cards.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <proc:chargeOnBonusAccount> <!--Номер карты--> <cardNumber>22022202</cardNumber> <!--id бонусного счета Необязательно (БД SET -> таблица cards_bonusaccountstype -> столбец bonusaccounttypecode)--> <bonusAccountType>11657</bonusAccountType> <!--Номер магазина--> <shopNum>234</shopNum> <!--Номер кассы:--> <cashNum>2</cashNum> <!--Номер смены:--> <shiftNum>1</shiftNum> <!--Номер чека:--> <checkNum>200</checkNum> <!--Сумма начисления в копейках: Например: Нужно начислисть 200.22 Значение 20022 --> <chargeSum>300099</chargeSum> <!--Дата активации бонусных баллов--> <activatingDate>2021-01-01</activatingDate> <!--Дата сгорания бонусных баллов--> <expirationDate>2027-01-31</expirationDate> </proc:chargeOnBonusAccount> </soapenv:Body> </soapenv:Envelope> |
5. Нажмите для выполнения запроса.
6. По результату выполнения запроса, отобразится ответное сообщение:
7. Проверьте начисление бонусных баллов на счете клиента в истории бонусных счетов.
...