提示:因京东平台接口限制,自 2026 年 2 月 28 日起,「聚水潭」数据源获取的京东数据中,不支持获取敏感数据(地址、密码、收件人等),相关字段值为空值。
如需获取京东平台数据,请自行与平台对接。
1. 概述
2. 获取授权信息
2.1 接口可获取的数据
1)不同接口可获取数据不同,说明见下表:
| 数据类型 | 应用类型 | 可获取的数据表 | 如何授权 |
|---|---|---|---|
| 非奇门数据 | 服务商 | 除了「淘宝」、「天猫」外,其他平台的数据 | 直接跳转到第 3 节新增连接 |
| 商家自研 | 根据 2.2 节 获取 APP Key、APP Secret、access token 和 refresh token | ||
| 服务商或商家自研 | 获取 拼多多 平台的数据 | 详情请参考第 2.4 节 | |
| 奇门自定义数据 | 服务商 | 只能获取淘宝、天猫的「订单查询、销售出入库、店铺商品资料查询、售后(退货退款)查询」数据 ———— 相关平台包括:淘宝天猫,天猫供销,考拉pop,考拉供应商直发,阿里巴巴,淘工厂,天猫超市,天猫国际直营,阿里健康直营,淘宝定制,淘宝采购,淘宝买菜,银泰喵街 ———— 两种应用类型区别:
| 1)根据 2.3 节获取 customer_id 2)根据第 3 节新增连接(使用服务商模式) 3)请联系我方销售获取奇门资质信息 |
| 商家自研 | 1)请自行申请 奇门资质 2)根据 2.3 节获取 customer_id 3)根据第 3 节新增连接(使用商家自研模式) |
2.2 非奇门数据获取授权信息
注:在非奇门数据商家自研模式下,需要登录聚水潭后台,进入「管理应用 > IP 白名单」处,将以下 IP 地址粘贴到 IP 白名单中:**47.110.75.116;221.22872.3**
1)在非奇门数据商家自研模式下,商户需要注册开放平台账号 并创建应用。应用创建后可在「基本信息」中查看 APP Key 和 APP Secret。

2)应用审核通过后,可调用聚水潭接口获取 access_token 和 refresh_token。
正式环境的接口地址为 https://openapi.jushuitan.com/openWeb/auth/getInitToken,请求方式为 POST,需通过代码调用,不能直接在浏览器中打开。sign 签名可以使用授权签名工具 辅助生成。
注:初始令牌自授权后有效期为 30 天。请在访问令牌到期前 12 小时内,调用 更新令牌接口 获取新的访问令牌。更新成功后,原 access_token 仍可使用 5 分钟,5 分钟后失效。如令牌过期前未更新,需重新授权。
2.3 奇门自定义数据获取 customer_id
1)登录 聚水潭平台,依次点击「设置>基础设置>(业务设置)基础设置」。如下图所示:

2)点击左侧的「开放平台」,选择「奇门自定义场景授权&配置」。如下图所示:

3)根据实际情况填写奇门 appkey:
如您选择「奇门自定义-服务商」类型,提交上线申请需要我方的奇门 appkey,可联系我方销售获取。接口类型可选择「销售出库单、售后单」;
如您选择「奇门自定义-商家自研」类型,请在此填写您自己的奇门 appkey。

4)成功上线后会显示「申请成功」,就可以获取到 customerId ,也就是我们需要的授权信息。如下图所示:

2.4 拼多多数据获取授权
目前仅聚水潭非奇门数据连接支持返回拼多多数据,按照应用类型不同,开通方式如下:
2.4.1 服务商(ISV)类型
使用的服务商提供的 appkey,即帆软的 appkey:ae93430bdbfe4c12933dafe56fb00131。
联系聚水潭,在聚水潭后台为该 App Key 开通白名单。开通后,将已有的非奇门服务商数据连接重新授权,即可通过接口获取拼多多数据。

2.4.2 商家自研类型
1)在 拼多多开放平台 申请方舟自建应用,应用状态需为「已上线」,且应用类型属于 「商家后台系统、虚拟商家后台系统、国际商家自建仓系统、电子凭证商家后台系统」 四者之一。在「控制台 > 应用信息 > 基础信息」处,查看 client_id 和 client_secret。

