1. 识别对象
| 参数 | 值 |
|---|---|
| 对象类型 | 目录（Catalog） |
| 名称 | ВозвратТоваровОтКлиентаПрисоединенныеФайлы |
| 全称 | 目录.客户退货附件文件 |
| 同义词 | «附件文件（客户退货）» |
| 配置 | 哈萨克斯坦贸易管理，第3.4版（版本3.4.5.21） |
| 子系统 | 标准子系统库（БСП）的«文件操作»/«附件文件» |
| 所有者（Владельцы） | 单据.客户退货 |
| 层级 | 无 |
| 用途 | 存储用户附加到«客户退货»单据的文件的元数据和内容（退货行为证明的扫描件、次品照片、索赔、往来函件、电子发票/运输单据文件等）。这是一个由БСП附件文件机制针对具体所有者对象自动生成的服务性目录。 |
在哪里查找：导航链接e1cib/list/Справочник.ВозвратТоваровОтКлиентаПрисоединенныеФайлы。
在常规工作中，用户不会直接打开该目录——文件是通过«客户退货»单据表单中的«附件文件»命令（表单的超链接/导航面板）添加和查看的。管理员使用直接导航进行服务性控制。
2. 表头字段和表格部分
该目录是从属目录：其每个元素都是一个附件文件，通过标准字段所有者与具体的所有者单据关联。基本表示形式（名称）存储不带扩展名的文件名/描述。
字段（表头）
| 字段 | 类型 | 用途 |
|---|---|---|
名称（Description） |
字符串 | 向用户显示的文件名（描述），不带扩展名 |
所有者（Owner） |
单据链接.客户退货 |
文件所附加到的单据 |
文件存储 |
值存储 | 在信息库中存储时的文件二进制数据 |
卷 |
目录链接.文件存储卷 |
磁盘（卷）存储文件时的存储卷 |
卷文件路径 |
字符串 | 卷内文件的相对路径 |
文件名 |
字符串 | 文件原始名称 |
扩展名 |
字符串 | 文件扩展名（pdf、jpg、xml等） |
大小 |
数字 | 文件大小（字节） |
作者 |
复合类型（目录链接.用户 / 外部用户） |
添加文件的用户 |
创建日期 |
日期 | 文件在库中的创建日期和时间 |
通用修改日期 |
日期 | 最后修改日期（UTC） |
编辑者 |
目录链接.用户 |
占用文件进行编辑的用户（锁定/checkout机制） |
已电子签名 |
布尔值 | 是否存在电子签名的标志 |
已加密 |
布尔值 | 内容已加密的标志 |
文本存储 |
值存储 | 用于全文搜索的提取文件文本 |
文本提取状态 |
枚举链接 | 文本提取状态（未提取／已提取／失败） |
表格部分
| 表格部分 | 关键列 | 用途 |
|---|---|---|
电子签名 |
签名（值存储）、签署日期、证书、证书指纹、证书名称、注释 |
存储加载到文件上的所有电子签名 |
加密证书 |
证书（值存储）、证书指纹、表示形式 |
用于加密文件内容的证书 |
需要在具体发行版上验证：字段的确切组成（是否存在版本控制字段
ВерсияВладелец/工作副本、本地化字段）取决于内置于3.4.5.21中的БСП版本。上述基本字段集合对应于没有独立版本目录的典型附件文件目录。
3. 表单
| 表单 | 用途 |
|---|---|
元素表单 |
附件文件卡片：名称、作者、日期、大小、«打开»、«另存为»、«编辑/结束编辑»按钮，电子签名和加密操作 |
| 附件文件列表通用表单（来自БСП子系统） | 所有者单据的所有文件列表；从«客户退货»单据表单调用。该目录通常不重新定义自己的列表表单——使用«文件操作»机制的通用表单 |
此外，БСП机制还使用«文件操作»子系统的通用表单（选择文件、比较版本、电子签名操作、加密），这些表单不属于该目录，但为其元素提供服务。
4. 模块的关键过程
未附带该对象的BSL代码证据，因此以下是该类对象的典型处理程序。附件文件目录的特点是：自身模块（对象/管理器模块）很少，主要逻辑放在БСП的通用模块中。
对象模块（典型处理程序）
ПередЗаписью(Отказ)（写入前）— 控制编辑锁定（编辑者），同步已电子签名/已加密标志，更新通用修改日期和大小。ПередУдалением(Отказ)（删除前）— 在卷存储情况下，启动从磁盘删除文件（通过服务方法），以避免卷中留下"孤立"文件。
实现对象操作的БСП通用模块
ПрисоединенныеФайлы（附件文件）— 服务器端应用API：ДобавитьФайл(...)（添加文件）、获取所有者文件列表、更新内容。ПрисоединенныеФайлыКлиент/ПрисоединенныеФайлыСлужебныйВызовСервера— 添加、打开、编辑、保存文件的客户端脚本。РаботаСФайлами、РаботаСФайламиВызовСервера、РаботаСФайламиКлиент— 底层操作：读写二进制数据、存放到卷或信息库中、提取文本。ЭлектронныеПодписи/ЭлектронныеПодписиКлиент— 加载、验证和存储电子签名；内容加密/解密。ПрисоединенныеФайлыПереопределяемый— 针对所有者自定义机制行为的扩展点。
5. 过账和动作
该对象不生成自己的动作。这是一个目录，而不是单据：它不进行过账，不会在累计寄存器/信息寄存器中生成记录，也不会产生会计分录。附件文件是辅助数据，仅影响文件存储子系统。
会计动作和电子单据由所有者单据客户退货生成。以下是按哈萨克斯坦标准退货逻辑（数字和科目——哈萨克斯坦，2026年）的会计背景。
哈萨克斯坦贸易管理运营核算（累计寄存器，冲销销售）：
ВыручкаИСебестоимостьПродаж（销售收入和成本）、ДоходыИРасходы（收入和支出）— 冲销收入和成本；ТоварыНаСкладах（仓库商品）、ТоварыОрганизаций（组织商品）、СвободныеОстатки（自由结余）— 退回商品的入库；РасчетыСКлиентами/ВзаиморасчётыСКлиентами（与客户结算）— 减少买方欠款；- 哈萨克斯坦增值税寄存器 — 按16%税率调整增值税。
按哈萨克斯坦标准会计科目表对应的会计分录（在传输到会计核算/与会计配置交换时）。示例：退回一批商品，金额116,000坚戈，含16%增值税（增值税=16,000坚戈，不含税成本=100,000坚戈），成本70,000坚戈：
| 操作 | 借方 | 贷方 | 金额，坚戈 |
|---|---|---|---|
| 冲销/减少销售收入 | 6010 | 1210 | 100,000 |
| 冲销/减少应交增值税 | 3130 | 1210 | 16,000 |
| 恢复仓库商品 | 1330 | 7010 | 70,000 |
| 向买方退款（退还货款时） | 1210 | 1030 | 116,000 |
科目：1210——买方短期应收账款，1030——往来账户资金，1330——商品，3130——应交增值税，6010——销售收入，7010——销售成本。
电子单据：退货通过在电子发票信息系统中开具更正/补充电子发票来办理，如果涉及商品实际移动，还需开具运输单据。这些单据的XML文件通常正是作为附件文件进入该目录，但它们是由退货单据本身生成的，而不是由文件目录生成的。
6. 关联对象和依据录入
- 所有者单据：
单据.客户退货——目录元素的唯一来源。 - 存储卷：
目录.文件存储卷——磁盘文件存储时使用。 - 用户：
目录.用户/目录.外部用户——文件的作者和编辑者。 - 电子签名机制：БСП的电子签名证书和加密算法目录。
- 依据录入：对于附件文件服务性目录，不适用依据录入。元素的创建仅通过退货单据表单中的«附件文件»命令进行（从磁盘上传、从剪贴板、扫描、从邮件保存）。
7. 扩展点
- 可重定义的通用模块：
ПрисоединенныеФайлыПереопределяемый、РаботаСФайламиПереопределяемый——设置允许的扩展名、最大大小、存储行为。 - 角色和权限：
ЧтениеПрисоединенныхФайлов（读取附件文件）、ДобавлениеИзменениеПрисоединенныхФайлов（添加修改附件文件）——划分退货文件的访问权限。 - 配置扩展：调整
元素表单，添加自己的字段/命令而不脱离技术支持。 - 存储设置：«信息库↔卷»切换、大小限制、对提取文本的全文搜索设置。
- 事件订阅／电子签名：对退货扫描件等签名和加密时增加额外验证（例如强制要求对退货行为证明扫描件进行电子签名）。
- 交换与集成：在将退货和电子发票传输到外部系统时，将文件纳入交换/同步规则。