已在 3.0.74.2 版本"哈萨克斯坦会计"(3.0 版)上验证。
收银台在营业中途卡住了。顾客已经数好了钱，而 1С 屏幕上却显示红色的"WebKassa 服务授权错误：登录名或密码错误"。收据打不出来，队伍排着长龙，而财政数据运营商正在等待销售数据。十有八九罪魁祸首都是同一条记录——目录卡片 WebKassa集成设置，其中存储着您在线收银机的登录名、密码和唯一编号。让我们弄清楚如何一次性正确地建立它，之后再也不用回头处理。
1. 用途
该目录存储 1С 连接到云端财政化服务 WebKassa(哈萨克斯坦财政数据运营商)的连接参数。程序通过这条记录将收银机(ККМ)收据发送到财政数据运营商(ОФД)，获取财政标识并打印带二维码的收据。该目录本身不生成分录——它是访问服务的"钥匙"，由 收银机收据 和 零售销售报告 单据使用。
2. 在哪里找到
界面中的路径：
- "销售"版块(或"银行与现金")→ 设置 组 → WebKassa 集成设置。
- 或者通过 "管理" → "可连接设备" / "与财政数据运营商交换"，如果您启用了相应的功能选项。
要直接打开目录，请在"主菜单 → 服务 → 通过导航链接跳转"字段中粘贴导航链接：
e1cib/list/Справочник.НастройкиИнтеграцииWebKassa
如果没有该菜单项——请启用与财政数据运营商的交换："管理" → "程序设置" → "销售"(或"组织与会计政策")→ 使用在线收银机 / WebKassa 的复选框。
2а. 如何查看您的版本
"帮助" → "关于程序"(或右上角的 ℹ️ 图标)。那里有两行：平台版本(例如 8.3.24.xxxx)和 配置版本——"哈萨克斯坦会计，3.0 版 (3.0.74.2)"。正是第二行应该与本操作手册标题中所标注的一致。如果您的版本较旧——部分字段的名称可能不同。
3. 如何填写
打开目录，点击 "创建"。从上到下填写字段。
| 字段 | 必填 | 作用及出错后果 |
|---|---|---|
| 名称 | ✅ | 记录在列表中的显示方式。写清楚："WebKassa — 阿拜街商店"。如果保留默认的"设置 1"且有多个收银台——会搞混，收据会发到错误的收银台。 |
| 组织 | ✅ | 按哪个组织发送收据。此处出错 = 收据以他人 БИН 发出，财政数据运营商会拒收。 |
| 服务地址 (URL API) | ✅ | WebKassa API 的入口点(https://api.webkassa.kz/api/)。地址打错——将根本无法连接，"服务不可用"。测试环境的地址不同——不要与生产环境搞混。 |
| 登录名 | ✅ | 来自 WebKassa 个人账户的收银员用户电子邮箱。登录名错误 = "授权错误"，收据打不出来。 |
| 密码 | ✅ | 同一用户的密码。存储在数据库中；在 WebKassa 账户中更改密码时，别忘了在这里也一并更改。 |
| 令牌 (Token) | — | 会话密钥。通常在点击"检查连接" / "授权"后 自动填入。请勿手动填写——它是临时的，由程序更新。 |
| 收银机唯一(注册)编号 (KassaUniqueNumber) | ✅ | 来自 WebKassa 账户的具体收银机(ККМ)标识符。这就是收据"绑定"的对象。编号错误——收据会发到另一台收银机或返回"未找到收银机"错误。 |
| 收银机(ККМ) / 营业点 | ✅ | 指向 1С 中"收银机(ККМ)"目录元素的链接，其中包含型号、出厂编号和注册编号。将设置与销售地点关联起来。 |
| 有效 / 使用 | — | 激活复选框。取消——1С 将停止通过此设置发送收据(在收银机重新注册时使用比删除更方便)。 |
| 舍入 / 收据格式 | — | 显示参数(舍入到坚戈、打印顾客电子邮箱)。因版本而异：字段集取决于版本，需要在您的构建中检查。 |
填写完成后，点击 "检查连接"(或"授权")。成功 = 绿色的"连接已建立"，令牌已填入。只有这时才 "保存并关闭"。
4. 带分录的解析示例
个体经营者(ИП)"阿克季夫"的商店以现金向顾客出售一件商品。标价 11 600 ₸，含 16 % 增值税。商品的账面成本 7 000 ₸。
首先按"内含"方式提取增值税：
- 增值税 = 11 600 × 16 / 116 = 1 600 ₸
- 不含增值税收入 = 11 600 − 1 600 = 10 000 ₸
收银员打出 收银机收据，它通过 WebKassa 设置发送到财政数据运营商，返回财政标识，打印收据。当日结束时生成 零售销售报告，它生成分录：
| 借 | 贷 | 金额, ₸ | 内容 |
|---|---|---|---|
| 1010(或 1030) | 6010 | 10 000 | 不含增值税的销售收入 |
| 1010(或 1030) | 3130 | 1 600 | 应缴增值税，16 % |
| 7010 | 1330 | 7 000 | 结转已售商品成本 |
结果：现金/账户收到 11 600 ₸，收入 6010 — 10 000 ₸，增值税义务 (3130) — 1 600 ₸，此笔销售的财务结果为 10 000 − 7 000 = 3 000 ₸ 毛利。
重要：WebKassa 卡片本身不生成任何一条分录——它只确保收据发送到财政数据运营商。会计结果由收银机收据 / 零售销售报告形成。
5. 操作类型(该目录提供什么)
通过 WebKassa 设置，收银台单据执行以下操作：
- 销售——普通的销售收据。
- 销售退货——向顾客退货，减少收入和增值税。
- 向收银台 存入现金(服务操作)。
- 从收银台 提取(收缴)。
- 开班 / 关班(X 和 Z 报告)——将班次的开始和结束发送到财政数据运营商。
可用操作集不是在卡片本身中设定，而是在使用它的单据中设定；设置仅将它们路由到 WebKassa。
6. 通过此设置工作时会生成什么
- 在财政数据运营商(WebKassa)中：带有财政标识、二维码和核验链接的财政收据；关班时——Z 报告。
- 在 1С 中——收银机收据单据：销售登记簿、与顾客往来结算、零售收入的移动。
- 分录(通过零售销售报告 / 关班时)：借 1010、1030 — 贷 6010、3130；借 7010 — 贷 1330(见示例)。
- 收据与电子单据的关联：向法人批发发货时，另外开具 ЭСФ(ИС ЭСФ)，而在流通可追溯/需标识商品时——开具 СНТ。零售收银机收据本身不需要 ЭСФ，但应顾客要求可单独开具 ЭСФ 单据。
7. 打印表单
- WebKassa 财政收据——带二维码、财政标识、БИН/ИИН、收银机(ККМ)编号和 consumer.oofd/webkassa 核验链接。
- 商品收据——必要时随财政收据附上。
- X 报告(不清零)和 Z 报告(班次清零)。
- 收银台/班次状态报告——来自账户/集成的服务表单。
目录本身没有打印表单——打印的是通过它发送的单据。
8. 常见错误
- "WebKassa 服务授权错误：登录名或密码错误"。卡片中的登录名/密码与 WebKassa 账户不符(最常见的是在账户中改了密码，而在 1С 中忘记改)。更新密码，点击"检查连接"。
- "未找到指定唯一编号的收银机"。"收银机唯一编号"字段打错或收银机在账户中已停用。逐字符与 WebKassa 个人账户核对编号。
- "服务不可用 / 无法建立连接"。API URL 错误或没有网络/被拦截。检查地址
https://api.webkassa.kz/api/和网络访问。 - "班次已超过 24 小时，请关班"。Z 报告未及时生成。关班(Z 报告)并重新开班。
- "令牌已过期"。再次点击"授权"——1С 会自动获取新令牌。
- 收据以其他组织发出。卡片中选择了错误的"组织"——收据中的 БИН 不符。更正组织并重新过账单据。
9. 常见问题
问：目录会生成会计分录吗？ 答：不会。它只存储连接 WebKassa 的参数。分录由收银机收据和零售销售报告生成。
问：2026 年收据中应填写什么增值税税率？ 答：基本税率——16 %。对于商品/服务，它按"内含"方式提取：增值税 = 金额 × 16 / 116。
问：从哪里获取收银机唯一编号？ 答：在 WebKassa 个人账户的收银机(ККМ)卡片中(KassaUniqueNumber / 注册编号)。同样将其复制到"收银机(ККМ)"目录中。
问：需要手动填写令牌吗？ 答：不需要。令牌在成功授权后自动填入，并定期更新。手动输入会导致会话错误。
问：可以建立多个收银机吗？ 答：可以。为每台收银机(ККМ)/营业点创建单独的记录，并指定不同的唯一编号，必要时指定不同的用户。
问：零售收银机收据能替代 ЭСФ 吗？ 答：不能。对于法人买家，ЭСФ 在 ИС ЭСФ 中单独开具。收银机收据记录零售支付；在流通可追溯商品时另外办理 СНТ。
问：商品退货时该怎么做？ 答：办理"销售退货"操作——退货收据会发送到 WebKassa 并减少收入(冲销 借 6010，贷 3130)和成本(恢复 借 1330，贷 7010)。
问：如何在不删除设置的情况下临时停用收银机？ 答：取消"有效 / 使用"复选框。数据会保留，但不会再通过它发送收据。
问：顾客投诉"收不到收据"时该看哪里？ 答：检查收据中是否填写了顾客的电子邮箱/电话，以及设置中的收据格式是否允许发送——这由卡片中的收据格式参数控制。
10. 相关单据
- 基于该设置工作的：收银机收据、零售销售报告、开班/关班单据(Z 报告)。
- 关联目录："收银机(ККМ)"(型号、出厂编号和注册编号)、"组织"、"仓库/营业点"。
- 沿链条往下：销售 → 必要时开具 ЭСФ(ИС ЭСФ) 和 СНТ；零售汇总进入 1010/1030、6010、3130、7010、1330 科目的科目余额表。
如何查看您的版本："帮助" → "关于程序"——那里标明了平台版本和配置版本。
本操作手册已在 3.0.74.2 版本"哈萨克斯坦会计"(3.0 版)上编制并验证。哈萨克斯坦的数值标准按 2026 年提供：增值税 16 %，月计算指标(МРП) 4 325 ₸，最低工资(МЗП) 85 000 ₸。