聚水潭对接淘宝/天猫店铺操作指南

聚水潭与淘宝/天猫店铺的对接，是实现订单、商品、库存等核心数据自动互通的关键。本文将详细解析完整授权流程。

整个流程可以概括为：先申请聚水潭开发者资质并创建应用；接着在ERP中配置店铺与回调地址；然后触发淘宝官方授权；最后验证状态并同步数据。一环扣一环，缺一不可。

一、申请聚水潭开发者资质并创建应用

第一步是获取“通行证”。您需要在聚水潭开放平台注册为开发者，并创建应用以获取后续授权所需的核心凭证。

操作步骤如下：

• 提交入驻申请：使用企业主账号登录聚水潭开放平台官网。
• 在【开发者管理】中提交企业资料，等待人工审核通过。

审核通过后，立即创建应用：

• 关键配置：应用类型选择“电商后台”，场景指定为“淘宝/天猫商家后台系统”。
• 设置应用名称和描述。回调地址可先临时填写，后续更新。

创建成功后，请务必从应用详情页复制并保管好关键的APP Key 和 APP Secret。

二、配置聚水潭ERP中的店铺编号与回调地址

此步骤是为具体店铺在聚水潭ERP中建立档案和消息通道。

在聚水潭ERP后台【系统设置】下的【店铺管理】中新增店铺。

平台选择“淘宝/天猫”并填写信息。系统生成的唯一 shopid 需记录下来。

接下来配置消息接收地址：

• 进入【消息推送】的【消息订阅配置】。
• 粘贴真实的回调地址（格式如：https://您的域名/路径）。
• 勾选关键事件，如订单创建、状态变更、库存变动。

保存设置，并确保状态显示为“已启用”。

三、执行淘宝/天猫商家授权操作

此步骤是获取长期有效访问令牌（access_token）的关键环节。

在ERP的【对接设置】找到【商家授权】：

• 核对并确保 APP Key、APP Secret、shopid 三项参数已正确填写。
• 点击【立即授权】按钮。

系统将跳转至淘宝官方授权页。

重要提醒：必须使用淘宝店铺的主账号登录授权。

在权限列表中，请务必勾选以下核心权限：

• 订单读取
• 商品信息读取
• 物流回传

最后点击【同意授权】。授权成功后，页面将返回聚水潭ERP并显示“已授权”状态。

四、验证授权状态并同步基础数据

授权完成后，请务必验证和测试，以确保数据通道畅通。

验证步骤：

• 检查ERP【对接设置】中的【授权状态】，确认其为“有效”。
• 如状态异常，需重新授权。

数据同步测试：

• 在【商品管理】中尝试“手动同步”。观察商品、SKU、价格、库存等信息是否正常拉取。

开启订单同步功能，进行最终验证：

• 启用“实时同步订单”。
• 建议用其他账号在店铺下一笔测试单并付款。
• 观察聚水潭订单列表，确认新订单能及时出现且状态为“待发货”。

五、处理常见授权失败情形

过程遇到问题可参照以下方法排查：

情形1：提示“应用未上线”或“参数错误”

• 首要排查回调地址。请确保聚水潭应用后台填写的回调地址与ERP中的配置完全一致。
• 检查协议（http/https）、域名和路径，字符和标点均不能有差异。

情形2：提示“该账号无权操作此应用”

• 通常是账号权限问题。登录的淘宝账号需是店铺绑定主账号，或已被添加为聚水潭应用的管理员。

情形3：淘宝授权成功，但聚水潭状态仍为“未授权”

• 多为网络问题导致回调失败。请检查ERP服务器是否能正常访问淘宝授权域名（oauth.taobao.com）。
• 查看防火墙或DNS是否有拦截。

情形4：多店铺授权

• 每个淘宝/天猫店铺都需要独立授权，使用独立的shopid，授权码不能混用。

情形5：主账号授权后，子账号无法操作

• 需进入淘宝卖家中心，为相关子账号单独开通“订单管理”、“商品管理”和“API调用”等权限，且权限范围需与已授权店铺对应。