需先申请聚水潭开发者资质并创建应用获取app key与secret；再在erp中配置店铺编号（shopid）和回调地址；然后通过erp触发淘宝oauth2.0授权获取access_token；最后验证授权状态并同步商品订单数据。
一、申请聚水潭开发者资质并创建应用
聚水潭对接淘宝/天猫店铺前，需以开发者身份在聚水潭开放平台完成入驻与应用创建，获取对接必需的凭证参数。只有通过认证的应用才能发起淘系授权流程。
1、访问聚水潭开放平台官网：https://openweb.jushuitan.com/，使用企业主账号登录。
2、进入【开发者管理】→【入驻申请】，填写企业信息并提交审核材料，等待平台人工审核通过。
3、审核通过后，进入【应用管理】→【创建应用】，选择应用类型为电商后台，并指定场景为淘宝/天猫商家后台系统。
4、填写应用名称、描述、回调地址（暂填占位地址，后续替换为真实回调地址），提交创建。
5、创建成功后，在应用详情页中复制记录APP Key与APP Secret，这两个参数将用于后续API调用与授权验证。
二、配置聚水潭ERP中的店铺编号与回调地址
店铺编号（shopid）是聚水潭ERP识别具体淘系店铺的唯一标识；回调地址则用于接收淘宝授权成功后的code及后续消息推送，二者缺一不可。
1、登录聚水潭ERP管理后台：https://www.erp321.com/epaas，使用店铺管理员账号。
2、进入【系统设置】→【店铺管理】→【新增店铺】，选择平台为淘宝/天猫，完成基础店铺信息录入。
3、保存后，系统自动生成该店铺的shopid，请在店铺列表中找到对应条目并复制该值。
4、进入【系统设置】→【消息推送】→【消息订阅配置】，粘贴已准备好的回调地址（格式如：https://yourdomain.com/jushuitan/callback），勾选【订单创建】【订单状态变更】【商品库存变更】等必要事件。
5、点击【保存配置】，确保状态显示为“已启用”。
三、执行淘宝/天猫商家授权操作
此步骤由商家在聚水潭ERP中主动触发，跳转至淘宝官方授权页面，完成OAuth2.0授权流程，获取长期有效的access_token基础凭据。
1、返回聚水潭ERP后台，进入【系统设置】→【对接设置】→【商家授权】模块。
2、确认APP Key、APP Secret、shopid三项已正确填写且保存成功。
3、点击【立即授权】按钮，页面自动跳转至淘宝开放平台授权页（URL含聚水潭应用标识）。
4、在淘宝授权页中，使用淘宝主账号（非子账号）输入账号密码并完成登录与二次验证。
5、勾选所需授权范围（必须包含订单读取、商品读取、物流单号回传权限），点击【同意授权】。
6、授权成功后，页面自动跳回聚水潭ERP，并显示“已授权”状态及授权时间；此时系统已获取初始code，将在后台自动换取access_token。
四、验证授权状态并同步基础数据
授权完成后，需确认token有效性及数据通道连通性，再启动首次商品与订单同步，避免因凭证失效或配置遗漏导致同步中断。
1、在ERP后台【系统设置】→【对接设置】中，查看【授权状态】栏是否持续显示绿色“有效”标识，若显示“过期”或“无效”，需重新触发授权。
2、进入【商品管理】→【同步商品】，点击【手动同步】，系统将拉取淘宝店铺全部在线商品（含SKU、价格、库存、主图等）至聚水潭本地库。
3、检查同步日志：若出现“货号重复”“类目不匹配”等报错，需返回淘宝后台修正对应商品属性后再重试。
4、进入【订单管理】→【同步设置】，开启“实时同步订单”开关，确认订单创建后5秒内可在聚水潭订单列表中查到新单。
5、模拟一笔淘宝测试订单（如使用小号下单并付款），观察聚水潭是否生成对应订单，且订单状态为“待发货”。
五、处理常见授权失败情形
淘宝授权过程中可能因账号权限、网络策略或配置偏差导致中断，需针对性排查并切换替代路径。
1、若跳转至淘宝页后提示“应用未上线”或“参数错误”，请核对聚水潭应用管理中的回调地址是否与ERP中填写的完全一致（含http/https、末尾斜杠）。
2、若授权页提示“该账号无权操作此应用”，说明当前登录的淘宝账号未被添加为该聚水潭应用的管理员或绑定店铺主账号，需前往淘宝卖家中心【店铺管理】→【子账号管理】中添加权限。
3、若授权成功但ERP仍显示“未授权”，检查ERP服务器能否正常访问淘宝域名（oauth.taobao.com），防火墙或DNS劫持可能导致回调请求丢失。
4、对于多店铺商家，须为每个淘宝/天猫子店分别执行独立授权流程，不可复用同一shopid或同一授权code。
5、若主账号授权后子账号无法操作，需在淘宝卖家中心【子账号管理】中，为对应子账号开通“订单管理”“商品管理”“API调用”三项权限，并确保其归属店铺与聚水潭shopid一致。
