--- title: "文件. ЭСФ附加文件 — 技术说明" country: KZ lang: zh author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-07 canonical: https://buhgpt.kz/suraqtar/documents-esfprisoedinennyefayly-tehnicheskoe-opisanie-zh source: BuhGPT --- # 文件. ЭСФ附加文件 — 技术说明 > **TL;DR:** 1. 识别 参数 值 对象类型 文档 ( 文档.ЭСФ附加文件 ) 名称 ЭСФ附加文件 同义词 “附加文件（电子发票）” 配置 哈萨克斯坦会计，版本 3.0 (3.0.74.2) 子系统 文件处理 / 附加文件 (BSP) 导航 e1cib/list/文档.ЭСФ附加文件 目的。 该对象用于存储附加到哈萨克斯坦共和国电子发票（ 文档.ЭСФ ）的文件。它确保“ЭСФ”文档与其文件附件之间的联系：用于信息系统 ЭСФ 的发票 XML 文件、扫描件、电子签名文件（ЭП）和附随文档。该对象属于电子文档处理子系统（ЭСФ，СНТ），并通过标准子系统库（B --- 1. 识别 参数 值 对象类型 文档 (文档.ЭСФ附加文件) 名称 ЭСФ附加文件 同义词 “附加文件（电子发票）” 配置 哈萨克斯坦会计，版本 3.0 (3.0.74.2) 子系统 文件处理 / 附加文件 (BSP) 导航 e1cib/list/文档.ЭСФ附加文件 目的。 该对象用于存储附加到哈萨克斯坦共和国电子发票（文档.ЭСФ）的文件。它确保“ЭСФ”文档与其文件附件之间的联系：用于信息系统 ЭСФ 的发票 XML 文件、扫描件、电子签名文件（ЭП）和附随文档。该对象属于电子文档处理子系统（ЭСФ，СНТ），并通过标准子系统库（BSP）的“附加文件”典型机制创建。 用户（会计，负责电子文档交换的人员）通过电子发票文档表单处理附件，而不是直接与该对象交互。该对象确保文件的版本控制、存储和电子签名的存在标志、在编辑时锁定文件以及与全文搜索的集成。 类型说明：在哈萨克斯坦版本中，电子发票的附加文件通过文档类型的元数据对象实现（object_type_ru: "文档"），尽管从功能上讲，这是由BSP子系统生成的附件存储。下面的结构根据实际证据进行了描述。 2. 属性和表部分 2.1 表头属性 名称 类型 必需性 目的 作者 参考目录.用户 必需 (ShowError) 最初将文件附加到电子发票的用户。用于审计和访问控制。 文件所有者 文档引用.ЭСФ 可选 指向文件所有者的电子发票文档。确保“文档 → 附件”的层次关系。 通用修改日期 日期时间 可选 文件最后修改的通用（UTC）时间。用于同步和跟踪更改。 创建日期 日期时间 必需 (ShowError) 文件首次附加的时刻。对电子发票的时间顺序至关重要。 已加密 布尔 可选 文件加密的标志（机密文档处理场景）。 修改者 参考目录.用户 可选 最后修改文件的用户。用于审计。 图片索引 数字 可选 文件在界面图像集合中的图标索引（取决于扩展名）。 描述 字符串 可选 文件的文本描述/名称，以便于识别。 已签名ЭП 布尔 可选 电子签名存在的标志。对电子发票在哈萨克斯坦会计中的法律意义至关重要。 文件路径 字符串 可选 存储卷上的文件路径（在外部存储卷时）。 大小 数字 可选 文件的字节大小。用于控制容量和优化加载。 扩展名 字符串 可选 文件的扩展名（“xml”，“pdf”等）。确定处理和显示方式。 编辑者 参考目录.用户 可选 正在编辑文件的用户（锁定），以防止冲突。 文本提取状态 枚举引用.文件文本提取状态 可选 全文搜索的文本提取状态（未提取/已提取/错误）。 文本存储 值存储 可选 用于全文搜索的提取文本存储。 除了上述属性外，对于这种类型的对象，BSP通常还包含服务属性：版本存储/文件版本数据的引用，存储卷和文件存储（在信息库中存储的二进制数据）。数据存储的组成取决于所选的存储方式（在数据库中或在卷上）。 2.2 表部分 该对象没有表部分——这是一个单文件附件的平面存储（一条记录 = 一个附加到一个电子发票的文件）。多个附件通过具有相同文件所有者的多条记录实现。 3. 表单 表单由BSP的“附加文件”子系统生成。典型组成： 表单 目的 元素表单 (对象表单) 查看/编辑附件卡片：描述、作者、日期、电子签名和加密标志、操作“打开”、“另存为”、“编辑”/“结束编辑”。 列表表单 (列表表单) 附加文件列表；通过链接e1cib/list/文档.ЭСФ附加文件访问。主要用于管理/诊断。 选择表单（如有） 在服务场景中选择现有附件。 在实践中，通过电子发票文档表单中的“附加文件”内置表进行操作（“添加”、“查看”、“签名ЭП”、“保存”等命令），而对象的自定义表单很少打开。 4. 模块的关键过程 没有附加的应用BSL代码——对象的行为由BSP的“附加文件”子系统的通用机制决定。该类型对象的典型处理程序： - 对象模块 → 处理填充 — 在创建附件时填充作者、创建日期、通用修改日期。 - 对象模块 → 在保存前 / 在保存时 — 记录修改者，更新通用修改日期，更新大小/扩展名，在内容更改时重置文本提取状态。 - 对象模块 → 处理检查填充 — 控制必填属性作者和创建日期（ShowError模式）。 - BSP通用模块 — 文件处理、文件处理服务、文件处理服务器调用：添加文件、读取/写入二进制数据、提取文本以进行全文搜索（填充文本存储、文本提取状态）、管理锁定（编辑者）、与电子签名（已签名ЭП、已加密）和存储卷（文件路径、存储卷）的工作。 版本特定：确切的过程名称和按通用模块的划分取决于嵌入在3.0.74.2中的BSP版本——在修改时请通过配置器确认。 5. 处理和运动 该对象不是会计意义上的可处理文档：它没有会计和积累登记的运动，并且不生成分录。这是一个文件附件的存储——“处理”属性和为其生成运动的机制不适用。 会计运动由文档所有者ЭСФ和与之相关的销售/采购原始文档生成，而附加文件仅存储其电子图像（XML，ЭП）。作为参考——与电子发票（2026年哈萨克斯坦的数字和账户）相关的标准分录逻辑： - 商品销售（哈萨克斯坦标准账户计划）： - 借 1210 贷 6010 — 销售收入； - 借 1210 贷 3130 — 按16%的税率计算的增值税（例如，基数为1,000,000 ₸，增值税金额 = 160,000 ₸）； - 借 7010 贷 1330 — 销售商品的成本费用。 - 商品入库： - 借 1330 贷 3310 — 入库商品； - 借 1420/1330 贷 3310 — 可抵扣的增值税（16%）。 - 付款：借 1030 贷 1210（来自买方），借 3310 贷 1030（给供应商）。 这些分录属于电子发票/销售/采购文档，而不是对象ЭСФ附加文件。 6. 相关对象和基于输入 - 文档所有者： 文档.ЭСФ — 通过属性文件所有者。一个电子发票文档可以有多个附加文件。 - 相关电子文档对象： 文档.СНТ（商品的附随发票）和其他电子文档根据相同的BSP方案具有自己的附加文件对象。 - 参考目录.用户 — 属性作者、修改者、编辑者。 - 枚举.文件文本提取状态 — 属性文本提取状态。 - 数据存储：二进制数据和版本 — 在信息库中（值存储）或在文件存储卷上（属性文件路径，卷）。 - 基于输入：不提供手动输入，且没有意义——记录在通过BSP机制将文件附加到电子发票时自动创建。 7. 扩展点 - 配置扩展（Extension）：添加属性（例如，附件类型、文档类别、存储期限）和借用表单以修改附件卡片。 - 事件订阅：对象的在保存前/在保存时 — 用于额外审计、版本自动编号、与外部档案的集成。 - BSP通用模块“文件处理”：可重写过程（文件处理可重写、文件处理服务客户端服务器） — 管理存储方式、限制扩展名/大小、处理电子签名。 - 交换规则/集成：将附件导出到信息系统 ЭСФ 和外部档案；在发送前检查已签名ЭП标志。 - 全文搜索：通过文本提取状态/文本存储设置提取文本，以便在电子发票的XML/PDF附件内容中进行搜索。 - 角色和RLS：根据文档所有者的作者/组织限制对附件的访问。 版本特定：可重写的BSP过程列表和在3.0.74.2版本中的订阅情况，请在修改前通过配置器确认。 --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_