1. 识别
| 参数 | 值 |
|---|---|
| 对象类型 | 目录 (Catalog) |
| 名称 | ВидыНоменклатурыПрисоединенныеФайлы |
| 全名 | Справочник.ВидыНоменклатурыПрисоединенныеФайлы (Catalogs.ВидыНоменклатурыПрисоединенныеФайлы) |
| 同义词 | «附加文件（商品种类）» |
| 所有者 (Owner) | Справочник.ВидыНоменклатуры |
| 层级结构 | 无（平面列表） |
| 配置 | 哈萨克斯坦贸易管理，版本 3.4.5.21 |
| 子系统 | «文件操作»（БСП / 标准子系统库） |
| 查找路径 | e1cib/list/Справочник.ВидыНоменклатурыПрисоединенныеФайлы |
用途。该目录是由 БСП「文件操作」机制自动生成的服务性目录，用于存储附加到 ВидыНоменклатуры 目录元素的文件元数据。每个支持文件附加功能的所有者对象都会创建一个此类目录；名称按照 <所有者名称>ПрисоединенныеФайлы 模板构建。用户并非直接操作该目录，而是通过商品种类卡片中的「附加文件」命令进行操作。该目录本身属于基础设施性质：不参与核算，不参与单据流转，也不影响金额/税额。
这是 БСП 的标准（典型）对象。哈萨克斯坦的应用规则（增值税 16%，月计算指数 4325 坚戈，哈萨克斯坦会计科目表）不直接适用于该对象——它仅存储商品种类卡片的附件（见第5节）。
2. 属性和表格部分
该目录不包含表格部分。以下是 БСП 附加文件的典型属性组成（不包含专门的版本存储）。在带有版本管理的配置中，负责二进制数据的部分属性会被移至配对目录 ВидыНоменклатурыВерсииПрисоединенныхФайлов 中——这是与版本相关的具体细节，应与具体交付版本核对。
标准属性
| 属性 | 类型 | 用途 |
|---|---|---|
Код（编码） |
字符串/数字 | 元素的内部编码。不向用户显示。 |
Наименование（名称，Description） |
字符串 (150) | 文件名（不含扩展名）。 |
Владелец（所有者，Owner） |
СправочникСсылка.ВидыНоменклатуры |
文件所附加的商品种类元素。 |
ПометкаУдаления（删除标记） |
布尔值 | 删除标记标志。 |
Предопределённый（预定义） |
布尔值 | 始终为「否」。 |
表头属性（应用层）
| 属性 | 类型 | 用途 |
|---|---|---|
Расширение（扩展名） |
字符串 | 文件扩展名（pdf、xlsx、png、用于ЭСФ/СНТ的xml等）。 |
Размер（大小） |
数字 | 文件大小（字节）。 |
ДатаСоздания（创建日期） |
日期 | 原始文件的创建日期。 |
ДатаМодификацииУниверсальная（通用修改日期） |
日期 | 最后修改日期（UTC），用于版本同步。 |
Автор（作者） |
СправочникСсылка.Пользователи |
添加文件的用户。 |
Редактирует（编辑中，占用） |
СправочникСсылка.Пользователи |
谁占用该文件进行编辑；为空表示文件空闲。 |
ПодписанЭП（已电子签名） |
布尔值 | 文件是否已使用电子签名签署。 |
Зашифрован（已加密） |
布尔值 | 文件是否已加密。 |
ТекстХранилище（文本存储） |
值存储 | 用于全文检索的提取文本。 |
СтатусИзвлеченияТекста（文本提取状态） |
枚举 | 文本提取状态（未提取/已提取/出错）。 |
ТомХранилища（存储卷） |
СправочникСсылка.ТомаХранилищаФайлов |
如果文件存储在磁盘卷中而非信息库中，则为对应的卷。 |
ПутьКФайлу（文件路径） |
字符串 | 卷中的相对路径（在卷存储模式下）。 |
该目录中不存储文件的二进制内容本身。在信息库中存储时，文件正文位于信息登记表
ДвоичныеДанныеФайлов中；在卷存储模式下，则位于卷（ТомаХранилищаФайлов）的文件系统中。该目录仅存储元数据和位置引用。
3. 窗体
该目录通常没有专门的应用层窗体——所有文件操作均通过「文件操作」子系统的通用窗体进行。典型组成如下：
| 窗体 | 用途 |
|---|---|
通用窗体 ПрисоединенныеФайлы（附加文件） |
所有者的附件列表：添加、打开、保存、标记、电子签名。通过商品种类卡片中的「附加文件」命令调用。 |
通用窗体 ПрисоединенныйФайл（附加文件） |
单个文件的卡片：名称、描述、作者、大小、日期、签名/加密状态、编辑及版本查看按钮。 |
目录的选择窗体/列表窗体 (e1cib/list/...) |
管理员对该所有者所有文件元数据列表的技术性访问。 |
如果在具体交付版本中该目录设置了自己的 ФормаЭлемента/ФормаСписка，则会覆盖通用窗体——需要在配置器中核实（版本相关）。
4. 关键模块过程
所提供的证据材料中未包含 BSL 代码及路径（路径:行号）——仅提供了「用途」方面的说明。因此下面列出的是 БСП 附加文件的典型处理程序。应用逻辑并非集中在该目录自身的模块中（这些模块通常为空或极简），而是集中在子系统的通用模块中：
РаботаСФайлами（文件操作）—— 客户端 API：ДобавитьФайл（添加文件）、ОткрытьФайл（打开文件）、РедактироватьФайл（编辑文件）、ЗакончитьРедактирование（结束编辑）、ОсвободитьФайл（释放文件）。РаботаСФайламиСлужебный/РаботаСФайламиСлужебныйСервер（文件操作辅助/服务器辅助）—— 服务器端逻辑：创建目录元素、将二进制数据写入ДвоичныеДанныеФайлов或卷、提取文本、处理电子签名和加密。РаботаСФайламиВызовСервера（文件操作服务器调用）—— 客户端-服务器调用代理。
目录对象模块的典型处理程序：
| 处理程序 | 功能说明 |
|---|---|
ПередЗаписью（写入前） |
检查名称/扩展名的正确性，更新 ДатаМодификацииУниверсальная，控制占用状态（Редактирует）。 |
ПриКопировании（复制时） |
重置副本的锁定、签名和加密标志。 |
ПередУдалением（删除前） |
启动相关二进制数据的删除（ДвоичныеДанныеФайлов 登记表或卷中的文件），清除版本。 |
填充处理程序 (ОбработкаЗаполнения) |
在通过 API 以编程方式创建时填充 Владелец、Автор、ДатаСоздания。 |
不建议在应用代码中直接访问该目录——请使用
РаботаСФайлами/РаботаСФайламиВызовСервераAPI。
5. 过账与账务处理
该目录不是单据，也不进行过账：「目录」类型的对象没有过账机制、登记器和会计分录。将文件附加到商品种类不会形成累计/信息登记表的账务处理（除了将二进制数据写入 ДвоичныеДанныеФайлов 的服务性记录），也不会产生哈萨克斯坦会计科目表的会计分录。
作为参考——核算账务和税额产生于应用层对象（销售单、入库单、ЭСФ/СНТ），而非附件本身。附加文件目录仅存储例如商品种类卡片旁的电子单据扫描件或XML文件。这些应用层对象所属的哈萨克斯坦2026年会计科目表及规范背景如下：
- 增值税 16% —— 记录在科目
3130（应交增值税）；进项/销项增值税反映在ЭСФ（电子发票信息系统）和СНТ中，而非附件中。 - 销售：
借 1210（应收账款-购买方短期）——贷 6010（销售收入）和贷 3130（增值税16%）；成本核销借 7010——贷 1330（商品）。 - 付款：
借 1030（活期账户资金）——贷 1210。 - 商品入库：
借 1330——贷 3310（应付账款-供应商），增值税根据会计政策不同记入借 1420/3130。 - 工资/税费计算（参考，哈萨克斯坦2026年）：月计算指数 (МРП) = 4325坚戈，最低工资 (МЗП) = 85000坚戈；个人所得税扣除额为每月30个МРП（年度不超过360个МРП）；年收入8500个МРП以内个人所得税为10%，超出部分为15%；强制养老金缴费 (ОПВ) 10%（基数上限为50个МЗП），雇主强制养老金缴费 (ОПВР) 3.5%，自愿社会医疗保险缴费 (ВОСМС) 2%，社会医疗保险缴费 (ОСМС) 3%，社会保险缴费 (СО) 5%，社会税 6%。
这些金额和科目属于配置中的应用层单据，而非附件目录本身——此处提供仅为帮助理解该对象在整体架构中的位置。
6. 关联对象与基于源单据创建
| 关联 | 对象 | 角色 |
|---|---|---|
| 所有者 | Справочник.ВидыНоменклатуры |
文件所附加的对象。 |
| 二进制数据存储 | РегистрСведений.ДвоичныеДанныеФайлов |
信息库存储模式下的文件正文。 |
| 卷存储 | Справочник.ТомаХранилищаФайлов |
用于存放文件正文的磁盘目录。 |
| 版本（可选） | Справочник.ВидыНоменклатурыВерсииПрисоединенныхФайлов |
文件版本存储（若启用版本管理——与版本相关）。 |
| 电子签名/加密 | РегистрСведений.ЭлектронныеПодписиФайлов，证书存储 |
签名和加密标志。 |
| 作者/编辑者 | Справочник.Пользователи |
Автор、Редактирует 属性。 |
基于源单据创建：不适用且未设置——服务性目录不参与「基于源单据创建」机制。元素仅通过商品种类卡片的「附加文件」命令或 РаботаСФайлами API 创建。
7. 扩展点
- 配置扩展（adopt/annotate）：可以订阅对象模块的
ПередЗаписью/ПередУдалением事件，但不建议更改附加文件标准属性的组成——该机制是按模板生成这些属性的。 - 附加属性/附加信息：通常不会连接到文件的服务性目录；自定义属性应存储在所有者对象——
ВидыНоменклатуры上。 - 使用 API 而非直接访问：添加/读取时请使用
РаботаСФайлами.ДобавитьФайл、РаботаСФайламиВызовСервера，而非直接写入对象——这样可以确保二进制数据的正确写入、文本提取以及电子签名的正确处理。 - 文件存储：存储策略（信息库中或卷中）在「文件操作」子系统中配置，会影响
ТомХранилища/ПутьКФайлу的填充——属于通用设置，无需修改对象。 - 全文检索：文本提取（
ТекстХранилище、СтатусИзвлеченияТекста）—— 通过子系统的例行任务进行定制的标准扩展点。
版本相关内容（需在3.4.5.21交付版本的配置器中核实）：是否存在配对的版本目录、目录自身窗体的组成，以及存储属性（卷/路径/版本）的确切列表。