需建立多平台商品映射关系以解决sku不一致、条码缺失等问题。可通过四类方式实现：一、按条码自动匹配；二、手动创建主商品并逐个绑定；三、csv批量导入；四、调用奇门api程序化配置。

如果您在聚水潭ERP中管理多个电商平台的商品，但各平台SKU编码不一致、条码缺失或命名规则冲突，导致库存无法统一、订单匹配失败，则需建立准确的商品对应关系。以下是实现多平台商品映射的多种操作路径：

一、按条码自动匹配

该方式依赖各平台商品资料中填写的标准化条形码（如EAN、UPC、ISBN或自定义统一编码），系统通过比对条码字段自动识别同款商品并建立映射关系，适用于条码完整且格式统一的场景。

1、登录聚水潭后台，进入【商品管理】→【商品资料】，检查主商品是否已维护有效条码信息。

2、确认所有平台商品后台（淘宝、京东、拼多多等）的“商品编码”或“条形码”字段均已填入完全相同且无空格/大小写差异的数字串。

3、进入【商品管理】→【商品配对】→【自动匹配】，点击【执行条码匹配】，系统扫描全部平台子商品并生成待确认配对列表。

4、核对匹配结果，勾选确认项后点击【批量绑定】，系统将自动创建主商品与各平台子商品的映射关系。

二、手动建立主商品并逐个绑定

当多个平台商品无统一条码，或条码存在前缀、空格、大小写混用等格式问题，导致自动匹配失败时，可通过人工主导方式创建主商品，并显式指定每个子商品的归属关系，确保映射逻辑可控、可追溯。

1、在【商品管理】→【商品资料】中点击【新增】，创建一个不含销售属性的虚拟主商品，仅填写商品名称、类目及统一标准条码（如暂无则填内部编码）。

2、进入【商品管理】→【商品配对】→【手动配对】，点击【新建主商品配对】，选择上一步创建的主商品。

3、点击【添加子商品】，依次从下拉菜单中选择对应平台（taobao/jd/pdd等）、输入子商品在该平台的原始SKU编码或商品ID。

4、每添加一个子商品后，点击【校验平台商品】确保其在对应店铺中真实存在且状态正常；全部绑定完成后点击【保存配对】。

三、通过CSV文件批量导入配对关系

适用于已梳理完成配对清单的中大型商家，支持一次性提交数百条映射规则，避免逐条操作耗时，提升治理效率，要求数据格式严格符合系统规范。

1、下载标准配对模板：进入【商品管理】→【商品配对】→【批量导入】，点击【下载CSV模板】。

2、按模板要求填写四列内容：主商品ID（聚水潭内部ID）、子商品平台编码、子商品所属平台标识（如taobao、jd、pdd）、子商品原始SKU。

3、确保主商品ID已在聚水潭中存在，且平台标识值为系统预设白名单内字符串，否则导入将被拒绝。

4、全选填写完成的数据区域（含表头），Ctrl+C复制；返回【批量导入】弹窗，Ctrl+V粘贴，点击【确定】触发解析与入库。

四、调用奇门API程序化配置映射

面向已接入聚水潭开放平台且具备开发能力的商家，通过调用官方奇门API接口，以编程方式动态提交、更新、查询商品配对关系，适用于需与WMS、CRM或自有中台实时联动的集成场景。

1、确认已获取有效的APP Key与APP Secret，并完成应用授权与消息订阅配置。

2、构造POST请求至奇门接口地址：https://api.jushuitan.com/qimen/itemMap/add，Body中传入JSON格式参数，包含主商品ID、平台编码数组、各平台SKU及平台标识。

3、请求头中必须携带Authorization签名及Content-Type: application/json。

4、接收响应体中的code字段，若为200且success为true，则表示映射规则已成功写入聚水潭底层关系表。