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

Веб-сервис импорта подарочных карт

SR-5903 - Получение подробных данных проблемы… СТАТУС

CR-8099 - Получение подробных данных проблемы… СТАТУС

10.3.21.0

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

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

МетодimportGiftCards
URLhttp://IP-адрес_сервера:8090/PresentCardsImporter/SET/Cards/PresentCards/Import
WSDLhttp://IP-адрес_сервера:8090/PresentCardsImporter/SET/Cards/PresentCards/Import?wsdl

Формат данных для импорта подарочных карт

Категории подарочных карт

Атрибут

Тип данных

Описание

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

Id

Integer

Идентификатор категории, для которой импортируются экземпляры ПК

Да

name

String

Наименование категории подарочных карт

Да

start-from-number

String

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

Да

count

число

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

Запрещены отрицательные значения

Да

Сроки действия карт - комплексный:

Варианты:

  • в указанных период - задаются значения сроков действия

  • с момента активации - задаются значения срока с момента активации

date-start

dateTime

Дата начала срока действия карт диапазона

Нельзя загружать позже срока окончания.

Да

date-finish

dateTime

Дата окончания срока действия карт диапазона

Нельзя загружать раньше срока начала.

Да

validity

число

Срок действия карты с момента активации

Обязателен с параметром validity-time-unit

Да

validity-time-unit

String

Варианты значений: дней, недель, месяцев, лет

Обязателен с параметром validity

Параметры:

  • DAYS
  • WEEKS
  • MONTHS
  • YEARS
Да

fixed-face-value

boolean

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

Да

face-value

число

Сумма фиксированного номинала. Если fixed-face-value имеет значение false, то этот атрибут можно не указывать

Да, при соблюдении условий

max-face-value

число

Максимальная сумма произвольного номинала. Если fixed-face-value имеет значение true, то этот атрибут можно не указывать

Да, при соблюдении условий

multiplicity

число

Кратност�� для суммы произвольного номинала. Если fixed-face-value имеет значение true, то этот атрибут можно не указывать

Да, при соблюдении условий

partial-payment-enabled

boolean

Разрешено ли частичное гашение карт

Если не передан, то не проставляется.

Нет

topology-filters

string

Привязка категории к “группе магазинов”.

SR-5904 - Получение подробных данных проблемы… СТАТУС

CR-8102 - Получение подробных данных проблемы… СТАТУС

10.3.21.0

Формат записи в JSON

1. Формат записывается в следующем составе:

  • id - индекс
    • Берется индекс того объекта зоны покрытия level, который присваивается для его указания:
      • Если REGION, то ID из сервера SetCentrum базы данных set, таблица topology_region.
      • Если CITY, то ID из сервера SetCentrum базы данных set, таблица topology_city.
      • Если SHOP, то ID из сервера SetCentrum базы данных set, таблица topology_shop.
  • level - зона покрытия привязывается к id в зависимости от типа.
    • ALL - все;
    • REGION - регион;
    • CITY - город;
    • SHOP - магазин.
  • formats - наименование формата.
    • Название из поля name сервера SetCentrum базы данных set, таблица topology_format.
[{"id": 63568, "level": "REGION", "formats": [{"id":63568,"name":"ГM1"}]}]

2. Следующим этапом является обязательное экранирование списка магазинов:

[{"id": 63568, "level": "REGION", "formats": [{"id":63568,"name":"ГM1"}]}]

Экранировать можно с помощью онлайн-инструмента.

  • Для экранирования скопируйте JSON-запрос по примеру из п.1 → кликните Escape XML.
  • Для преобразования без экранирования скопируйте экранированный JSON-запрос по примеру из п.2 → кликните Unescape XML.
Нет

deleted

boolean

Признак определяет, что данный диапазон удалён.

Если не передан, то не проставляется.

Нет

Экземпляры подарочных карт

Поле

Тип данных

Описание

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

number

Integer

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

Да

category-Id

Integer

Привязка карты к категории.

ВАЖНО! Карта может быть привязана к любой категории, даже если она не попадает в диапазон

Да

date-finish

dateTime

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

Да

activation-date

dateTime

Дата активации карты

Да

face-value

Integer

Номинал подарочной карты

Может быть с кратностью до сотых. Не может быть отрицательным и нулевым

Да

balance

Integer

Баланс подарочной карты

Может быть с кратностью до сотых.

Не может быть отрицательным

Да

code

String

Проверочный код карты.

Ограничение: кол-во символов не менее 60 символов в формате: A-Za-z0-9._~(){}[]/\%<>=№#$&^!*:@,;+?-|

Да

deleted

Boolean

Признак определяет, что данная карта удалена

Да

status

String

Варианты значений:

  • Create - создана, неактивна

  • Active - активирована

  • Blocked - заблокирована

  • Used - использована (погашена)

Да

Логика импорта

  1. При импорте категорий и экземпляров подарочных карт данные в SetCentrum перезаписываются.

  2. Категория и экземпляры подарочных карт можно загружать, как вместе, так и отдельно.

Пример импорта

Пример файла импорта с экранированием.


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

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