ERP 助手（erp-assistant）

嘉立创EDA & EasyEDA 专业版扩展：连接 嘉立创云 ERP / 嘉立创开放平台， 为 PCB BOM 自动匹配物料编号（写入器件「供应商编号」字段），并支持物料列表管理与 ERP 格式 BOM 导出。

本扩展基于官方 pro-api-sdk 开发，API 文档见 嘉立创EDA专业版 API 参考。

功能演示

完整工作流：配置 ERP → 拉取/导入物料列表 → 识别物料编号 → 写入器件 → 导出 ERP 格式 BOM。

1. 插件主览 —— PCB 编辑器顶部「ERP 助手」菜单

   

2. 配置 ERP —— 填写开放平台网关与三组密钥，保存即测试连接

   

3. 导入物料列表 —— 从云 ERP 全量拉取或导入 CSV，含库存 / 库位

   

4. 识别物料编号 —— 多级匹配结果预览，可手工修正后写回

   

5. 导出 BOM —— 按物料编号合并位号，生成嘉立创云 ERP 格式 xlsx

   

6. 导入 ERP —— 将导出的 BOM 明细导入嘉立创云 ERP

   

功能总览

预览窗口列：位号 | 物料名称 | 物料编号 | ERP库存 | 来源

• 物料名称显示链：ERP 物料列表名称 → 制造商编号 → EDA 器件名 （列表命中时以 ERP 名称为主，本地器件名灰色括注）
• 来源只分两类：立创EDA（器件自带/库搜索）与 ERP（物料列表/ERP 接口命中）
• 未设置的器件属性（如 {=Manufacturer Part} 占位符）自动视为空

匹配错误时如何更正

「物料编号」输入框已接入物料列表自动补全：点击或输入时会下拉筛选整份物料列表 （按编号、名称、规格、品牌模糊过滤），选中后该行物料名称自动同步为列表中的名称， 写入与导出均使用更正后的结果。

匹配优先级

「识别物料编号」按以下顺序取第一个命中结果：

1. 供应商编号：器件已有值则直接采用（不限 C 编号格式，编码写入目标即此字段）
2. 物料列表：精确匹配 → 相似度模糊匹配（阈值 50）
   • 比对维度：物料名称、规格型号、品牌、封装、厂商料号、物料编号
   • 电容/电阻（位号 C/R 开头）会额外提取容值/阻值（如 100nF、10K、4K7）作为辅助键
3. 已存在的旧版「物料编号/物料编码」自定义属性（历史数据兼容）
4. 嘉立创云 ERP 物料库接口（需配置连接；厂商料号检索 + 物料名模糊匹配，命中带出库存/库位）
5. 立创商城元器件库搜索兜底
6. 未匹配（可在预览窗口手工填写编码后写回）

导出 BOM（ERP 格式）

预览窗口点「导出BOM（ERP格式）」：按物料编号合并位号，列顺序与嘉立创云 ERP BOM 明细一致：

物料编号, 物料名称, 自定义编号, 品牌, 规格型号, 封装, 物料目录, 供应商, 单位, 单价, 物料备注, 用量, 位号, BOM明细备注

生成的 xlsx 可直接用于 ERP 的 BOM 导入。

物料列表

两种数据来源在窗口中以徽标区分（ERP / 手动），互不覆盖：

• 从 ERP 更新：经开放平台物料分页接口全量拉取（每页 1000 条），含库存数量与仓库/库位
• 导入 CSV：支持嘉立创云 ERP 物料清单导出原格式，UTF-8 / GBK 编码自动识别

CSV 模板

格式 A · 嘉立创云 ERP 物料清单原样导出（无需修改直接导入）

物料编号,物料名称,自定义编号,品牌,规格型号,封装,物料目录,...
RCA01DJ0353,贴片晶振_LX8112晶振_32.768KHZ_8233,,,,,元器件,...

格式 B · 精简模板

物料编号,物料名称,品牌,规格型号,封装
C12345,10K上拉电阻,Yageo,10K 1%,0402

• 编码列表头别名：物料编号 / 物料编码 / C编号 / 供应商编号 等
• 其余识别列别名：物料名称 / 名称 / 规格型号 / 品牌 / 封装 / 厂商料号 / 自定义编号 等

连接嘉立创云 ERP

采用 嘉立创开放平台 的 JOP 签名认证：

1. 在 open.jlc.com 控制台 创建应用 并 配置密钥，得到 appId / accessKey / secretKey
2. 扩展菜单 → 「ERP 连接设置」，填写网关地址（默认 https://open-api.jlc.com）与三组凭证，保存即测试

直连报 NetworkError？

EDA 扩展环境受 CORS 限制。若网关不允许跨域，在项目目录启动本地转发代理：

npm run erp-proxy
# 监听 http://127.0.0.1:8321 -> https://open-api.jlc.com

然后在「ERP 连接设置」中把网关地址改为 http://127.0.0.1:8321。 签名仍在扩展本地完成（SecretKey 不出插件），代理仅透明转发。

快速上手

1. 克隆本仓库并 npm install
2. （可选）npm run erp-proxy 启动代理
3. 安装 build/dist/erp-assistant_v*.eext，并在 EDA 扩展管理中开启本扩展的 外部交互权限
4. 「ERP 助手 → ERP 连接设置」完成配置并测试通过
5. 「物料列表」确认自动更新成功（或导入 CSV）
6. 「识别物料编号」→ 预览核对 → 写入供应商编号 / 导出 ERP 格式 BOM

开发命令

npm run debug      # 开发调试
npm run build      # 编译打包到 build/dist/
npm run lint       # ESLint 检查
npm run erp-proxy  # 本地网关代理

开源许可

Apache License 2.0