1. 标识
| 参数 | 值 |
|---|---|
| 对象类型 | 目录 (Catalog) |
| 名称 | ВозвратТоваровМеждуОрганизациямиПрисоединенныеФайлы |
| 全名 | Справочник.ВозвратТоваровМеждуОрганизациямиПрисоединенныеФайлы |
| 同义词 | «附加文件(组织间商品退货)» |
| 配置 | 哈萨克斯坦贸易管理,版本 3.4(3.4.5.21) |
| BSP 子系统 | «文件操作»(附加文件) |
| 所有者 | Документ.ВозвратТоваровМеждуОрганизациями |
| 层级结构 | 无(平铺文件列表) |
用途。 该目录用于存储附加到«组织间商品退货»单据的文件:退货凭证扫描件、发票、索赔单、ЭСФ/СНТ 打印表单、电子文档流转中的附件等。目录中的每个元素都是一个独立的附加文件(元数据 + 二进制数据或存储卷的引用),逻辑上与具体的所有者单据相关联。这是一个辅助对象:用户不直接操作它,而是通过退货单据表单中的«附加文件»命令进行操作。
查找位置: e1cib/list/Справочник.ВозвратТоваровМеждуОрганизациямиПрисоединенныеФайлы
(在标准工作流程中,列表是从所有者单据表单打开的,而不是从主菜单打开)。
2. 表头属性和表格部分
该结构是 BSP 附加文件的标准结构。以下是各字段的用途。
表头属性
| 属性 | 类型 | 用途 |
|---|---|---|
Наименование(代码/描述) |
字符串 | 不含扩展名的文件名 |
ВладелецФайла |
ДокументСсылка.ВозвратТоваровМеждуОрганизациями |
指向文件所附加单据的引用 |
Расширение |
字符串 | 文件扩展名(pdf、xml、jpg、docx……) |
Размер |
数字 | 文件大小(字节) |
Автор |
СправочникСсылка.Пользователи |
添加文件的用户 |
ДатаСоздания |
日期 | 文件在数据库中被附加的时刻 |
УниверсальнаяДатаМодификации |
日期 | 最后修改日期(UTC) |
ТипХранилищаФайла |
枚举 | 数据存放位置:«在信息库中»或«在磁盘卷中» |
ХранилищеФайла |
值存储 | 文件二进制数据(存储于信息库时) |
Том |
СправочникСсылка.ТомаХраненияФайлов |
存储卷(存储于磁盘时) |
ПутьКФайлуВТоме |
字符串 | 卷内的相对路径 |
ТекстовоеХранилище |
值存储 | 用于全文检索的提取文本 |
СтатусИзвлеченияТекста |
枚举 | 未提取 / 已提取 / 提取错误 |
Зашифрован |
布尔值 | 内容加密标志 |
ПодписанЭП |
布尔值 | 存在电子签名的标志 |
РедактируетПользователь |
СправочникСсылка.Пользователи |
«占用»文件进行编辑的用户(锁定/占用) |
ПометкаУдаления |
布尔值 | 标准删除标记 |
表格部分
| 表格部分 | 关键列 | 用途 |
|---|---|---|
ЭлектронныеПодписи |
签名(值存储)、证书、颁发对象、签名日期、备注 | 存储附加到文件的电子签名 |
ЗашифрованныеДанные(加密证书) |
表示、指纹、证书 | 用于加密文件的证书 |
BSP 元数据的具体属性组成在各版本之间可能存在细微差异——在进行二次开发时,请以具体的 3.4.5.21 配置器为准。这是唯一真正与版本相关的部分。
3. 表单
| 表单 | 用途 |
|---|---|
ФормаЭлемента |
附加文件卡片:名称、作者、大小、日期,«查看»、«编辑»、«另存为……»按钮,电子签名操作 |
ФормаСписка |
所有者的文件列表(在通用表单«附加文件»内使用) |
通用表单 ПрисоединенныеФайлы(BSP) |
主要工作表单:退货单据文件列表,带有添加、上传、下载、签名和打印命令 |
用户操作流程基于 BSP 通用表单«ПрисоединенныеФайлы»构建,该表单以所有者(退货单据)作为参数,并在该目录之上运行。
4. 模块的关键处理过程
evidence 中未附带单独的 BSL 代码,因此以下是该类对象的典型处理过程(通过调用 BSP«文件操作»实现):
管理器模块 / BSP 通用模块:
РаботаСФайламиСлужебный.ДобавитьФайл(...)— 创建新的目录元素,将二进制数据写入信息库或存储卷。РаботаСФайлами.ЗанятьФайл / ОсвободитьФайл(...)— 占用文件进行编辑(填充/清空РедактируетПользователь)。ОбновитьВерсию / ОбновитьДанныеФайла(...)— 重新上传时替换内容。ПрисоединенныеФайлы.ПрисоединенныеФайлыВладельца(Владелец)— 按单据获取文件列表。
对象模块:
ПередЗаписью— 检查文件是否被占用,更新УниверсальнаяДатаМодификации,同步Зашифрован/ПодписанЭП标志。ПередУдалением— 在«磁盘»存储方式下从存储卷中删除二进制数据。ОбработкаЗаполнения— 创建时设置Автор、ДатаСоздания、ВладелецФайла。
表单模块:
查看、编辑、结束编辑、另存为、电子签名、加密/解密等命令——是对客户端处理过程РаботаСФайламиКлиент的封装。
5. 过账与移动
该目录不进行过账,也不生成寄存器移动——这是一个从属存储目录,没有过账模式和分录表格部分。寄存器和分录由所有者单据 ВозвратТоваровМеждуОрганизациями 生成;附加文件只是作为附件(扫描件、ЭСФ/СНТ 的 XML)伴随该单据。
作为背景说明——所有者单据按标准逻辑执行的操作(哈萨克斯坦会计科目表,增值税税率 16%,货币为坚戈 ₸):
寄存器(管理/业务核算):
ТоварыОрганизаций、СвободныеОстатки— 组织间商品的移动;СебестоимостьТоваров— 退货商品成本调整;РасчетыМеждуОрганизациями— 自有法人实体间的往来结算;НДСПродажи/НДСПокупки— 按16%税率核算增值税。
会计分录(哈萨克斯坦标准会计科目表):
| 业务 | 借方 | 贷方 |
|---|---|---|
| 入库退回商品 | 1330(商品) | 3310(应付组织供应商账款) |
| 反映退货增值税(16%) | 1420 / 冲销 3130 | 3310 |
| 组织间往来结算 | 1210 / 3310 | 3310 / 1210 |
| 冲销销售退货的收入/成本 | 6010(收入)、7010(成本)——冲销分录 | 1210 / 1330 |
| 货币支付/抵销 | 3310 | 1030(往来账户) |
增值税示例。 退货金额为 1,000,000 ₸(不含增值税)时,按 16% 税率计算的增值税额为 160,000 ₸,单据总额为 1,160,000 ₸。在 ЭСФ 方面,在 ИС ЭСФ 系统中生成更正/补充发票;在商品移动方面则生成 СНТ。
6. 相关对象与基于凭证录入
- 所有者:
Документ.ВозвратТоваровМеждуОрганизациями——元素的唯一来源。 - 其他单据(销售、入库、调拨等)的类似附加文件目录 ——相同的 BSP 机制。
Справочник.Пользователи——文件的作者和占用者。Справочник.ТомаХраненияФайлов——«磁盘»存储方式下的存储卷。- 信息寄存器
ДвоичныеДанныеФайлов/ВерсииФайлов(取决于存储方案)——二进制数据。 - 电子单据: 根据所有者单据获取/生成的 ЭСФ(ИС ЭСФ)和 СНТ 的 XML 文件,通常正是以附加文件的形式存储。
基于凭证录入: 不适用于附加文件目录。元素仅通过退货单据表单中的«附加文件»命令创建(添加/上传/扫描)。
7. 扩展点
- 配置扩展: 在元素/列表表单模块以及通用表单
ПрисоединенныеФайлы中添加处理过程(例如,根据扩展名自动分类附件)。 - BSP 编程接口:
РаботаСФайлами、РаботаСФайламиКлиент、ПрисоединенныеФайлы——用于添加/读取文件的标准 API,无需直接操作该目录。 - 附加属性和信息(«属性»子系统)——如有需要,可标记附件类型(凭证、索赔单、ЭСФ、СНТ)。
- 访问权限限制(RLS): 权限继承自所有者单据——在进行访问权限划分二次开发时,应针对所有者进行配置。
- 对象的
ПередЗаписью/ПередУдалением事件订阅 ——用于日志记录或与外部单据档案系统集成。
