--- title: "参考手册《ДоговорыКонтрагентовПрисоединенныеФайлы》— 技术说明" country: KZ lang: zh author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-23 canonical: https://buhgpt.kz/suraqtar/spravochnik-dogovorykontragentovprisoedinennyefayly-tehni-zh source: BuhGPT --- # 参考手册《ДоговорыКонтрагентовПрисоединенныеФайлы》— 技术说明 > **TL;DR:** 1. 标识 参数 值 对象类型 目录（Catalog） 名称 ДоговорыКонтрагентовПрисоединенныеФайлы 全名 Справочник.ДоговорыКонтрагентовПрисоединенныеФайлы 同义词 「附加文件（往来单位合同）」 配置 哈萨克斯坦会计，3.0 版（3.0.74.2） 文件所有者 Справочник.ДоговорыКонтрагентов 用途。 标准子系统库（BSP）「文件处理」子系统的服务性（技术性）目录。存储附加到「往来单位合同」目录元素上的文件：合同、补充协议、验收 --- 1. 标识 参数 值 对象类型 目录（Catalog） 名称 ДоговорыКонтрагентовПрисоединенныеФайлы 全名 Справочник.ДоговорыКонтрагентовПрисоединенныеФайлы 同义词 「附加文件（往来单位合同）」 配置 哈萨克斯坦会计，3.0 版（3.0.74.2） 文件所有者 Справочник.ДоговорыКонтрагентов 用途。 标准子系统库（BSP）「文件处理」子系统的服务性（技术性）目录。存储附加到「往来单位合同」目录元素上的文件：合同、补充协议、验收单、规格书及其他随附文档的电子扫描件。目录的每个元素即一个附加文件及其元数据（作者、日期、大小、扩展名、签名和加密标识）。用户间接使用该目录——通过往来单位合同卡片中的「附加文件」命令；它不会直接显示在命令界面的分区中。 此类附加文件会为每个启用了文件处理功能的所有者目录自动创建。往来单位、物料及其他配置对象也存在类似对象。 在哪里查找（导航链接）： e1cib/list/Справочник.ДоговорыКонтрагентовПрисоединенныеФайлы——打开所有文件的服务性列表；在常规工作中使用合同表单中的「附加文件」命令。 2. 属性与表格部分 2.1 表头属性（来自 evidence） 名称 类型 必填性 用途 Автор СправочникСсылка.Пользователи ShowError（必填） 最初上传文件的用户。作者归属控制与审计。 ВладелецФайла СправочникСсылка.ДоговорыКонтрагентов DontCheck 文件所附加到的往来单位合同。确保与核心核算对象的关联。 ДатаМодификацииУниверсальная 日期（日期时间） DontCheck 文件最后修改的日期/时间（UTC）。用于同步和跟踪版本时效性。 ДатаСоздания 日期（日期时间） ShowError（必填） 最初上传的日期/时间。用于时间顺序核算和排序。 Зашифрован 布尔 DontCheck 文件由证书加密的标识。决定打开前是否需要解密。 Изменил СправочникСсылка.Пользователи DontCheck 最后修改文件或其元数据的用户。审计与版本控制。 ИндексКартинки 数值 DontCheck 文件图标在界面图像集合中的索引（按扩展名）。 Описание 字符串 DontCheck 对文件内容/用途的任意文本描述。 ПодписанЭП 布尔 DontCheck 至少存在一个有效电子签名的标识。 ПутьКФайлу 字符串 DontCheck 文件在存储卷上的路径（用于「磁盘卷」存储）；在数据库存储时不填写。 Размер 数值 DontCheck 文件大小（字节）。用于控制容量和上传限制。 Расширение 字符串 DontCheck 文件扩展名（pdf、docx、jpg …）。决定类型、打开程序和图标。 Редактирует СправочникСсылка.Пользователи DontCheck 占用文件进行编辑的用户（防止同时编辑的锁定）。 2.2 BSP 附加文件的典型属性 除 evidence 中所列外，BSP 附加文件目录还标准包含若干确保版本管理和内容存储的属性： 名称 类型 用途 Наименование 字符串（主字段） 不含扩展名的文件名——显示在列表中。 ТипХранилищаФайлов ПеречислениеСсылка.ТипыХраненияФайлов 存储方式：在信息库中或在磁盘卷中。 Том СправочникСсылка.ТомаХраненияФайлов 存储卷（当类型为「磁盘卷」时）。 ТекущаяВерсия СправочникСсылка.…ВерсииПрисоединённыхФайлов 指向文件活动版本的引用（启用版本管理时）。 ЗагруженВБазу 布尔 文件内容已放入值存储属性中的标识。 ХранилищеФайла 值存储 文件的二进制数据（存储在信息库中时）。 版本管理服务属性的确切集合取决于内置于 3.0.74.2 中的 BSP 版本——需在具体交付版本中核实。 2.3 表格部分 该目录没有表格部分。文件是原子实体：目录的一个元素对应一个附加文件。版本和电子签名的数据被放入独立对象（版本寄存器、数字签名信息寄存器），而非表格部分。 3. 表单 附加文件服务性目录通常不重写自身表单——工作通过 BSP「文件处理」子系统的通用表单进行： 表单 类型 用途 ОбщаяФорма.ПрисоединённыеФайлы 列表表单 附加到具体合同的文件列表。通过「附加文件」命令打开。命令：添加、打开、编辑（占用/释放）、保存更改、版本、电子签名、加密。 ОбщаяФорма.ПросмотрФайла / КарточкаФайла 元素表单 查看和编辑文件元数据：描述、作者、日期、大小、版本、签名。 ОбщаяФорма.ФормаВыбораФайлов / ДобавлениеФайлов 服务性 从磁盘上传文件并创建目录元素的对话框。 列表表单（自动） 列表表单 通过导航链接 e1cib/list/… 自动生成的列表，用于服务/管理访问。 如果在具体交付版本中表单确实在目录级别被重写——其用途与上述所列一致；需按 3.0.74.2 的元数据组成核实。 4. 模块关键过程 evidence 中未附独立的 BSL 代码。对于附加文件服务性目录，主要逻辑不在对象模块中实现，而在 BSP 文件子系统的通用模块中（РаботаСФайлами、РаботаСФайламиСлужебный、РаботаСФайламиСлужебныйКлиент、РаботаСФайламиСлужебныйВызовСервера）。此类对象的典型处理程序和逻辑点： - МодульМенеджера.ПриПолученииФормы / ПередОткрытием——将自身表单替换为 BSP 通用表单。 - МодульОбъекта.ПередЗаписью——填充服务字段：ДатаМодификацииУниверсальная、Изменил、ПодписанЭП/Зашифрован 标识，重新计算 Размер。 - МодульОбъекта.ПередУдалением——在删除存储于信息库外的元素时，清理磁盘卷中的内容（删除物理文件）。 - 通用模块 РаботаСФайламиСлужебный——方法 ДобавитьФайл、ОбновитьВерсиюФайла、ЗанятьФайл/ОтпуститьФайл，版本、电子签名和加密的处理；正是它们创建和修改该目录的元素。 - 编辑锁定处理程序——设置/取消 Редактирует 属性，以排除多个用户同时修改文件。 不列出具体的 路径:行号——未提供模块源代码的 evidence；此处列出的是 BSP 附加文件特有的标准处理程序。 5. 过账与登记 该目录不是文档，也不过账——它不生成寄存器和会计分录。这对该类对象至关重要：附加文件存储的是电子文档，而非经济生活事实。 所生成的数据具有核算-技术性质，由文件子系统创建，而非过账机制： - 将内容写入值存储（存储在信息库中时）或将物理文件写入磁盘卷； - 将版本写入附加文件版本的服务性寄存器/目录； - 将电子签名信息写入 BSP 数字签名信息寄存器。 会计含义（按哈萨克斯坦标准科目表的分录）不产生于文件，而产生于关联的所有者文档。作为参考——这些分录由所附文件所属合同的销售/入库文档生成，例如： 所有者文档操作 借 贷 向购买方销售（收入） 1210 6010 计提应缴增值税（税率 16%） 1210 3130 结转商品成本 7010 1330 购买方付款至活期账户 1030 1210 从供应商收到商品 1330 3310 此类合同的电子文档（ИС ЭСФ 中的 ЭСФ、СНТ）由专门的配置对象开具；附加文件本身仅存储其电子副本/扫描件。所有者文档中的所有税额均按哈萨克斯坦 2026 年规范计算（增值税 16%、ИПН 10%/15%、ОПВ 10%、ОПВР 3.5%、ВОСМС 2%、ОСМС 3%、СО 5%、社会税 6%；МРП 4 325 ₸、МЗП 85 000 ₸），但它们与文件目录本身无关。 6. 关联对象与基于录入 所有者（必填关联）： - Справочник.ДоговорыКонтрагентов——通过属性 ВладелецФайла 设定；确定文件所属的合同。 BSP 文件子系统的相邻对象： - Справочник.ПользователиНаборыФайлов / 附加文件版本寄存器——存储版本历史； - РегистрСведений.ЭлектронныеПодписиФайлов（电子签名信息）——用于 ПодписанЭП 属性的签名数据； - Справочник.ТомаХраненияФайлов——用于「磁盘」存储的存储卷； - Перечисление.ТипыХраненияФайлов——存储方式； - Справочник.Пользователи——属性 Автор、Изменил、Редактирует。 基于录入。 该目录不使用「基于录入」机制——元素仅通过往来单位合同表单中的「附加文件」命令（添加/上传/扫描）以及 BSP 编程方式创建。 7. 扩展点 - 文件上传/保存——通过通用模块 РаботаСФайлами* 重写（借助配置扩展），但需谨慎：这是 BSP 代码，会随平台库一起更新。 - 附加属性和信息——文件服务性目录通常被排除在带附加属性的对象组成之外；如有需要，任意标记存储在 Описание 属性中。 - BSP 事件处理程序——订阅附加文件写入事件，用于日志记录/与外部电子文档流转、ИС ЭСФ、СНТ 集成。 - 配置扩展——在不解除配置支持的情况下，向附加文件列表表单添加自定义属性/命令。 - 访问限制（RLS）——文件访问继承所有者对象（往来单位合同）的权限；在 BSP「文件处理」访问组配置文件中设置。 在进行改造时请注意，该目录是 BSP 标准子系统的一部分：直接更改其结构会使更新复杂化。首选通过扩展和文件子系统的标准集成点进行。 --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_