2)点击进入拼多多开放平台「三方互通>标准场景」,选择需接入的自研系统应用,点击「接入」按钮,确认提交后完成申请。切换至「已接入场景」标签页,若页面显示对应系统应用,即表示该系统已成功接入场景。

3)在聚水潭注册开放平台账号并创建应用,在「基本信息」中获取 App Key 和 App Secret。

4)联系聚水潭销售人员或实施人员,为 Client ID 和 App Key 开通白名单。
5)在「三方互通>已接入场景」中点击自研系统应用对应的「接口管理」,选择 「查看可调用 api」标签页。查看接口文档,依据文档定义完成调用端开发(作为接口调用方,需确保请求参数符合接口要求)。开发完成后,点击「联调」。
注1:在「应用详情—授权管理」页面配置拼多多店铺账号(pdd开头,可在店铺后台右上角「账号管理」中查看),再通过接口 授权 获取店铺 access_token 和 refresh_token。
注2:联调验证:平台网关将请求转发至 ERP 系统配置的后端地址,调用方需与对接的 ERP 服务商确认两项内容:请求是否准确送达对方后端;是否能正常接收对方返回的响应参数。两项均正常则联调通过。

3. 连接「聚水潭」数据源
1)进入数据连接市场,新增「聚水潭」数据源。如下图所示:

2)配置说明如下:
| 配置 | 说明 | |
|---|---|---|
| 名称 | 自定义一个名称,方便之后区分 | |
聚水潭非奇门数据 | 服务商(ISV) | 登录聚水潭授权,见本文 3.1.1 节 |
| 商家自研 | 需要填写如下信息:
见本文 3.1.2 节 | |
| 获取拼多多平台数据请按照第 2.4 节获取的信息填写 | ||
| 聚水潭奇门自定义数据 | 服务商(ISV) | 需要填写如下信息:
见本文 3.2 节 |
| 商家自研 | 需要填写如下信息:
见本文 3.2 节 | |
| 自定义表 | 支持通过「自定义表」功能修改 部分全量表 的取数开始时间
增量表可通过 同步指定范围 修改取数开始时间 | |
3.1 类型一:非奇门数据
3.1.1 服务商类型
1)数据类型选择「聚水潭非奇门数据」,选择「服务商(ISV)」应用类型,「点击授权」后进入授权页面。如下图所示:

2)此时会跳转到服务授权页面,这里填写商家聚水潭ERP主账号的账号密码,不要用开放平台账号登录,如下图所示:

3)若希望同步主仓+所有分仓的数据,在「选择分仓」设置中,不要选择任何一项。选择好授权有效期后,点击「同意授权」,将聚水潭账号的信息授权给帆软软件有限公司,点击「确定授权」,如下图所示:

4)授权成功后会出现以下页面:

5)回到产品中,看到已完成提示表示授权成功,点击「确定」。如下图所示:

3.1.2 商家自研类型
数据类型选择「聚水潭非奇门数据」,选择「商家自研」应用类型。在页面中添加相关信息,如下图所示:

3.2 类型二:奇门自定义数据
若选择「奇门自定义数据」,请根据自身实际情况填写信息。填写完,点击「下一步」。如下图所示:

3.3 选表
1)左侧列表中为可以选择添加的数据表,点击「查看」可以查看各表字段信息。勾选需要添加的数据表,点击「>」添加表。如下图所示:

2)添加好数据表后,点击「确认」。如下图所示:

3)在左侧就获取到了数据列表。如下图所示:

4. 同步数据
1)此时还没有数据,点击「同步数据源」将全部数据同步一次,先获取数据。如下图所示:

2)之后可以根据自己的实际需求,对单表或者多表进行同步。建议减少同步整个数据源次数,以避免不必要的等待时间。详情参见文档:同步数据
5. 数据源协作
6. 使用数据
获取到数据后,需要将数据添加至「分析空间」模块的项目中,进一步地分析。详情参见:将数据添加进项目中
