1. 识别
| 参数 | 值 |
|---|---|
| 对象类型 | 目录 (Catalog) |
| 名称 | НастройкиИнтеграцииWebKassa |
| 完整名称 | Справочник.НастройкиИнтеграцииWebKassa |
| 同义词 | 1С:WebKassa 集成设置 |
| 配置 | 哈萨克斯坦会计，版本 3.0 (版本 3.0.74.2) |
| 目的 | 存储连接到WebKassa 服务的参数 — 哈萨克斯坦在线传输财政收据（ККМ 数据）到国家收入机关（КГД МФ РК）的系统。 |
该目录存储与 WebKassa 的集成参数，按组织划分。每个元素与一个组织关联，并包含财政服务的地址和信息数据库中用户的列表，通过这些用户系统向财政运营商发出请求。
关键特性：每个组织只能有一个活动的（未标记为删除）集成设置。这确保了在财政化时连接参数的唯一选择。
在 1С 中查找的位置：部分“1С:WebKassa 集成” → “1С:WebKassa 集成设置”。导航链接：e1cib/list/Справочник.НастройкиИнтеграцииWebKassa
2. 头部和表格部分的属性
2.1 头部属性
| 名称 | 类型 | 必填 | 目的 |
|---|---|---|---|
| 组织 | СправочникСсылка.Организации | ShowError (必填) | 为其配置与 WebKassa 集成的组织。设置的唯一性关键字段 — 用于确定在财政化时应用哪个组织的连接参数。 |
| 地址服务 | 字符串 (xs:string) | ShowError (必填) | WebKassa 服务的 URL 地址，系统用于财政化文档时的请求。用于向财政运营商生成 HTTP 请求。 |
标准字段继承自目录机制：代码，名称，删除标记，预定义，链接。
2.2 表格部分
用户 — 拥有访问该组织 WebKassa 操作权限的用户列表。
| 名称 | 类型 | 目的 |
|---|---|---|
| 用户名 | 字符串 (xs:string) | 被授权通过配置的服务执行财政化操作的信息数据库用户的名称。用于区分对集成的访问权限。 |
3. 表单
在配置中，自定义对象的表单未定义（forms 数组为空）。平台使用自动生成的表单：
| 表单 | 目的 |
|---|---|
| 元素表单（自动） | 输入/编辑设置：选择组织，输入服务地址，填写用户表。 |
| 列表表单（自动） | 查看所有组织的设置列表，筛选，标记为删除。 |
| 选择表单（自动） | 在编程/交互选择设置时选择元素。 |
如需自定义（例如，添加“检查连接”按钮），应显式创建元素表单 — 见第 7 节。
4. 模块的关键过程
未附上带有 BSL 模块文本的 Evidence，因此下面是该类型对象的典型处理程序，实现所描述的业务逻辑（设置在组织上的唯一性）。
| 处理程序 | 模块 | 执行的操作（典型逻辑） |
|---|---|---|
ОбработкаПроверкиЗаполнения |
对象模块 | 检查必填的组织和地址服务是否填写；如有必要，检查 URL 的正确性和用户表用户的非空性。 |
ПередЗаписью |
对象模块 | 控制唯一性：通过请求目录检查是否存在其他未标记为删除的具有相同组织的元素；如有违反 — 拒绝 = 真并向用户显示消息。 |
ОбработкаЗаполнения |
对象模块 | 填充默认值（例如，来自当前用户设置的组织）。 |
地址服务在更改时 |
元素表单（在显式表单中） | 规范化输入的 URL（去除空格，检查 http/https 的方案）。 |
对服务的请求功能（生成 HTTP 请求、授权、发送收据）在典型配置中被移至集成 WebKassa 子系统的公共模块，而不是该目录的模块：目录作为连接参数的来源。
5. 处理和运动
该目录不是文档，且不进行处理。它在会计登记和积累登记中不生成记录，不进行会计分录。
财政化的经济结果（通过 ККМ 的销售）通过使用该目录作为参数来源的相关文档反映。根据哈萨克斯坦的标准会计逻辑生成分录（哈萨克斯坦的典型会计计划，增值税16%，货币 — 坚戈 ₸）：
| 操作 | 借方 | 贷方 |
|---|---|---|
| 确认销售收入 | 1210 “短期应收账款” / 1030 “当前账户上的资金” | 6010 “销售收入” |
| 增值税（16%）的计提 | 1210 / 1030 | 3130 “应付增值税” |
| 商品成本的扣除 | 7010 “销售成本” | 1330 “商品” |
示例：116,000 ₸ 的销售，含增值税 → 收入 100,000 ₸（贷方 6010），增值税 16,000 ₸（贷方 3130）。此时，财政收据根据目录中的参数发送到 WebKassa。
与交易相关的电子文档：ЭСФ（ИС ЭСФ）和СНТ — 作为配置中的单独对象进行处理，与 WebKassa 的设置没有直接关联。
6. 相关对象和基于的输入
- 目录.组织 — 参数的所有者（属性
组织）。 - 信息数据库用户 — 表
用户引用信息数据库中的用户名。 - 财政化文档（ККМ 收据 / 零售销售报告） — 设置的消费者：在开具收据时，系统根据文档的组织查找活动设置，并通过其
地址服务向 WebKassa 发出请求。 - 1С:WebKassa 集成子系统的公共模块 — 将目录元素用作 URL 和访问列表的来源。
基于的输入对于该目录的典型机制未提供（这是设置对象，而不是原始文档）。
7. 扩展点
- 检查连接。 添加自定义元素表单，包含调用测试 HTTP 请求到
地址服务并输出结果的命令。 - 存储令牌/秘密。 不在开放属性中存储 WebKassa 的登录/密码或 API 密钥，而是在受保护的存储中（
ХранилищеОбщихНастроек/ 具有访问限制的登记）；表用户仅定义名称列表。 - 订阅事件
ПередЗаписью/ОбработкаПроверкиЗаполнения— 用于调整唯一性控制和 URL 验证，而不更改对象模块。 - 扩展配置 — 安全地添加属性（例如，收银机的 ИИН/БИН，ККМ 编号，班次编号）和逻辑，而不取消对典型版本的支持。
需要针对特定版本进行检查：集成子系统公共模块的确切组成和在
ПередЗаписью中的预定义唯一性控制 — 它们依赖于版本，并且在不同的 3.0.7x 版本中可能有所不同。