1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВидыКартЛояльности |
| Полное имя | Справочник.ВидыКартЛояльности (Catalogs.ВидыКартЛояльности) |
| Синоним | «Виды карт лояльности» |
| Конфигурация | Управление торговлей для Казахстана, редакция 3.4.5.21 |
| Подсистема размещения | Служебные подсистемы → «Виды карт лояльности» |
| Навигационная ссылка | e1cib/list/Справочник.ВидыКартЛояльности |
Назначение. Справочник хранит типы (виды) карт лояльности, применяемых в программе лояльности: он задаёт правила, общие для всех карт одного вида, — способ идентификации карты (штрихкод, магнитная полоса, диапазон номеров), связь с видом дисконтной/бонусной программы, ограничения на выпуск и обращение. Конкретные экземпляры карт клиентов хранятся отдельно (в справочнике карт лояльности), а данный справочник выступает для них классификатором. Это справочник настроек — он сам не участвует в товародвижении и не формирует финансовых проводок.
2. Реквизиты шапки и табличные части
Ниже приведён типовой состав реквизитов справочника этого назначения в УТ для Казахстана 3.4. Точный перечень открывается в конфигураторе:
Справочник.ВидыКартЛояльности → Данные.
Стандартные реквизиты
| Реквизит | Тип | Назначение |
|---|---|---|
Код |
Строка | Внутренний код элемента |
Наименование |
Строка | Название вида карты (например, «Дисконтная 5 %», «Бонусная золотая») |
ПометкаУдаления |
Булево | Признак пометки на удаление |
Предопределённый |
Булево | Признак предопределённого элемента |
Реквизиты шапки (типовые для назначения)
| Реквизит | Тип | Назначение |
|---|---|---|
ТипКарты / ВидПрограммыЛояльности |
ПеречислениеСсылка / СправочникСсылка | Классификация: дисконтная, бонусная, накопительная, подарочная |
СпособИдентификации |
ПеречислениеСсылка | Как считывается карта: штрихкод, магнитная полоса, ручной ввод, RFID |
ДиапазонНомеровОт / ДиапазонНомеровДо |
Строка | Разрешённый диапазон номеров карт данного вида |
ДлинаНомераКарты |
Число | Фиксированная длина номера (для контроля ввода) |
Владелец / Организация |
СправочникСсылка | Организация-эмитент карт (если карты выпускаются от конкретной организации) |
ИспользоватьСрокДействия |
Булево | Ограничивать ли срок действия карт вида |
СрокДействияМесяцев |
Число | Период действия карты с момента выпуска |
Комментарий |
Строка | Произвольное описание |
Табличные части
Для справочника-классификатора табличные части, как правило, отсутствуют либо ограничены вспомогательными наборами (например, перечень разрешённых торговых объектов/касс, где принимается вид карты). Наличие ТЧ проверяется по конкретной сборке: требует проверки для 3.4.5.21 — состав ТЧ является версионно-зависимым.
3. Формы
| Форма | Назначение |
|---|---|
ФормаСписка |
Список всех видов карт лояльности; основная точка входа из подсистемы |
ФормаЭлемента |
Создание/редактирование одного вида карты, настройка правил идентификации и связей с программой лояльности |
ФормаВыбора |
Выбор вида карты при подборе из других объектов (карты клиентов, документы продажи) |
Если для конкретных форм в метаданных не задана собственная форма, платформа использует автоматически генерируемые формы на основе структуры реквизитов.
4. Ключевые процедуры модулей
Отдельного приложенного BSL-evidence для данного объекта нет, поэтому ниже указаны типовые обработчики справочника этого вида (модуль объекта и модули форм). Конкретные строки смотрите в конфигураторе.
Модуль объекта (Справочник.ВидыКартЛояльности.МодульОбъекта):
ОбработкаЗаполнения(ДанныеЗаполнения, ...)— заполнение реквизитов по умолчанию при создании нового вида карты.ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)— контроль обязательных полей (тип карты, способ идентификации, корректность диапазона номеров).ПередЗаписью(Отказ)— проверки непротиворечивости настроек (например, что «ДиапазонНомеровОт» ≤ «ДиапазонНомеровДо», согласованность длины номера).
Модуль формы элемента:
ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)— настройка видимости/доступности полей в зависимости от типа карты.<Реквизит>ПриИзменении(Элемент)— переключение доступности связанных полей (например, при выборе способа идентификации «штрихкод» открывается настройка длины/маски номера).
Модуль формы списка:
ПриСозданииНаСервере(...)— установка отборов и условного оформления списка.
Справочник не содержит процедур проведения — это не документ.
5. Проведение и движения
Справочник документом не является и проведения не выполняет — он не формирует движений по регистрам накопления/сведений и не создаёт бухгалтерских проводок. Ссылки на счета типового плана счетов РК здесь неприменимы напрямую.
Влияние вида карты на учёт реализуется опосредованно — через документы продажи и механизмы лояльности, где вид карты определяет размер скидки/начисляемых бонусов. Для понимания цепочки приведём стандартную схему проводок по реализации в РК (план счетов РК, ставка НДС 16 % на 2026 год):
| Операция | Дебет | Кредит |
|---|---|---|
| Признание дохода от реализации (с учётом скидки по карте) | 1210 «Краткосрочная ДЗ покупателей» | 6010 «Доход от реализации» |
| Начисление НДС (16 %) | 1210 | 3130 «НДС к уплате» |
| Списание себестоимости товара | 7010 «Себестоимость реализации» | 1330 «Товары» |
| Поступление оплаты | 1030 «Деньги на текущих счетах» | 1210 |
Пример расчёта скидки. Товар 10 000 ₸ с НДС 16 %; вид карты даёт скидку 5 %. Цена после скидки = 9 500 ₸, в т.ч. НДС = 9 500 × 16 / 116 ≈ 1 310 ₸, доход без НДС ≈ 8 190 ₸.
Регистры бонусной программы (начисление/списание баллов) ведут документы лояльности и учёта продаж, а не сам данный справочник; вид карты в них выступает измерением/реквизитом.
Электронные документы (ЭСФ через ИС ЭСФ, СНТ) формируются на основании документов реализации, а не справочника карт.
6. Связанные объекты и ввод на основании
- Карты лояльности (справочник экземпляров карт) — каждая карта клиента ссылается на элемент
ВидыКартЛояльностикак на свой классификатор. - Программы лояльности / виды дисконтных (бонусных) карт — вид карты связывается с правилами предоставления скидок и начисления бонусов.
- Документы продажи (реализация, чек ККМ / розничная продажа) — при предъявлении карты в документе используется её вид для определения скидки/бонусов.
- Регистры сведений и накопления лояльности — вид карты выступает измерением при хранении настроек и движений бонусов.
Ввод на основании. Для справочника-классификатора механизм «Ввод на основании» типово не предусмотрен: элементы создаются вручную в списке либо программно. Обратный ход (создание карт клиентов с указанием вида) выполняется из справочника карт.
7. Точки расширения
- Расширение конфигурации (Extensions): добавление собственных реквизитов вида карты, переопределение/дополнение форм списка и элемента, подключение обработчиков
ОбработкаПроверкиЗаполнения,ПередЗаписьючерез аннотации&Перед/&После/&Вместо. - Дополнительные реквизиты и сведения (БСП): справочник, как правило, включён в состав объектов, поддерживающих механизм дополнительных реквизитов/сведений — расширение без изменения конфигурации.
- Подписки на события: обработка
ПередЗаписью/ПриЗаписичерез подписку для интеграционных сценариев (выгрузка видов карт во внешние системы лояльности). - Внешние обработки и API: заполнение и синхронизация справочника через HTTP/веб-сервисы при интеграции с CRM/эквайрингом.
Требует проверки для 3.4.5.21: точный состав реквизитов, наличие табличных частей и конкретный набор форм — сверяйте по конфигуратору данной сборки, так как эти элементы версионно-зависимы.