已在“哈萨克斯坦会计”(3.0 版)3.0.74.2 版本上验证。
您在 ИС ЭСФ 中对电子发票点击“签名并发送”——而 1С 却回复:“无法加载外部组件”或“未连接加密组件”。或者您接入了新的税务收款机(фискальный регистратор),但收银机打不开:程序找不到驱动。这两种情况的出路都指向同一个服务性参考手册——“外部组件”。这里存放着可加载模块(add-in),会计系统通过它们与 ЭЦП、加密、条码扫描器和收银设备协同工作。让我们弄清它的结构以及如何修复它。
1. 用途
该参考手册存放外部组件(add-in)——扩展平台功能的二进制模块:用于 ЭСФ 和 СНТ 的加密与 ЭЦП、与政府机关的交换、贸易与收银设备、扫描器。1С 在启动操作时从此参考手册加载所需模块。这是管理员的技术性参考手册,而非会计凭证——它不会产生任何账户和税务的记账动作。
2. 在哪里查找
会计菜单中没有单独的“外部组件”条目——这是一个服务性对象。可通过三种途径打开:
- 主菜单(左上角的 ≡ 图标)→“所有功能”→“参考手册”→“外部组件”。如果没有“所有功能”条目——请启用它:“服务”→“参数”→勾选“显示‘所有功能’命令”。
- 管理 → 维护——处理附加模块和组件的部分(针对来自供应商的组件)。
- 通过导航链接——最直接的方式。
1С 导航链接:
e1cib/list/Справочник.ВнешниеКомпоненты
复制它,然后在 1С 中:“服务”→“转到导航链接”(或者在旧版中:主菜单 →“文件”),粘贴并点击“转到”。参考手册将以列表形式打开。
收银机和扫描器的组件通常通过管理 → 可连接设备部分自动创建,但物理上都是注册在同一个参考手册中。
2а. 如何查看自己的版本
菜单“帮助”→“关于程序”(或图标 ≡ →“帮助”→“关于程序”)。在窗口中您会看到两行:
- 平台版本——例如“1С:企业 8.3.24.xxxx”(对于外部组件这至关重要:旧平台无法加载新版本的 Native API)。
- 配置——“哈萨克斯坦会计,3.0 版(3.0.74.2)”。
正是第二行应当与本说明书顶部的信息一致。
3. 如何填写
大多数情况下,您并非“从零手动”创建元素,而是加载组件文件——1С 会自行从清单文件中提取参数。但需要了解各字段,因为模块能否连接取决于它们。
| 字段 | 用途及出错后果 |
|---|---|
| 名称 (必填) | 列表中人类可读的名称(“ЭЦП НУЦ РК”、“ФР Порт 驱动”)。不影响任何技术功能,但如果命名含糊——之后就难以在十几个相似模块中找到所需的那个。 |
| 对象标识符(ProgID) (必填) | 配置用来请求组件的程序名称,形如 AddIn.ИмяКомпоненты。由模块开发者设定。错一个字符——代码会调用 AddIn.Крипто,而您存的是 AddIn.Crypto,1С 就会提示找不到组件。 |
| 已使用 / 使用 (标志) | 允许加载。取消勾选 = 模块存在于数据库中但不被加载。适用于临时禁用出故障的驱动而无需删除它。 |
| 组件文件 | add-in 本身:.dll/.so 或(正确方式)内含清单文件 MANIFEST.XML 的 ZIP 压缩包。正是从压缩包中 1С 读取版本和操作系统列表。若加载不含清单的“裸” dll——部分属性将保持为空,且在 64 位平台上模块可能无法加载。 |
| 版本 (从清单中读取) | 模块自身的版本。加载文件后自动填写。请勿手动修改。 |
| 集成版本(Native API) (从清单中读取) | Native 协议的版本。如果它高于您平台所支持的版本,组件将无法加载——请先更新平台。 |
| 支持的操作系统 (读取) | Windows / Linux / macOS。如果服务器是 Linux 而组件仅支持 Windows——在服务器上将无法工作。 |
| 支持的集成模式 (读取) | 瘦客户端、Web 客户端、外部连接、服务器。用于后台发送 ЭСФ 的加密必须支持“外部连接”/“服务器”,否则后台任务无法启动它。 |
| 支持的架构(x86/x64) (读取) | 位数。64 位瘦客户端需要 64 位的组件构建版本。 |
分步操作流程:
- 打开列表(见第 2 节)并点击“创建”——或者,如果组件已存在,则打开它进行编辑。
- 填写名称。
- 点击“加载”/“加载组件文件”并指定内含清单的 ZIP 压缩包(推荐)或 dll。
- 检查版本、集成版本、支持的操作系统字段是否已自动填入——这是压缩包正确的标志。
- 将对象标识符与配置所期望的进行核对。
- 勾选“已使用”标志。
- 记录并关闭。重启 1С 会话——组件在启动时加载。
4. 详解示例
情境。ТОО“阿斯塔纳贸易”的会计对向买方销售商品开具了 ЭСФ:不含增值税金额 1 000 000 ₸,按16%税率的增值税 = 160 000 ₸,合计 1 160 000 ₸。发送至 ИС ЭСФ 时 1С 提示:“无法按标识符 AddIn.CryptoPro 创建外部组件对象”。签名无法完成,ЭСФ 停留在“未发送”状态。
我们的处理:
- 通过链接
e1cib/list/Справочник.ВнешниеКомпоненты打开参考手册。 - 看到元素“ЭЦП 加密提供程序”——“已使用”标志已取消,“版本”字段为空。这意味着在上次更新时模块丢失了。
- 下载最新的加密组件 ZIP 压缩包,点击“加载组件文件”。
- 加载后集成版本字段显示“2.11”,支持的模式——“瘦客户端、外部连接”。勾选“已使用”标志,进行记录。
- 重启 1С,重新打开 ЭСФ,点击“签名并发送”——签名成功,凭证发送至 ИС ЭСФ。
此操作的会计分录:没有。加载组件是技术性操作。会计分录并非由该参考手册生成,而是由与 ЭСФ 关联的销售凭证本身生成:
| 借 | 贷 | 金额,₸ | 内容 |
|---|---|---|---|
| 1210 | 6010 | 1 000 000 | 销售收入 |
| 1210 | 3130 | 160 000 | 应缴增值税 16% |
| 7010 | 1330 | (成本) | 结转商品成本 |
也就是说,正常运行的外部组件是让这 1 160 000 ₸ 的 ЭСФ 能够发送到政府系统的前提条件。参考手册本身不参与这些分录。
5. 操作类型(可以做什么)
该参考手册在会计意义上不“执行操作”,但提供以下动作:
- 加载组件文件——将 add-in 写入数据库。
- 更新组件——将文件替换为新版本(在更新配置或驱动时)。
- 启用 / 禁用(“已使用”标志)——在不删除的情况下管理加载。
- 查看清单属性——版本、操作系统、模式、架构。
- 删除(标记为删除)——如果不再需要该组件。
6. 记录时生成什么
如实且切中要点——没有会计后果:
- 借/贷分录——不生成。
- ЭСФ / СНТ——该参考手册不创建它们(它仅保障对其进行签名的加密功能的运行)。
- 税务登记簿(增值税、ИПН、ОПВ、СО、社会税)——不受影响。
- 实际发生的是:组件文件保存在参考手册元素内部的值存储中,而在下次会话启动时,平台加载该模块并使配置代码中可以调用
AddIn.<标识符>。
如果有人向您承诺“外部组件的分录”——那是错误的:账户动作由凭证(销售、入库、付款)产生,而非服务性参考手册。
7. 打印表单
该对象没有标准的会计打印表单(账单、验收单、发货单)——这里没什么可打印的。仅可在元素卡片本身中查看组件属性的服务性视图(版本、操作系统、集成模式)。诊断时技术性登记日志很有用:“管理 → 维护 → 登记日志”——那里能看到组件加载事件和错误。
8. 常见错误
“无法按标识符 AddIn.XXX 创建外部组件对象”。 原因:组件未加载、已禁用(取消了“已使用”标志),或参考手册中的 ProgID 与代码请求的不一致。修正:打开元素,逐字符检查标识符,加载文件,勾选标志,重启会话。
“外部组件不支持该客户端架构(x64/x86)”。 原因:您用的是 64 位瘦客户端,而压缩包中只有 32 位构建版本。修正:加载含清单且同时包含两种位数的 ZIP 压缩包,或启动 32 位客户端。
“当前平台版本不支持该外部组件的版本”。 原因:“集成版本(Native API)”高于您平台所能支持的。修正:更新 1С:企业平台(第 2а 节会显示当前版本),然后重新加载。
“文件不是外部组件” / 加载后属性未填入。
原因:加载了不含清单的“裸” dll 或损坏的压缩包。修正:使用内含 MANIFEST.XML 的 ZIP 压缩包——那样版本和操作系统列表就会自动填入。
组件在操作员端能用,但在后台任务中不行(ЭСФ 的定期发送失败)。 原因:组件没有“外部连接”/“服务器”模式。修正:检查“支持的集成模式”;服务器端加密需要服务器端构建版本。
9. 常见问答
“外部组件”参考手册有分录吗? 没有。这是管理员的服务性参考手册。分录由会计凭证(销售、入库、付款)生成,而非它。
该参考手册与 ЭСФ 和 16% 增值税有何关联? 与金额直接——毫无关联。但需要该参考手册中的加密组件来对 ЭСФ 进行电子签名并将其发送至 ИС ЭСФ。没有可用的组件,含 16% 增值税的凭证就无法发送到政府系统。
更新配置后组件为何不见了? 更新时组件文件可能被替换,或“已使用”标志丢失。打开元素,加载最新文件,勾选标志,重启会话。
应加载哪种文件格式——dll 还是 zip? 推荐内含清单的 ZIP 压缩包:1С 从中读取版本、操作系统与模式列表,并正确加载所需位数。“裸” dll 并非总能工作。
为何组件在 Linux 服务器上无法加载? 检查“支持的操作系统”字段。如果那里只有 Windows——在 Linux 下将无法工作,需要跨平台构建版本。
能否临时禁用出故障的驱动而不删除? 可以。取消“已使用”标志并重启会话——模块将停止加载,但仍保留在数据库中。
谁应处理该参考手册——会计还是管理员? 通常是管理员或 1С 维护人员。会计仅在出现签名/设备错误时进入这里,且多是根据技术支持的提示。
加载后一定要重启 1С 吗? 是的。平台在会话启动时连接外部组件。在您重启之前——更改不会生效。
在哪里获取最新的组件文件? 从功能提供方处:加密提供程序——从 ЭЦП/НУЦ 开发者网站,设备驱动——从收银机供应商或通过 1С 的更新服务。
该参考手册是否影响月度关账或报表(ИПН、ОПВ、СО)? 不影响。税费和缴款的计算(ИПН、ОПВ 10%、ОПВР 3.5%、ВОСМС 2%、ОСМС 3%、СО 5%、社会税 6%)由工资和关账凭证执行;该参考手册不参与其中。
10. 相关对象
- 基于什么产生:组件通常随配置/扩展的更新一同到来,或由管理员在连接新设备或加密时手动创建。
- 谁使用它:处理 ЭЦП 和交换的凭证与处理程序——ЭСФ、СНТ、与 ИС ЭСФ 和政府机关的交换;“可连接设备”子系统(税务收款机、扫描器、收单)。
- 相邻设置:“管理 → 可连接设备”、“管理 → 电子凭证交换”、ЭЦП 证书参考手册、用于诊断的登记日志。
版本相关的注意点(需在您的构建版本上验证):加载命令的构成以及“管理”菜单中条目的确切位置,在 3.0.7x 各子版本之间可能有所不同——如果找不到“加载组件文件”按钮,请通过导航链接打开参考手册,并从元素表单中进行操作。
如何查看自己的版本
菜单“帮助”→“关于程序”:那里标明了平台版本(1С:企业 8.3.x)和配置版本。本说明适用的配置应为“哈萨克斯坦会计”,3.0 版,3.0.74.2 版本。如果您的版本不同——命令的位置和组件的属性集可能略有不同。
本手册为“哈萨克斯坦会计”(3.0 版)3.0.74.2 版本编写。
