--- title: "目录《VozvratTovarovOtKlientaPrisoedinennyeFayly》——技术说明" country: KZ lang: zh author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-24 canonical: https://buhgpt.kz/suraqtar/spravochnik-vozvrattovarovotklientaprisoedinennyefayly-te-zh source: BuhGPT --- # 目录《VozvratTovarovOtKlientaPrisoedinennyeFayly》——技术说明 > **TL;DR:** 1. 识别对象 参数 值 对象类型 目录（Catalog） 名称 ВозвратТоваровОтКлиентаПрисоединенныеФайлы 全称 目录.客户退货附件文件 同义词 «附件文件（客户退货）» 配置 哈萨克斯坦贸易管理，第3.4版（版本3.4.5.21） 子系统 标准子系统库（БСП）的«文件操作»/«附件文件» 所有者（Владельцы） 单据.客户退货 层级 无 用途 存储用户附加到«客户退货»单据的文件的元数据和内容（退货行为证明的扫描件、次品照片、索赔、往来函件、电子发票/运输单据文件等）。这是一个由БСП附件文件机 --- 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. 扩展点 - 可重定义的通用模块：ПрисоединенныеФайлыПереопределяемый、РаботаСФайламиПереопределяемый——设置允许的扩展名、最大大小、存储行为。 - 角色和权限：ЧтениеПрисоединенныхФайлов（读取附件文件）、ДобавлениеИзменениеПрисоединенныхФайлов（添加修改附件文件）——划分退货文件的访问权限。 - 配置扩展：调整元素表单，添加自己的字段/命令而不脱离技术支持。 - 存储设置：«信息库↔卷»切换、大小限制、对提取文本的全文搜索设置。 - 事件订阅／电子签名：对退货扫描件等签名和加密时增加额外验证（例如强制要求对退货行为证明扫描件进行电子签名）。 - 交换与集成：在将退货和电子发票传输到外部系统时，将文件纳入交换/同步规则。 --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_