Публичный ресурс
Веб-сервис импорта подарочных карт
- SR-5903Получение подробных данных проблемы… СТАТУС
- CR-8099Получение подробных данных проблемы… СТАТУС
10.3.21.0
Метод веб-сервиса для импорта подарочных карт
Без обратной связи | |
Метод | importGiftCards |
URL | http://IP-адрес_сервера:8090/PresentCardsImporter/SET/Cards/PresentCards/Import |
WSDL | http://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 Параметры:
| Да |
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": 63568, "level": "REGION", "formats": [{"id":63568,"name":"ГM1"}]}] 2. Следующим этапом является обязательное экранирование списка магазинов:
Экранировать можно с помощью онлайн-инструмента.
| Нет |
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 | Варианты значений:
| Да |
Логика импорта
При импорте категорий и экземпляров подарочных карт данные в SetCentrum перезаписываются.
Категория и экземпляры подарочных карт можно загружать, как вместе, так и отдельно.
Пример импорта
Пример файла импорта с экранированием.
© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.