RUKKENZH
Задать вопрос AI
栏目Объекты конфигурации 1С
1С:会计 哈萨克斯坦版 3.0 中的"外部组件"参考手册 — 完整说明
Язык статьи:🇷🇺 RU🇰🇿 KK🇬🇧 EN🇨🇳 ZH
Версия статьи:📘 Для бухгалтера⚙️ Для тех-специалиста

1С:会计 哈萨克斯坦版 3.0 中的"外部组件"参考手册 — 完整说明

适用于: 1С:Бухгалтерия для Казахстана, 版本 3.0.74.2 · 1C-Sapa 集团 — 1C 合作伙伴
СТ
Сапа Т.И. — Эксперт по 1С и бухгалтерскому учёту, преподаватель-практик

已在“哈萨克斯坦会计”(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 位的组件构建版本。

分步操作流程:

  1. 打开列表(见第 2 节)并点击“创建”——或者,如果组件已存在,则打开它进行编辑。
  2. 填写名称
  3. 点击“加载”/“加载组件文件”并指定内含清单的 ZIP 压缩包(推荐)或 dll。
  4. 检查版本集成版本支持的操作系统字段是否已自动填入——这是压缩包正确的标志。
  5. 对象标识符与配置所期望的进行核对。
  6. 勾选“已使用”标志。
  7. 记录并关闭。重启 1С 会话——组件在启动时加载。

4. 详解示例

情境。ТОО“阿斯塔纳贸易”的会计对向买方销售商品开具了 ЭСФ:不含增值税金额 1 000 000 ₸,按16%税率的增值税 = 160 000 ₸,合计 1 160 000 ₸。发送至 ИС ЭСФ 时 1С 提示:“无法按标识符 AddIn.CryptoPro 创建外部组件对象”。签名无法完成,ЭСФ 停留在“未发送”状态。

我们的处理:

  1. 通过链接 e1cib/list/Справочник.ВнешниеКомпоненты 打开参考手册。
  2. 看到元素“ЭЦП 加密提供程序”——“已使用”标志已取消,“版本”字段为空。这意味着在上次更新时模块丢失了。
  3. 下载最新的加密组件 ZIP 压缩包,点击“加载组件文件”。
  4. 加载后集成版本字段显示“2.11”,支持的模式——“瘦客户端、外部连接”。勾选“已使用”标志,进行记录。
  5. 重启 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 版本编写。

Частые вопросы

「外部组件」参考手册有分录吗?
没有。这是管理员用的服务性参考手册。分录由核算凭证(销售、入库、付款)生成,而不是它。
该参考手册与ЭСФ和16%增值税有何关联?
与金额直接关联——没有。但该参考手册中的加密组件是用电子签名对ЭСФ进行签名并将其发送到ИС ЭСФ所必需的。没有可用的组件,含16%增值税的凭证就无法发送到政府系统。
更新配置后组件去哪了?
更新时组件文件可能被替换,或者「使用中」标记被取消。打开该元素,加载最新文件,勾选标记,重新启动会话。
要加载什么格式的文件——dll还是zip?
建议使用带清单的ZIP压缩包:1С从中读取版本、操作系统和模式列表,正确加载所需的位数。「裸」dll并非总能工作。
为什么组件在Linux服务器上无法加载?
检查「支持的操作系统」字段。如果那里只有Windows——在Linux下它无法工作,需要跨平台版本。
能否临时禁用出错的驱动而不删除?
可以。取消「使用中」标记并重新启动会话——模块将停止加载,但仍保留在数据库中。
谁应该使用该参考手册——会计还是管理员?
通常是管理员或1С维护人员。会计只在签名或设备出错时才进入这里,多数是根据技术支持的提示。
加载后必须重启1С吗?
是的。平台在会话启动时连接外部组件。在重启之前——更改不会生效。

延伸阅读

Источники

Была ли статья полезна?
💼 Нужна помощь с 1С или учётом? Слава КВЦ — многолетняя практика в 1С в Казахстане. Изучите разложенный НК РК 2026 или спросите в чате BuhGPT — ответит за секунды.
标签:KZCatalogs