淘宝/天猫店铺数据未同步至聚水潭ERP，主因是授权未完成、应用凭证缺失或回调地址未启用；需依次完成开发者资质申请与应用创建、店铺授权、消息推送配置、字段映射校验及自动同步启用。
如果您已在聚水潭ERP系统中完成基础配置，但淘宝或天猫店铺数据仍未同步至ERP，则可能是由于授权未完成、应用凭证缺失或回调地址未启用所致。以下是实现聚水潭ERP与淘宝/天猫店铺成功对接的具体操作路径：
一、申请聚水潭开发者资质并创建应用
聚水潭开放平台要求所有对接淘系店铺的ERP调用必须基于已认证的开发者身份及合法应用凭证，APP Key与APP Secret是后续所有授权与API通信的基础凭据。
1、访问聚水潭开放平台官网：https://openweb.jushuitan.com/，使用企业主账号登录。
2、进入【开发者管理】→【入驻申请】，按提示填写完整的企业营业执照、法人信息及联系人资料，提交审核。
3、等待聚水潭平台人工审核通过（通常需1–3个工作日），审核状态可在【入驻申请记录】中实时查看。
4、审核通过后，进入【应用管理】→【创建应用】，应用类型选择电商后台，场景指定为淘宝/天猫商家后台系统。
5、填写应用名称（如“XX公司天猫对接系统”）、简要描述，回调地址可暂填https://example.com/callback（后续替换为真实地址）。
6、应用创建成功后，立即进入该应用详情页，复制并安全保存APP Key与APP Secret，二者缺一不可且不可泄露。
二、在聚水潭ERP中新增并授权淘宝/天猫店铺
该步骤在聚水潭ERP管理后台完成，核心目标是建立店铺实体、获取唯一shopid，并通过淘宝开放平台完成OAuth2.0授权，使ERP获得读取订单、库存等数据的合法权限。
1、登录聚水潭ERP系统，进入【系统设置】→【店铺管理】→【新增店铺】。
2、平台类型选择淘宝/天猫，填写店铺名称（如“旗舰店”）、店铺昵称（即淘宝/天猫卖家后台显示的店铺名）。
3、点击【保存】，系统自动生成唯一shopid，请在店铺列表中找到该店铺并复制其shopid。
4、返回店铺编辑页，点击【授权】按钮，页面将跳转至淘宝开放平台授权页。
5、使用该店铺的主账号（非子账号）扫码或输入账号密码完成授权，勾选所需权限范围（至少包含“订单查询”“物流回传”“商品信息读取”）。
6、授权成功后，页面自动返回ERP，店铺状态变为“已授权”，且可查看到系统生成的session key（无需手动填写）。
三、配置消息推送与回调地址
淘宝/天猫平台采用事件驱动机制，当订单创建、发货、退款等关键动作发生时，会主动向ERP预设的回调地址推送JSON格式消息；若地址未配置或未启用，将导致数据不同步。
1、进入聚水潭ERP【系统设置】→【消息推送】→【消息订阅配置】。
2、将回调地址更新为真实可用地址，格式须为https://您的域名/聚水潭指定路径（例如https://api.xxx.com/jst/callback）。
3、在事件订阅列表中，勾选必需事件：包括taobao.trades.sold.get（交易创建）、taobao.logistics.online.send（发货回传）、taobao.item.quantity.update（库存变更）等。
4、点击【保存】，确认配置状态显示为已启用，且测试推送能正常接收响应码200。
四、验证基础数据同步与字段映射
授权与回调仅解决通信通道问题，还需确保淘宝端字段能准确映射至ERP内部模型，否则订单无法解析、库存无法归集、客户信息错乱。
1、进入【商品管理】→【商品配对】，选择【按条码匹配】模式，点击【开始匹配】，确保各平台同款商品使用一致条码（如EAN或自定义SKU编码）。
2、进入【系统设置】→【电商对接】→【字段映射】，核对并修正以下关键映射关系：taobao_order_id → ERP单据编号、item_sku_id → ERP存货编码、receiver_mobile → ERP客户电话。
3、在【订单模块】中点击【手动同步订单】，设定时间范围（如最近1小时），执行一次拉取，观察日志是否显示“成功获取X条订单”及“解析完成”。
4、随机打开一条同步进来的订单，检查收货人、商品明细、金额、物流状态等字段是否与淘宝卖家后台完全一致。
五、启用自动同步与异常监控
生产环境需避免依赖人工触发，应通过定时任务保障数据持续流入；同时需及时识别授权过期、接口限流、签名失效等典型异常。
1、进入【系统设置】→【定时任务】→【电商同步任务】，启用淘宝订单自动同步，周期设为每5分钟执行一次。
2、启用库存自动同步任务，同步方向设为“ERP→淘宝”，确保ERP出库后实时扣减淘宝可售库存。
3、进入【系统监控】→【API调用日志】，筛选平台为“淘宝”，查看最近100条调用记录，确认无连续出现error_code:isv.permission-denied或invalid-sig等错误码。
4、检查【消息推送】→【失败重试队列】，若存在积压消息，点击【立即重试】并核查回调地址服务是否正常响应。
