聚水潭批量修改商家编码有三种方法：一、导出-编辑-导入Excel，适用于结构化批量变更；二、商品小工具“批量编辑”，适合中等批量简单修改；三、调用API接口，适用于已对接外部系统的自动化同步。
如果您在聚水潭系统中需统一调整大量商品的商家编码，但逐条手动编辑效率极低，则需借助批量操作功能实现高效更新。以下是完成该任务的具体方法：
一、通过商品资料导出-编辑-导入方式批量修改
该方式适用于需对数百至数千条商品执行结构化编码变更，例如按款号规则补全颜色/尺码后缀、统一添加前缀或替换特定字符。所有修改均在本地Excel中完成，确保逻辑可控、可复核。
1、进入【商品】→【普通商品资料】界面，点击右上角【导出】按钮，勾选“全部数据”并确认导出。
2、打开导出的Excel文件，定位到“商家编码”列，使用Excel公式（如SUBSTITUTE、CONCATENATE）或查找替换功能批量更新内容。
3、保存文件为.xlsx格式，返回【普通商品资料】界面，点击【导入】→【选择文件】，上传已编辑完成的Excel。
4、系统自动校验字段格式与必填项，确认无红色报错提示后，点击【开始导入】，等待进度条完成。
5、导入成功后，在【商品小工具】→【导入记录】中查看结果明细，重点核对“失败数”是否为0，且“更新数”与预期修改条目一致。
二、使用商品小工具中的“批量编辑”功能
该方式无需下载上传文件，适合中等批量（通常≤500条）且修改逻辑较简单的情形，例如统一追加相同前缀、清空某类编码、或按筛选条件设置固定值。
1、进入【商品】→【商品小工具】→【批量编辑】，点击【新建批量编辑任务】。
2、在“筛选条件”区域，设置目标商品范围：可按“商品名称包含”“所属类目”“创建时间”“当前商家编码值”等维度精确锁定。
3、在“编辑字段”区域，下拉选择“商家编码”，输入新值或选择“按规则生成”，启用变量如{款号}-{颜色}-{尺码}模板。
4、点击【预览修改效果】，系统列出将被修改的前20条示例，确认字段映射无误、无误覆盖非目标商品。
5、预览无误后，点击【执行批量编辑】，任务提交后可在【任务记录】中查看实时状态与完成报告。
三、通过API接口调用实现自动化批量同步
该方式面向已对接外部系统（如PLM、WMS或自研中台）的企业，由外部系统按既定规则生成最新商家编码，并通过聚水潭开放平台接口实时回写，保障编码源头唯一性与强一致性。
1、确保已在聚水潭开发者后台创建应用，获取有效的APP Key与APP Secret，并完成店铺授权。
2、调用聚水潭开放接口【jst.item.update】，POST参数中必须包含shop_id、item_id（聚水潭商品ID）及new_item_code（目标商家编码）。
3、每次请求最多携带50个item_id，需分批循环调用；响应体中检查result字段，仅当code=0且success=true时视为单次成功。
4、全部调用完成后，调用【jst.item.get】接口随机抽检10条商品，验证商家编码字段已实时更新。
