Метод

importGiftCards

URL

http://IP-адрес_сервера:8090/PresentCardsImporter/SET/Cards/PresentCards/Import

WSDL

http://IP-адрес_сервера:8090/PresentCardsImporter/SET/Cards/PresentCards/Import?wsdl

Id

Long

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

name

String

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

start-from-number

String

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

count

Integer

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

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

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

Варианты:

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

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

date-start

DateTime

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

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

date-finish

DateTime

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

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

validity

Integer

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

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

validity-time-unit

String

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

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

Параметры:

• DAYS

• WEEKS

• MONTHS

• YEARS

fixed-face-value

Boolean

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

face-value

Long

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

max-face-value

Long

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

multiplicity

Long

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

partial-payment-enabled

Boolean

Признак определяет, разрешено ли частичное гашение карт.

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

topology-filters

String

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

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

https://crystals.atlassian.net/browse/CR-8102

10.3.21.0

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

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

• id - индекс

  • Берется индекс того объекта зоны покрытия level, который присваивается для его указания:

    • Если REGION, то ID из сервера SetCentrum базы данных 

      Open

      

      set, таблица 

      Open

      

      topology_region.

    • Если CITY, то ID из сервера SetCentrum базы данных 

      Open

      

      set, таблица 

      Open

      

      topology_city.

    • Если SHOP, то ID из сервера SetCentrum базы данных 

      Open

      

      set, таблица 

      Open

      

      topology_shop.

• level - зона покрытия привязывается к id в зависимости от типа.

  • ALL - все;

  • REGION - регион;

  • CITY - город;

  • SHOP - магазин.

• formats - наименование формата.

  • Название из поля name сервера SetCentrum базы данных 

    Open

    

    set, таблица 

    Open

    

    topology_format.

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

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

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

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

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

deleted

Boolean

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

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

number

String

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

category-Id

Long

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

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

date-finish

DateTime

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

activation-date

DateTime

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

face-value

Long

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

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

Например, для карты номиналом 2000 рублей необходимо передать значение face-value="200000"

balance

Long

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

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

Например, для карты с балансом 500 рублей 50 копеек необходимо передать значение face-value="50050"

code

String

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

Данный параметр не поддерживается в текущей версии.

deleted

Boolean

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

status

String

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

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

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

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

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