1. 识别
| 参数 | 值 |
|---|---|
| 对象类型 | 目录（Catalog） |
| 名称 | ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы |
| 完整名称 | Справочник.ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы |
| 同义词 | «附加文件（向供应商回购可退还包装）» |
| 配置 | 哈萨克斯坦贸易管理，3.4版（3.4.5.21） |
| 所属子系统 | «文件处理»（标准子系统库 БСП） |
| 用途 | 存储附加到具体«向供应商回购可退还包装»单据的文件（扫描件、附件、电子签名等） |
基于证据的用途：«附加文件（向供应商回购可退还包装）»是«哈萨克斯坦贸易管理3.4»配置中的服务目录，实现标准子系统库（БСП）的附加文件机制。
这是一个典型的从属目录，属于<对象>ПрисоединенныеФайлы类型。其每个元素代表一个文件（Word/PDF文档、扫描图像、图片、ЭСФ/СНТ的xml文件等），逻辑上关联到具体的所属者单据。用户不直接操作该目录，而是通过所属者单据表单中的«附加文件»面板进行操作。
在何处查找
- 用于编程/调试——列表的导航链接：
e1cib/list/Справочник.ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы - 在界面中——从«向供应商回购可退还包装»单据表单中→«附加文件»命令/面板（БСП通用表单
ПрисоединенныеФайлы）。
2. 表头属性和表格部分
2.1. 目录的标准属性
| 属性 | 类型 | 用途 |
|---|---|---|
Владелец（所有者） |
ДокументСсылка.ВыкупВозвратнойТарыУПоставщика |
文件所附加的单据。«文件→单据»的关键关联 |
Наименование（名称） |
字符串 | 不含扩展名的文件名（显示用） |
Код（编码） |
字符串/数字 | 元素的内部编码 |
ПометкаУдаления（删除标记） |
布尔值 | 标准的删除标记 |
Предопределённый（预定义） |
— | 不使用（文件由用户创建） |
2.2. «文件处理»子系统的属性
| 属性 | 类型 | 用途 |
|---|---|---|
Расширение（扩展名） |
字符串 | 文件扩展名（pdf、xlsx、xml、png等） |
Автор（作者） |
СправочникСсылка.Пользователи / ВнешниеПользователи |
上传文件的人 |
ДатаСоздания（创建日期） |
日期 | 文件附加的时刻 |
ДатаМодификацииУниверсальная（通用修改日期） |
日期 | 最后修改日期（UTC） |
РазмерФайла（ОбъемФайла，文件大小） |
数字 | 字节大小 |
Редактирует（编辑者） |
СправочникСсылка.Пользователи |
谁占用了该文件进行编辑（锁定） |
ТекстХранилище（文本存储） |
值存储 | 用于全文搜索的提取文本 |
ФайлХранилище（文件存储） |
值存储 | 存储在信息库中时的文件二进制数据 |
ТомХранениеФайлов（文件存储卷） |
СправочникСсылка.ТомаХраненияФайлов |
存储在磁盘卷中时的卷 |
ПутьКФайлуВТомах（卷内文件路径） |
字符串 | 卷内文件的相对路径 |
ПодписанЭП（ПодписанЭЦП，已签署电子签名） |
布尔值 | 是否存在电子签名的标志 |
Зашифрован（已加密） |
布尔值 | 内容加密标志 |
ИндексКартинки（图标索引） |
数字 | 界面中按文件类型显示图标的索引 |
二进制数据要么存储在
ФайлХранилище（信息库中），要么存储在卷中（ТомХранениеФайлов+ПутьКФайлуВТомах）——取决于«将文件存储在磁盘卷中»的设置。
2.3. 表格部分
| 表格部分 | 关键属性 | 用途 |
|---|---|---|
ЭлектронныеПодписи（电子签名） |
Подпись（签名，值存储）、КомуВыдан（颁发对象）、КемВыдан（颁发机构）、Отпечаток（指纹）、ДатаПодписания（签署日期）、ДатаДействияС（生效日期起）、ДатаДействияПо（生效日期至）、Комментарий（备注） |
加载在文件上的电子签名（用于合同、验收单等扫描件） |
СертификатыШифрования（加密证书） |
Сертификат（证书，值存储）、КомуВыдан（颁发对象）、Отпечаток（指纹） |
用于加密文件的证书 |
3. 表单
附加文件目录通常不设置自己的表单——通过БСП通用表单进行操作。标准组成：
| 表单 | 角色 |
|---|---|
通用表单ПрисоединенныеФайлы（БСП） |
主要操作面板：所有者单据的文件列表、添加、查看、编辑、电子签名 |
ФормаЭлемента（元素表单，如存在） |
单个文件卡片：名称、作者、日期、大小、签名 |
ФормаСписка（列表表单，如存在） |
目录所有文件的服务列表（管理/调试） |
| 电子签名的通用选择/查看表单 | 查看电子签名的属性和验证 |
如果在具体的3.4.5.21版本中没有自己的表单，平台会自动生成它们，用户操作完全由«文件处理»子系统的通用表单来实现。（是否存在自己的ФормаЭлемента属于版本特定的问题，需在具体版本的配置器中确认。）
4. 模块的关键过程
证据中未附带该对象的BSL源代码，因此以下是БСП附加文件目录的典型处理程序。
管理器模块/对象模块：
ОбработкаЗаполнения（填充处理）——在创建时填充服务属性（作者、创建日期、扩展名）。ПередЗаписью（写入前）——记录ДатаМодификацииУниверсальная，控制ПодписанЭП/Зашифрован标志，取消/设置编辑锁定（Редактирует）。ПередУдалением（删除前）——如果文件存储在卷中，从卷中（ПутьКФайлуВТомах）删除二进制数据，以免在磁盘上留下«孤儿»文件。ПриКопировании（复制时）——清除对签名/二进制数据的引用，以防副本继承原件的电子签名。
通过БСП通用模块调用（不在对象模块中）：
РаботаСФайлами/РаботаСФайламиСлужебный（文件处理/文件处理服务）——添加文件、获取二进制数据、放入卷或信息库、提取用于搜索的文本。ЭлектронныеПодписиИШифрование（电子签名与加密）——加载和验证电子签名，处理表格部分ЭлектронныеПодписи和СертификатыШифрования。
附加逻辑由所有者单据表单中的文件面板命令发起；目录本身是被动存储库。
5. 过账与凭证记录
该目录不是单据，也不进行过账——不在寄存器中生成记录，也不按科目表生成分录。它的作用仅限于存储文件。
会计和商品凭证记录由所有者单据——«向供应商回购可退还包装»生成。作为背景信息，按照哈萨克斯坦标准科目表，涉及以下科目：
| 操作 | 借方 | 贷方 |
|---|---|---|
| 入库回购的可退还包装 | 1330（商品/包装） | 3310（应付供应商账款） |
| 按16%税率划分增值税（哈萨克斯坦，2026年） | 1420（待抵扣增值税） | 3310 |
| 计提应交增值税（相应操作时） | — | 3130（应交增值税） |
| 从活期账户向供应商付款 | 3310 | 1030（活期账户资金） |
该操作的电子文档流通过ЭСФ信息系统（电子发票）和СНТ（货物运单）进行；这些单据的XML也可以作为文件附加到本目录中。所有金额计算均以坚戈（₸）为单位。
16%的增值税率和科目表作为所有者的背景信息给出；附加文件目录本身不参与这些计算。
6. 关联对象与基于输入
| 对象 | 关联类型 |
|---|---|
Документ.ВыкупВозвратнойТарыУПоставщика（单据.向供应商回购可退还包装） |
所有者（父单据） |
Справочник.ТомаХраненияФайлов（目录.文件存储卷） |
存储在卷中时的物理存储位置 |
Справочник.Пользователи（目录.用户） / ВнешниеПользователи（外部用户） |
文件作者、编辑用户 |
| «文件处理»子系统（БСП） | 添加/查看/签署机制 |
| ЭСФ信息系统、СНТ | 附加到单据的XML文件来源 |
基于输入：对于附加文件的服务目录不适用。元素仅通过所有者单据表单中的文件附加机制创建（从磁盘上传、扫描、拖放、从剪贴板粘贴）。
7. 扩展点
- 配置扩展：添加文件自定义属性（例如«文档类型：合同/验收单/电子发票»）、改进元素表单、在
ПередЗаписью中添加验证。 - 存储卷：将文件从信息库移出到磁盘卷中（«将文件存储在卷中»设置）——影响
ТомХранениеФайлов/ПутьКФайлуВТомах。 - 访问权限（行级安全RLS）：通过所有者单据的权限限制文件的可见性。
- 电子签名/加密：通过«电子签名与加密»子系统连接证书和签署规程。
- 事件订阅/БСП处理程序：拦截文件添加以进行自动分类、防病毒检查或与外部存储同步。
进行改进时，请勿更改БСП标准属性的组成（
ФайлХранилище、ТомХранениеФайлов、ЭлектронныеПодписи等）——这会破坏与通用表单的兼容性以及«文件处理»子系统的可更新性。