...

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

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

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

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

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

Контрагенты внутренних карт (юридические лица) <counterparty>

Данная привязка означает, что дисконтная карта будет использоваться юридическим лицом.

...

Пример возможной связки клиентов, карт и контрагентов:

Накопления по карте <purchase-accumulation>

Бонусный баланс <bonus-account>

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

Обработка данных

Обработка пакета данных в модуле карт подразумевает следующие этапы:

...

Оба этапа выполняются в одной транзакции для избежания потери данных в случае сбоев в работе.

Обработка категорий карт

• В данных категории карт устанавливается свойства, которые наследуются всеми подчиненными ей картами. Наиболее важным из них является процент скидки по карте.
• Важно понимать, что категории карт ввиду своей немногочисленности могут быть заведены непосредственно в SetRetail10. (Рекомендуется создавать категории карт в SetRetail10).
• В процессе импорта из ERP, при получении данных категорий карт в секции internal-card-type данные в SetRetail10 перезаписываются безусловно. Идентификатором для перезаписи категории является поле guid.
• При импорте недостающие, но необязательные к загрузке поля заполняются значением по умолчанию.
• В случае отсутствия данных в поле work-period-end при импорте новой категории категория карт, их экземпляры становятся бессрочными.
• В случае отсутствия необходимых данных для импорта категорий, категория карт будет отклонена системой.

Обработка диапазонов карт

• Каждый диапазон карт привязан к одной категории карт.
• Диапазоны карт используются в случае, когда нет причин вести карты поштучно (отсутствуют анкеты покупателей, не ведутся накопления и бонусные остатки).
• Важно понимать, что диапазоны карт ввиду своей немногочисленности могут быть заведены непосредственно в SetRetail10.
• В процессе импорта из ERP, при получении данных диапазонов карт в секции card-range, данные в SetRetail10 перезаписываются безусловно. Идентификатором для перезаписи диапазона карт является поле guid.
• В случае отсутствия необходимых данных для импорта, диапазон карт будет отклонен системой.

Обработка экземпляров карт

• Каждая карта привязана к одной категории карт и наследует свойства категории карты (процент скидки, необходимость заполнения анкеты, общий срок действия).
• В процессе импорта из ERP, при получении данных экземпляров карт в секции internal-card, данные в SetRetail перезаписываются безусловно. Идентификатором для перезаписи является поле number.
• При импорте, недостающие, но необязательные к загрузке поля, заполняются значением по умолчанию. Поле createDate заполняется при создании карты датой проведения импорта.
• Привязка экземпляра карты к типу карт осуществляется через атрибут card-type-guid.
• При загрузке из ERP, карты с cardTypeGuid, которых не соответствует ни одному guid из списка уже заведенных в SetRetail10 категорий карт, будут отклонены системой.

Альтернативная схема импорта карт:

• В данной схеме в SetRetail10 должен быть загружен процент скидки по каждой карте, а атрибут card-type-guid должен отсутствовать,
• Карта будет автоматически привязана механизмами SetRetail10, к уже имеющейся, в SetRetail10 категории с соответствующим значением percentage-discount. Такие категории карт, предварительно могут быть заведены в SetRetail10.
  • Если категории с таким discount-percent не существует, или одновременно не указан cardTypeGuid и percentage-discount, карта будет отклонена системой.

Обработка накоплений

• Накопления в SetRetail10 ведутся в разрезе отдельных карт.
• Накопления выгружаются только при первоначальном импорте карт для передачи данных об уже имеющихся накоплениях в SetRetail10 для дальнейшего ведения накопительного дисконта в SetRetail10. Данный функционал требуется для поддержки переноса ведения накопительного дисконта на SetRetail10 от других информационных систем. Данные накоплений загружаются из ERP в составе данных карт в поле amount.

Обработка данных клиентов

• Данные клиентов не являются обязательными данными.
• В случае, если данные не были отправлены, клиент не создается.
• Каждый клиент может являться владельцем нескольких карт, или не иметь ни одной карты вообще.
• При импорте к клиенту привязываются все присланные с ним карты.
• Если с клиентом не отправлено ни одного экземпляра карт, создается клиент, к которому не привязано ни одной карты.
• При получении данных клиентов в секции сlient данные перезаписываются безусловно. Идентификатором для перезаписи клиента является поле guid.
• При импорте недостающие поля заполняются значением по умолчанию. В случае отсутствия необходимых данных для импорта клиентов, такие клиенты отклоняются системой.

...

Для изменения логики работы кассы при продаже товаров по таким картам, необходима дополнительная настройка в шаблонах касс.

Дисконтные карты юридических лиц

Привязка карт к контрагентам

• Для осуществления привязки импортируемой дисконтной карты к контрагенту необходимо при импорте указать вложенную сущность counterparty с корректно заполненными атрибутами.
• При этом необходимо дополнительно указать в карте, что она должна быть привязана к контрагенту (атрибут карты attached-to-counterparty).
• При импорте произойдёт проверка наличия вложенного тега counterparty и проверка корректности заполнения требуемых полей по контрагенту, таких как ИНН, КПП и т.д.
• Информация по контрагенту привящанному к такой карте, будет отображаться на вкладке Юридическое лицо в окне информации по карте в визуализации сервера SetRetail10.

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

• Для осуществления привязки импортируемого клиента карты к юридическому лицу необходимо при импорте клиента указать его тип в атрибуте сlient-type.
• Возможные значения атрибута:
  • PRIVATE – физическое лицо.
  • JURISTIC_PERSON – юридическое лицо.
• При такой привязке информация о самом юридическом лице указывается в анкетных данных клиента (либо не указывается вообще). 
• Сам клиент становистся для системы юридическим лицом.