1. 识别
| 参数 | 值 |
|---|---|
| 对象类型 | 目录 (Catalog) |
| 名称 | ВидыКартЛояльности |
| 全名 | Справочник.ВидыКартЛояльности (Catalogs.ВидыКартЛояльности) |
| 同义词 | «忠诚卡类型» |
| 配置 | 哈萨克斯坦贸易管理，版本 3.4.5.21 |
| 所属子系统 | 服务子系统 → «忠诚卡类型» |
| 导航链接 | e1cib/list/Справочник.ВидыКартЛояльности |
用途。 该目录用于存储忠诚度计划中使用的忠诚卡的类型（种类）：它规定了同一类型所有卡片的通用规则——卡片的识别方式（条形码、磁条、号码范围）、与折扣/积分计划类型的关联、发行和流通的限制。客户卡片的具体实例单独存储（在忠诚卡目录中），而本目录作为它们的分类器。这是一个设置目录——它本身不参与商品流转，也不生成财务凭证。
2. 表头属性和表格部分
下面列出的是哈萨克斯坦版贸易管理 3.4 中此类用途目录的典型属性组成。确切清单可在配置器中查看：
Справочник.ВидыКартЛояльности → Данные。
标准属性
| 属性 | 类型 | 用途 |
|---|---|---|
Код |
字符串 | 元素的内部编码 |
Наименование |
字符串 | 卡片类型名称（例如«折扣卡 5%»、«黄金积分卡»） |
ПометкаУдаления |
布尔值 | 删除标记 |
Предопределённый |
布尔值 | 预定义元素标记 |
表头属性（此用途的典型属性）
| 属性 | 类型 | 用途 |
|---|---|---|
ТипКарты / ВидПрограммыЛояльности |
枚举引用 / 目录引用 | 分类：折扣卡、积分卡、储值卡、礼品卡 |
СпособИдентификации |
枚举引用 | 卡片读取方式：条形码、磁条、手动输入、RFID |
ДиапазонНомеровОт / ДиапазонНомеровДо |
字符串 | 该类型卡片允许的号码范围 |
ДлинаНомераКарты |
数字 | 号码的固定长度（用于输入校验） |
Владелец / Организация |
目录引用 | 发卡机构（若卡片由特定机构发行） |
ИспользоватьСрокДействия |
布尔值 | 是否限制该类型卡片的有效期 |
СрокДействияМесяцев |
数字 | 自发行之日起卡片的有效期 |
Комментарий |
字符串 | 任意描述 |
表格部分
对于分类器目录，通常没有表格部分，或者仅限于辅助集合（例如允许接受该卡片类型的销售点/收银台清单）。表格部分的存在与否需按具体版本核实：需针对 3.4.5.21 进行核实——表格部分的组成是版本相关的。
3. 表单
| 表单 | 用途 |
|---|---|
ФормаСписка |
所有忠诚卡类型的列表；子系统的主要入口点 |
ФормаЭлемента |
创建/编辑单个卡片类型，设置识别规则及与忠诚度计划的关联 |
ФормаВыбора |
从其他对象中选择卡片类型（客户卡片、销售单据） |
如果元数据中未为具体表单指定自定义表单，平台将基于属性结构使用自动生成的表单。
4. 模块关键过程
该对象没有单独附带的 BSL 证据，因此下面列出的是此类目录的典型处理程序（对象模块和表单模块）。具体行号请在配置器中查看。
对象模块（Справочник.ВидыКартЛояльности.МодульОбъекта）：
ОбработкаЗаполнения(ДанныеЗаполнения, ...)— 创建新卡片类型时默认填充属性。ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)— 检查必填字段（卡片类型、识别方式、号码范围的正确性）。ПередЗаписью(Отказ)— 检查设置的一致性（例如«ДиапазонНомеровОт» ≤ «ДиапазонНомеровДо»，号码长度的一致性）。
元素表单模块：
ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)— 根据卡片类型设置字段的可见性/可用性。<Реквизит>ПриИзменении(Элемент)— 切换相关字段的可用性（例如，选择识别方式«条形码»后会打开号码长度/掩码设置）。
列表表单模块：
ПриСозданииНаСервере(...)— 设置列表的筛选和条件格式。
该目录不包含过账过程——这不是单据。
5. 过账和移动
该目录不是单据，不执行过账——它不产生累计/信息登记表的移动，也不生成会计凭证。哈萨克斯坦标准科目表的科目在此不直接适用。
卡片类型对核算的影响是间接实现的——通过销售单据和忠诚度机制，卡片类型在其中决定折扣/积分的额度。为了理解这一链条，下面给出哈萨克斯坦销售核算的标准凭证方案（哈萨克斯坦科目表，2026年增值税率16%）：
| 操作 | 借方 | 贷方 |
|---|---|---|
| 确认销售收入（考虑卡片折扣） | 1210 «客户短期应收账款» | 6010 «销售收入» |
| 计提增值税（16%） | 1210 | 3130 «应交增值税» |
| 结转商品成本 | 7010 «销售成本» | 1330 «商品» |
| 收到付款 | 1030 «活期账户资金» | 1210 |
折扣计算示例。 商品含16%增值税价格为10,000坚戈；该卡片类型提供5%折扣。折扣后价格 = 9,500坚戈，其中增值税 = 9,500 × 16 / 116 ≈ 1,310坚戈，不含税收入 ≈ 8,190坚戈。
积分计划的登记表（积分的计提/扣除）由忠诚度和销售核算单据维护，而非该目录本身；卡片类型在其中作为维度/属性出现。
电子单据（通过电子发票信息系统的ЭСФ、СНТ）基于销售单据生成，而非基于卡片目录生成。
6. 关联对象和基于……输入
- 忠诚卡（卡片实例目录） — 每张客户卡片都引用
ВидыКартЛояльности中的一个元素作为其分类器。 - 忠诚度计划 / 折扣（积分）卡类型 — 卡片类型与提供折扣和计提积分的规则相关联。
- 销售单据（销售、POS小票/零售销售） — 在单据中出示卡片时，使用其类型来确定折扣/积分。
- 忠诚度信息和累计登记表 — 卡片类型在存储设置和积分变动时作为维度出现。
基于……输入。 对于分类器目录，通常不设置«基于……输入»机制：元素通过列表手动创建，或以程序方式创建。反向操作（创建客户卡片时指定类型）在卡片目录中进行。
7. 扩展点
- 配置扩展（Extensions）： 添加卡片类型的自定义属性，重新定义/补充列表和元素表单，通过
&Перед/&После/&Вместо注解连接ОбработкаПроверкиЗаполнения、ПередЗаписью处理程序。 - 附加属性和信息（БСП）： 该目录通常属于支持附加属性/信息机制的对象——无需修改配置即可扩展。
- 事件订阅： 通过订阅处理
ПередЗаписью/ПриЗаписи，用于集成场景（将卡片类型导出到外部忠诚度系统）。 - 外部处理和API： 在与CRM/收单系统集成时，通过HTTP/网络服务填充和同步该目录。
需针对 3.4.5.21 进行核实： 属性的确切组成、表格部分的存在与否以及具体的表单集合——请对照该版本的配置器进行核实，因为这些元素是版本相关的。