--- title: "1С:会计 哈萨克斯坦版 3.0 中的\"外部组件\"参考手册 — 完整说明" country: KZ lang: zh author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-08 canonical: https://buhgpt.kz/suraqtar/spravochnik-vneshnie-komponenty-v-1s-buhgalteriya-dlya-ka-zh source: BuhGPT --- # 1С:会计 哈萨克斯坦版 3.0 中的"外部组件"参考手册 — 完整说明 > **TL;DR:** 已在“哈萨克斯坦会计”（3.0 版）3.0.74.2 版本上验证。 您在 ИС ЭСФ 中对电子发票点击“签名并发送”——而 1С 却回复： “无法加载外部组件” 或 “未连接加密组件” 。或者您接入了新的税务收款机（фискальный регистратор），但收银机打不开：程序找不到驱动。这两种情况的出路都指向同一个服务性参考手册—— “外部组件” 。这里存放着可加载模块（add-in），会计系统通过它们与 ЭЦП、加密、条码扫描器和收银设备协同工作。让我们弄清它的结构以及如何修复它。 1. 用途 该参考手册存放外部组件（add-in）—— --- 已在“哈萨克斯坦会计”（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 版本编写。 --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_