1. 识别对象
| 参数 | 值 |
|---|---|
| 对象类型 | 目录(Catalog) |
| 名称 | ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
| 全名 | Справочник.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
| 别名 | "附加文件(客户回购可回收包装)" |
| 配置 | 哈萨克斯坦贸易管理,3.4版(版本3.4.5.21) |
| 所有者 | Документ.ВыкупВозвратнойТарыКлиентом |
| 层级结构 | 无(简单线性列表) |
| 查找位置 | e1cib/list/Справочник.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы |
用途。服务性目录,用于实现"客户回购可回收包装"单据的"附加文件"子系统(BSP,StandardSubsystems.AttachedFiles)。目录中的每个元素都是一个文件卡片(验收单扫描件、合同、包装照片、原始单据PDF、以附件形式存在的ЭСФ/СНТ等),附加到具体的所有者单据上。用户不直接使用该目录,而是通过单据表单中的"附加文件"命令进行操作。目录存储文件的元数据,并根据设置存储文件本身的二进制数据或存储卷的引用。
这是文件处理子系统的典型"伴生"对象。它不参与商品货币和税务核算,不生成过账记录,不影响增值税(自2026年起哈萨克斯坦为16%)、个人所得税、强制养老金缴款等的计算。相应的数值规范在第5节中给出,以说明所有者单据本身的核算背景,但仅间接适用于本目录(通过文件中存储的原始单据)。
2. 表头属性和表格部分
该对象不包含表格部分。以下是BSP附加文件目录的标准属性组成。
标准(系统)属性
| 属性 | 类型 | 用途 |
|---|---|---|
Ссылка |
目录引用 | 文件卡片的唯一标识符 |
Код |
字符串/数字 | 元素内部代码(通常不向用户显示) |
Наименование |
字符串(150) | 不含扩展名的文件名——向用户显示 |
Владелец |
单据引用.ВыкупВозвратнойТарыКлиентом | 文件所附加的单据 |
ПометкаУдаления |
布尔值 | 删除标记 |
Предопределённый |
布尔值 | 未使用(无预定义项) |
"附加文件"子系统属性
| 属性 | 类型 | 用途 |
|---|---|---|
ХранениеФайла |
值存储 | 文件存储在信息库中时的二进制数据(存储在卷中时为空) |
ПутьКФайлу |
字符串 | 文件在卷中的相对路径(存储在磁盘/卷中时) |
Том |
目录引用.ТомаХраненияФайлов | 文件存储在信息库外部时的存储卷 |
Расширение |
字符串 | 文件扩展名(pdf、jpg、xml、docx等) |
Размер |
数字 | 文件大小(字节) |
ОписаниеФайла |
字符串 | 文件的任意文本描述/注释 |
ДатаСоздания |
日期 | 文件创建日期(来自原始文件属性) |
ДатаИзменения |
日期 | 文件修改日期 |
ДатаМодификацииУниверсальная |
日期 | 卡片最后修改日期(UTC),用于同步 |
ЗапретРедактирования |
布尔值 | "只读"标志 |
Редактирует |
目录引用.Пользователи | 正在编辑该文件的用户(锁定) |
ПодписанЭП |
布尔值 | 文件已用电子签名签署 |
Зашифрован |
布尔值 | 文件已加密 |
ТекстовоеИзвлечение / ТекстХранилище |
值存储 | 用于全文搜索的提取文本 |
СтатусИзвлеченияТекста |
字符串/枚举 | 文本索引状态(未提取/已提取/错误/无法提取) |
АвтоматическаяОчистка |
布尔值 | 参与无用版本的定期清理 |
版本表格部分(若启用版本管理机制)
文件版本的存储通常通过单独的从属目录...ПрисоединенныеФайлыВерсииФайлов实现,或通过包含以下字段的表格部分实现:НомерВерсии、ХранениеФайла/ПутьКФайлу、Размер、Автор、ДатаСоздания、Комментарий。在单据附加文件的基础配置中,版本管理通常处于禁用状态。
3. 表单
| 表单 | 用途 |
|---|---|
元素表单(对象表单) |
文件卡片:名称、描述、大小、作者、日期,以及"打开"、"另存为…"、"编辑"/"结束编辑"、"电子签名签署"、"加密"按钮。处理单个文件的主要界面 |
| 列表表单 | 附加文件的完整列表(通过导航链接打开)。通常为服务性用途——普通用户一般不会打开整个列表 |
| 选择表单 | 从已附加的文件中选择(用于相关机制) |
用户操作的主要环境不是目录自身的表单,而是子系统的公共表单ОбщаяФорма.ПрисоединенныеФайлы(或附加文件的托管表单),通过ВыкупВозвратнойТарыКлиентом单据表单中的"附加文件"命令调用。该表单显示该单据的文件列表,并提供添加(从磁盘、扫描仪、剪贴板)、打开、删除、打印列表等命令。
4. 模块关键过程
所附证据中仅包含
naznachenie(用途)方面的内容;未提供BSL源代码和确切的路径:行号地址。以下为BSP附加文件目录典型的处理程序组成。具体过程名称在哈萨克斯坦贸易管理3.4版所交付的BSP范围内是版本稳定的。
对象模块(ОбъектМодуль)
ПередЗаписью(Отказ)——记录通用修改日期,检查文件编辑占用状态,更新签名/加密标志。ПередУдалением(Отказ)——存储在卷中时,启动从卷中删除物理文件(通过РаботаСФайламиСлужебный),清理版本。ПриКопировании(ОбъектКопирования)——重置副本的服务字段(锁定、电子签名)。
管理器 / 子系统公共模块
逻辑被移至BSP公共模块,目录仅提供存储属性:
РаботаСФайлами/РаботаСФайламиКлиент——添加文件、打开、保存、在外部程序中编辑。РаботаСФайламиСлужебный/...ВызовСервера——将二进制数据写入信息库或卷,读取,卷间转移,获取文件引用。ФайловыеФункции/РаботаСФайламиСлужебныйКлиентСервер——计算大小,生成卷中路径,确定扩展名和MIME类型。ИзвлечениеТекстаСервер——提取用于全文搜索的文本(填充ТекстовоеИзвлечение、СтатусИзвлеченияТекста)。- 处理程序
ПриОпределенииНастроекПодсистемыРаботаСФайлами(在所有者单据模块或可重写模块中)——将该目录注册为ВыкупВозвратнойТарыКлиентом单据附加文件的存储库。
表单
ФормаЭлемента.ПриСозданииНаСервере/ПриОткрытии——填充卡片属性,根据ЗапретРедактирования、ПодписанЭП、Зашифрован标志设置命令可用性。
5. 过账和账簿记录
该目录不进行过账,也不生成登记簿记录——这是文件存储对象,而非核算单据。
经济过账记录由所有者单据"客户回购可回收包装"生成。以下为该操作根据哈萨克斯坦2026年会计科目表和税务规范的典型核算模型,供参考。
所有者单据的登记簿(典型组成)
РегистрНакопления.ВыручкаИСебестоимостьПродажРегистрНакопления.ТоварыНаСкладах/СвободныеОстаткиРегистрНакопления.РасчётыСКлиентами(或РасчётыСПартнёрами)РегистрНакопления.НДСНачисленный- 用于生成ЭСФ(电子发票信息系统)和СНТ(货物运输发票)电子单据的登记簿。
哈萨克斯坦会计科目表典型分录
| 业务 | 借方 | 贷方 |
|---|---|---|
| 确认向客户销售包装的收入 | 1210(应收客户短期账款) | 6010(销售收入) |
| 计提应缴增值税16% | 1210 | 3130(应缴增值税) |
| 核销包装成本 | 7010(销售成本) | 1330(商品) |
| 收到客户付款 | 1030(往来账户资金) | 1210 |
示例。包装以不含增值税100,000坚戈售出。增值税16% = 16,000坚戈。应付总计116,000坚戈。
- 借1210 贷6010——100,000坚戈;
- 借1210 贷3130——16,000坚戈;
- 借7010 贷1330——成本(按会计估值);
- 借1030 贷1210——收到付款时116,000坚戈。
该业务需开具ЭСФ,必要时开具СНТ。
哈萨克斯坦2026年参考税务常数(用于企业核算,不直接适用于文件):月计算指数(МРП)= 4,325坚戈,最低工资(МЗП)= 85,000坚戈;个人所得税年收入8,500月计算指数以内为10%,超出部分为15%;个人所得税基本扣除额为每月30月计算指数(每年不超过360月计算指数);强制养老金缴款(ОПВ)10%(基数上限为50倍最低工资),雇主强制养老金缴款(ОПВР)3.5%,强制社会医疗保险缴款(ВОСМС)2%,社会医疗保险缴款(ОСМС)3%,社会缴款(СО)5%,社会税6%。
6. 关联对象和基于...输入
| 关联 | 对象 | 关联性质 |
|---|---|---|
| 所有者 | Документ.ВыкупВозвратнойТарыКлиентом |
父级;标记单据删除时会检查是否存在附加文件 |
| 子系统 | StandardSubsystems.РаботаСФайлами(BSP) |
文件存储/处理的全部功能 |
| 存储卷 | Справочник.ТомаХраненияФайлов |
文件存储在信息库外部时的物理存放位置 |
| 电子签名 | ЭлектроннаяПодпись子系统 |
文件签署/加密 |
| 用户 | Справочник.Пользователи |
文件作者、编辑用户(锁定) |
| 文件版本 | ...ПрисоединенныеФайлыВерсииФайлов(启用版本管理时) |
版本历史存储 |
基于...输入。不适用。目录元素仅通过将文件附加到所有者单据的机制创建("附加文件"按钮→"添加")。通过列表手动创建元素不合理,通常也无法交互式操作。
7. 扩展点
- 文件存储。在"管理→文件处理设置"部分配置:存储在信息库中或卷中(
ТомаХраненияФайлов),限制最大大小,禁止扩展名列表。 - 配置扩展(无需脱离支持)。向目录添加属性,向附加文件公共表单添加列/命令;订阅
ПередЗаписью/ПередУдалением事件。 - BSP可重写模块。
РаботаСФайламиПереопределяемый、РаботаСФайламиСлужебныйПереопределяемый——注册存储库设置、限制、添加/删除时的附加处理。 - 版本管理。启用文件版本存储及存储深度。
- 全文搜索。为附件内容搜索建立
ТекстовоеИзвлечение索引。 - 定期任务。"清理无用文件版本"、"提取文件文本"、"将文件转移到卷"。
- 电子签名与加密。通过电子签名子系统连接附件的签署和加密(适用于以文件形式存储的ЭСФ/СНТ)。
需在具体3.4.5.21版本中核实:文件版本从属目录的存在/组成以及文本索引属性的确切构成——取决于集成到该构建中的BSP版本。附加文件目录其余的属性组成及逻辑是稳定的。