Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.


Информация

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

...

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

КомплексныйНакопления по картеНет

...

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

Да

cards-catalog/internal-card/counterparty

Image Modified

Поле

РазмерТип данныхОписаниеОбязательное

inn

9, 10 или 12 символов

Integer

ИНН контрагента. Ключевое обязательное поле.

Да

kpp

9

Integer

КПП, не обязательное поле так как может отсутствовать у ИП

Да

name

255

String

Наименование Контрагента (короткое)

Да

full-name

1024

String

Полное наименование контрагента.

Нет

address

255

String

Юридический адрес контрагента

Да

physical-address

255

String

Фактический адрес контрагента

Нет

debitor-number

128

String

Идентификатор контрагента (дебитора) во внешней системе.

Да
debitor-type
String

Тип контрагента (дебитора) во внешней системе

  • mercury (вне зависимости от регистра) - контрагент зарегистрирован в системе "Меркурий"
  • Не mercury или отсутствие атрибута - контрагент не зарегистрирован в системе "Меркурий"
Да


Блок кода
languagexml
titleПример импорта юридического лица с привязкой к карте
<cards-catalog>
 
    <internal-card card-type-guid="12621262" number="12620001" expiration-date="2049-12-31T00:00:00" status="ACTIVE" attached-to-counterparty="true">
        <counterparty inn="1212121212" kpp="123456789" name="Тестовое юрлицо" full-name="" address="Тестовый адрес" debitor-number="1245648725"/>
		<client guid = "198116" last-name = "Юридический" first-name = "Роман" middle-name = "Аркадьевич" sex = "MALE" birth-date = "1976-05-01"
                email="roman@crystals.ru" send-by-email="true" receipt-feedback="BY_EMAIL"/>
    </internal-card>

  
</cards-catalog>

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

...

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


Предупреждение
titleВнимание!
  • Данное поле не предназначено для импорта и обновления бонусных балансов, для этого используйте веб-сервис по работе с бонусными баллами.
  • Поле утратило действие и не используется в структуре импорта подарочных карт.


cards-catalog/bonus-account

Поле

Тип данныхОписаниеОбязательное

guid

Long

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

Да

bonus-update

String

Остаток бонусного счёта

Да

...

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

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

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

Информация
  • Накопления не являются бонусными баллами.
  • В основном накопления предназначены для соблюдения условий по переходу из одной категорий карт в другую

...

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

...

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