1. 标识
| 参数 | 值 |
|---|---|
| 对象类型 | 目录(Catalog) |
| 名称 | ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы |
| 完整名称 | Справочник.ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы |
| 同义词 | —(未设置;对于文件类服务性目录,同义词通常为空) |
| 配置 | 哈萨克斯坦会计,3.0 版,版本 3.0.74.2 |
| 文件所有者 | Документ.ЗаявлениеНаПредоставлениеВычетовИПН |
| 子系统机制 | “文件操作”(BSP,РаботаСФайлами) |
用途。服务性目录——用于存储附加到“个人所得税扣除申请”文档的文件的仓库。它实现了文件附件的标准机制:向员工的申请附加扫描件、PDF、图像及其他证明享有个人所得税扣除权利的文档(申请书、证明材料、标准扣除和其他扣除的文件)。用户不直接操作该目录——记录会通过所有者文档卡片中的命令“附加文件”、“打开”、“另存为”、“电子签名”自动创建和打开。目标用户为负责办理个人所得税报表原始文档的工资核算会计和人事专员。
2026 年背景(哈萨克斯坦)。所有者文档负责应用个人所得税基本扣除每月 30 MRP(每年不超过360 MRP),其中1 MRP = 4 325 ₸。个人所得税按10%的税率征收,年收入至 8 500 MRP,超出部分按15%征收。最低工资 = 85 000 ₸。该目录本身不执行任何计算——它仅存储附加到申请的依据文件。
查找位置。直接列表(服务性,通常在命令界面中隐藏):
e1cib/list/Справочник.ЗаявлениеНаПредоставлениеВычетовИПНПрисоединенныеФайлы
标准访问方式——从“个人所得税扣除申请”文档表单 → 面板/命令“附加文件”。
2. 表头属性和表格部分
2.1 属性(来自 evidence + “文件操作”子系统的标准组成)
| 名称 | 类型 | 必填性 | 用途 |
|---|---|---|---|
| 作者 | СправочникСсылка.Пользователи | 必填(ShowError) | 最初上传文件的用户。创建时自动填写。 |
| 文件所有者 | ДокументСсылка.ЗаявлениеНаПредоставлениеВычетовИПН | 非必填 | 指向文件所附加到的所有者文档的引用。 |
| 通用修改日期 | 日期(xs:dateTime, UTC) | 非必填 | 文件最后一次修改的通用日期/时间。用于同步和版本控制。 |
| 创建日期 | 日期(xs:dateTime, UTC) | 必填(ShowError) | 在信息库中创建文件记录的日期/时间。 |
| 已加密 | 布尔值 | 非必填 | 文件已加密的标志(处理机密数据时使用)。 |
| 修改者 | СправочникСсылка.Пользователи | 非必填 | 最后一次修改记录/文件的用户。 |
| 图标索引 | 数字 | 非必填 | 文件类型图标在界面图像集合中的索引。 |
| 描述 | 字符串 | 非必填 | 用户对文件内容的备注。 |
| 已电子签名 | 布尔值 | 非必填 | 存在电子签名的标志(具有法律效力的文档流转)。 |
| 文件路径 | 字符串 | 非必填 | 文件在存储卷上的路径(当以“磁盘卷”方式存储时)。 |
| 大小 | 数字 | 非必填 | 文件大小,以字节为单位。 |
| 扩展名 | 字符串 | 非必填 | 文件扩展名(pdf、docx、jpg …)。 |
| 正在编辑者 | СправочникСсылка.Пользователи | 非必填 | 当前正在编辑文件的用户(防止冲突的锁定)。 |
| 文本提取状态 | ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов | 非必填 | 用于全文检索的文本提取状态。 |
| 文本存储 | 值存储 | 非必填 | 用于全文索引的已提取文件文本。(子系统标准属性) |
| 文件存储类型 | 枚举 | 非必填 | 存储方式:在信息库中/在磁盘卷上。(子系统标准属性) |
| 存储卷 | СправочникСсылка.ТомаХраненияФайлов | 非必填 | 文件物理存放所在的卷(当存储在磁盘上时)。(子系统标准属性) |
| 名称(标准) | 字符串 | — | 不含扩展名的文件名;目录记录的显示名称。 |
Автор、Изменил、Редактирует 属性构成 BSP 标准的所有权控制和版本锁定三元组。
2.2 表格部分
表格部分不存在——这对于附加文件目录来说是典型的。文件的二进制数据不存储在字符串属性中,而是存储在“值存储”类型的属性中(在信息库中存储),或存储在磁盘卷上(属性 ТипХранилищаФайла/ТомХранения/ПутьКФайлу),或存储在单独的版本表中(当启用版本控制时)。
3. 表单
该目录使用最少的表单集合;所有交互式操作均通过“文件操作”子系统的通用表单进行。
| 表单 | 用途 |
|---|---|
元素表单(ФормаЭлемента) |
文件卡片:名称、描述、作者、日期、大小、“已电子签名”/“已加密”标志。通常使用 BSP 通用表单。 |
列表表单(ФормаСписка) |
附加到特定申请的文件列表。通常由通用表单 РаботаСФайламиКлиент / 附加文件面板替代。 |
选择表单(ФормаВыбора) |
从已附加的文件中选择文件(在向其他对象插入文件引用时)。 |
实际上,附加、查看和签名表单由 BSP 提供(通用表单 ПрисоединенныеФайлы、РаботаСФайлами),因此目录自身的表单可能未设置,或者仅重写外观。
4. 模块的关键过程
evidence 中未附带 BSL 代码,因此下面列出的是附加文件目录的典型处理程序集合(在对象模块、管理器模块以及通过“文件操作”子系统的通用模块中实现)。
对象模块:
ПередЗаписью(Отказ)— 记录Изменил和ДатаМодификацииУниверсальная,重新计算Размер,必要时将СтатусИзвлеченияТекста重置为“需要提取”。ПриКопировании(ОбъектКопирования)— 清除签名/加密和所有权标志(ПодписанЭП、Зашифрован、Редактирует),以便副本不继承锁定。ОбработкаЗаполнения(ДанныеЗаполнения, …)— 从文档创建时设置Автор、ДатаСоздания、ВладелецФайла。
管理器模块:
- 交换数据的导出/导入处理程序,在文件子系统的订阅中注册。
子系统的通用模块(代替对象自身代码调用):
РаботаСФайламиСлужебный.ДобавитьФайл(...)— 创建目录记录,将二进制数据放入存储/卷中。РаботаСФайлами.ОткрытьФайл(...)/.СохранитьФайлКак(...)— 获取和打开文件数据。ЭлектроннаяПодписьКлиент/Сервер— 设置ПодписанЭП标志,添加签名。ИзвлечениеТекстаСервер— 后台填充ТекстХранилище和СтатусИзвлеченияТекста,用于全文检索。
需要核实(版本相关):在 3.0.74.2 版本中对象模块被重写过程的具体组成——需通过配置器确定,因为 BSP 会周期性地将逻辑从对象转移到通用模块。
5. 过账与登记
该目录不过账,也不产生对寄存器的登记——“目录”类型的对象没有过账机制。因此:
- 该对象不产生哈萨克斯坦科目的会计分录(1210、1030、1330、3310、3130、6010、7010);
- 不写入个人所得税/税收扣除的计算寄存器;
- 不生成电子文档(ЭСФ 电子发票系统中的 ЭСФ、СНТ)——这些机制与附加文件无关。
该对象产生的唯一记录是目录本身的一行记录,以及可选的:
- 存储中的二进制数据记录(在信息库中)或存储卷中的文件(寄存器/目录
ТомаХраненияФайлов); - 文件版本记录(如果为所有者启用了版本控制);
- 全文检索数据的更新。
经济结果(应用扣除每月 30 MRP,但每年不超过360 MRP,个人所得税按10%/15%计算,扣缴强制养老金缴款 10%、雇主强制养老金缴款 3.5%、强制社会医疗保险费 2%、社会医疗保险 3%、社会保险缴款 5% 及社会税 6%)由所有者文档“个人所得税扣除申请”及后续的工资核算形成,而非该目录。附加文件仅作为文档依据。
6. 关联对象及基于其录入
| 关联 | 对象 | 性质 |
|---|---|---|
| 文件所有者 | Документ.ЗаявлениеНаПредоставлениеВычетовИПН |
每条目录记录属于一份申请(ВладелецФайла)。 |
| 用户 | Справочник.Пользователи |
属性 Автор、Изменил、Редактирует。 |
| 存储卷 | Справочник.ТомаХраненияФайлов |
存储在磁盘上时文件的物理存放位置。 |
| 状态 | Перечисление.СтатусыИзвлеченияТекстаФайлов |
文本索引状态。 |
| 电子签名 | BSP 电子签名/加密子系统 | ПодписанЭП 标志,签名存储。 |
基于其录入。该目录不使用经典的“基于其录入”机制。记录通过所有者文档表单中的文件附加命令创建;不存在基于文件单独录入其他文档的功能。
7. 扩展点
- 配置扩展(Adopt/Extend)。借用元素表单/列表表单以添加自定义的显示属性或按钮。不建议更改文件存储字段的组成——这会破坏与 BSP 的兼容性。
- 附加属性和信息。将对象连接到“属性”子系统(
ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения),用于标记依据文档的类型(例如,“申请书”、“证明材料”)。 - 事件订阅。目录的
ПередЗаписью/ПриЗаписи— 用于审计文件的上传/修改,以及控制具有法律效力的扫描件上必须存在电子签名。 - 交换规则(КД 2/3、EnterpriseData)。配置在同步中将附加文件与所有者文档一起导出。
- 全文检索。使用
ТекстХранилище/СтатусИзвлеченияТекста对所附 PDF/扫描件的内容进行检索。 - 权限限制(RLS)。按所有者配置文件访问权限——对于个人所得税申请中员工的个人数据尤为重要。
