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版本中的订阅情况，请在修改前通过配置器确认。