《应收应付款相抵销 附加文件》参考目录("哈萨克斯坦 UT 3.4.5.21")

1. 识别

用途。 该目录存储用户附加到«债务抵销»单据的文件的元数据以及（可选的）二进制内容（对账单扫描件、抵销协议、往来单位函件、佐证原始单据等）。这是БСП附加文件机制的典型对象：对于每一个允许附加文件的所有者对象，配置器都会创建一个独立的从属目录，形式为 <所有者名称>ПрисоединенныеФайлы。该目录本身不参与核算，也不生成过账记录——它负责文件的加载、版本管理、加密、电子签名及查看。

用于打开列表的导航链接：

e1cib/list/Справочник.ВзаимозачетЗадолженностиПрисоединенныеФайлы

在正常工作中不会直接打开该列表——文件是通过«债务抵销»单据界面中的«附加文件»命令查看的。直接的导航链接主要供管理员/开发人员用于诊断。

2. 属性和表格部分

该结构与БСП附加文件的模板一致。关键的服务标志是所有者（Владелец，类型为 单据链接.ВзаимозачетЗадолженности）：从属关系通过目录所有者的标准机制实现，因此«所有者»不会作为单独属性显示在属性树中，但在查询和代码中可用。

2.1. 表头属性

2.2. 表格部分

版本管理。 如果配置中启用了文件版本存储，内容不会存储在元素本身，而是存储在从属的版本目录 ВзаимозачетЗадолженностиПрисоединенныеФайлыВерсии（或相关的版本寄存器）中，元素的 ТекущаяВерсия/ЗаписьВерсии 属性会引用当前版本。版本对象是否存在及其确切名称与版本有关，需在具体构建中核实。

3. 界面

附加文件主要工作于«文件处理»子系统的通用界面上，因此该目录本身的独有界面很少。

用户的主要入口点是添加到«债务抵销»单据界面命令接口中的«附加文件»命令。它会打开按所有者筛选的通用列表界面。

4. 模块的关键过程

随附的证据材料中没有程序代码（BSL）——以下列出的是БСП附加文件典型的处理程序和服务性过程。3.4.5.21 版本中的确切名称/签名需与配置器核对。

目录对象模块：

• ПередЗаписью(Отказ) —— 检查文件名和扩展名的正确性，更新 ДатаМодификацииУниверсальная，检查编辑锁定（Редактирует）。
• ПриКопировании(ОбъектКопирования) —— 清除副本的锁定/签名标志。
• 填写检查处理——检查所有者及存储方式（卷或数据库）是否已填写。

管理器模块： 通常包含获取文件数据的服务函数，一般较为简单——主要逻辑被移至通用模块中。

实际为该对象服务的通用模块：

• РаботаСФайлами / РаботаСФайламиКлиент —— 文件的打开、编辑、保存、打印。
• РаботаСФайламиСлужебный / …СлужебныйВызовСервера —— 上传时创建目录元素，将内容写入卷或 ХранилищеФайла，提取用于检索的文本，更新大小/日期。
• РаботаСФайламиВТомахСлужебный —— 在 ТомаХранилищаФайлов 卷中放置和删除二进制数据。
• 电子签名/加密子系统模块 —— 签名的施加与验证，内容的加密/解密。

5. 过账与凭证记录

该目录不进行过账，也不生成会计过账记录及核算寄存器的凭证记录——它是文件存储库，而非核算单据。数据的«运动»仅限于二进制内容的写入：

• 当存储在信息库中时——数据写入 ХранилищеФайла 属性（启用版本管理时还写入从属目录/版本寄存器）；
• 当存储在卷中时——文件被物理存放到磁盘上，元素中填写 ТомХранилищаФайлов 和 ПутьКФайлуВТоме。

所有经济业务凭证记录都由所有者对象——«债务抵销»单据（文件附加于此）生成。按哈萨克斯坦通行逻辑，债务抵销无需资金流动即可关闭相互债务，且通常不含增值税（抵销不属于销售）：在哈萨克斯坦会计科目表中，这体现为按抵销金额（以坚戈 ₸ 计）关闭购方应收账款（1210«购方及客户短期应收账款»）与供方应付账款（3310«供应商及承包商短期应付账款»）的对冲，并相应生成往来结算寄存器的凭证记录。附加文件仅记录抵销依据（对账单、协议），不影响这些过账记录。

2026年哈萨克斯坦参考数值（用于理解所有者的核算业务背景，与本目录无直接关系）：增值税税率16%，月计算指数（МРП）4325坚戈，最低工资（МЗП）85000坚戈；其他业务中资金及商品流动科目为1030、1330，收入/成本为6010/7010，应缴增值税为3130。这些数值与附加文件机制无直接关系。

6. 关联对象与基于凭证的录入

基于凭证的录入。 对于附加文件目录不适用基于凭证的录入。元素不会通过«新建»手动创建——它们会在向所有者单据上传文件时自动生成（通过«附加文件»命令 →«添加»/拖放/扫描仪导入）。

7. 扩展点

• 文件存储。 在«信息库中↔卷中»之间切换存储方式可在«文件处理»子系统（常量及 ТомаХранилищаФайлов 目录）中配置，无需修改目录的元数据。
• 配置扩展。 通过扩展可添加属性（例如抵销单据的类型/类别、«已收到原件»标志），并将其显示在附加文件的通用界面上，同时可订阅对象记录事件。
• 事件订阅。 对象的 ПередЗаписью/ПриЗаписи 处理程序可用于记录扫描件的上传日志，以及在过账所有者单据时检查是否必须附有附件。
• 电子签名与加密处理。 通过БСП标准机制配置；对抵销单据证书及签名要求的自定义检查在电子签名子系统的处理程序中实现。
• 访问权限限制（RLS）。 文件的访问权限继承自所有者的访问逻辑；如采用自定义访问模型，需为附加文件目录配置与«债务抵销»单据同步的 RLS 模板。
• 类型/大小限制。 允许的扩展名及文件最大大小由«文件处理»子系统的设置指定，并在上传时进行检查。