Импорт дисконтных карт и анкет клиентов из ERP в SetRetail10

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

Импорт дисконтных карт и анкет клиентов из ERP в SetRetail10

Для чтения визуальной составляющей схемы XSD, а также типами обязательных данных, ознакомьтесь с правилами использования.

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

Без обратной связи

Метод

getCardsCatalog

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport

WSDL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport?wsdl

Поле

Тип данных

Описание

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

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

 

 

 

cardsCatalogXML

base64Binary

Справочник карт и анкет клиентов в формате XML, кодированный с помощью base64Binary

Да

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

return

boolean

True в случае успешной обработки пакета

 

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

 

C обратной связью

Метод

getCardsCatalogWithTi

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport

WSDL

http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport?wsdl

Поле

Тип данных

Описание

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

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

cardsCatalogXML

base64Binary

Справочник карт в формате XML кодированный с помощью base64Binary

Да

ti

String

Transaction Id - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.

Нет

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

return

boolean

True в случае успешной обработки пакета

 

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

Важно

Идентификатор пакета ti

Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

Начисление бонусных баллов через веб-сервис

Для начисления бонусных баллов из ERP системы используйте веб-сервис и методы из статьи SetRetail10 ◾️ Ручное начисление бонусов.

Импорт карт <cards-catalog>

cards-catalog

Поле

Тип данных

Описание

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

internal-card-type

Комплексный

Список типов внутренних карт

Нет

internal-card

Комплексный

Список внутренних карт

Нет

bonus-account

Комплексный

Список обновлений бонусных счетов

Нет

Категории внутренних карт <internal-card-type>

cards-catalog/internal-card-type

Поле

Тип данных

Описание

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

guid

Long

Уникальный идентификатор категории внутренних карт. Ключевое поле.

Да

name

String

Название категории внутренних карт

Да

color

String

Цвет категории карты из списка:

  • BLUE

  • BRONZE

  • COPPER

  • GOLD

  • GREEN

  • GREY

  • IRON

  • ORANGE

  • PLATINUM

  • RED

  • SILVER

  • WHITE

  • YELLOW

Нет

personalized

Boolean

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

Нет

percentage-discount

Double

Процент скидки категории карт

Если не размер процента скидки отсутствует, тогда задается значение = 0

Да

work-period-start

Date

Дата начала действия категории, по умолчанию устанавливается время импорта

Нет

work-period-end

Date

Дата окончания действия категории, по умолчанию время срока действия категории карт не ограничен

Нет

show-card-from-range-notification

Boolean

Информировать кассира о добавлении карты из диапазона

Допустимые значения:

  • true

  • false

Нет

deleted

Boolean

Передается true для удаления категории

Допустимые значения:

  • true

  • false

Нет

card-range

Комплексный

Список диапазонов карт

Нет

Диапазон внутренних карт <card-range>

cards-catalog/internal-card-type/card-range

Поле

Тип данных

Описание

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

guid

Long

Уникальный идентификатор диапазона внутренних карт.

Ключевое поле

Да

startField

String

Номер первой карты диапазона

Да

countField

nonNegativeInteger

Количество карт в диапазоне

Да

deleted

Boolean

Передается true для удаления диапазона

Да

Экземпляры внутренних карт <internal-card>

cards-catalog/internal-card

Поле

Тип данных

Описание

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

number

String

Номер карты

Да

amount

Double

Сумма накоплений на карте

Нет

expiration-date

Date

Дата окончания срока действия, более приоритетный срок действия, чем общий срок действия категории карт

Нет

status

Комплексный

Статус карты из списка

  • ACTIVE

  • BLOCKED

  • CREATE

  • INACTIVE

  • PRE_ACTIVE

  • PRE_DEACTIVE

  • PRE_USED

  • USED

Да

deleted

Boolean

Передается true для удаления карты

Да

card-type-guid

Long

Ссылка на идентификатор категории карт.

Поле является обязательным при загрузке нового, ранее не существовавшего в базе данных экземпляра карты. При этом в поле передается идентификатор уже существующей категории карт.

Нет

percentage-discount

Double

Процент скидки по карте. Заполняется, если не указан Card-type-guid. Карта будет привязана к категории с данным процентом карты

Нет

attached-to-counterparty

Boolean

Привязка карты к контрагенту (юридическому лицу).

Допустимые значения:

  • true

  • false

Нет

client

Комплексный

Привязка карты к клиенту

Нет

counterparty

Комплексный

Привязка карты к контрагенту (юридическому лицу)

Нет

purchase-accumulation

Комплексный

Накопления по карте

Нет

Клиенты внутренних карт <client>

cards-catalog/internal-card/client

Поле

Размер

Тип данных

Описание

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

guid

 

Long

Идентификатор клиента

Да

last-name

128

String

Фамилия клиента

Нет

first-name

128

String

Имя клиента

Нет

middle-name

128

String

Отчество клиента

Нет

сlient-type

 

typeClient

Тип клиента:

  • PRIVATE – Физическое лицо

  • JURISTIC_PERSON – Юридическое лицо

Нет

birth-date

 

Date

Дата рождения клиента

Нет

sex

 

sexType

Пол клиента. По умолчанию не указан.

  • MALE

  • FEMALE

Нет

marital

 

Boolean

Семейное положение: Замужем/Женат

Допустимые значения:

  • true

  • false

Нет

auto

 

Boolean

Наличие автомобиля

Допустимые значения:

  • true

  • false

Нет

pass-number

12

String

Номер паспорта

Нет

pass-serie

12

String

Серия паспорта

Нет

phone

12

String

Домашний телефон

Обратите внимание, что для передачи мобильного телефона необходимо использовать другой атрибут, а именно mobile-phone (описан ниже).

Нет

email

128

String

Электронная почта клиента

Нет

city

128

String

Название города

Нет

region

128

String

Регион/Область

 

district

128

String

Район

Нет

district-area

128

String

Район города

Нет

zip

6

String

Индекс

Нет

street

128

String

Улица

Нет

house

6

String

Номер дома

Нет

building

6

String

Корпус (строение)

Нет

apartment

6

String

Квартира

Нет

mobile-phone

128

String

Мобильный телефон

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

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