1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.8.1 | - |
1.2 功能说明
FineDataLink 支持连接聚水潭数据源，支持：定时管道任务读取。
1.3 使用限制
1）「聚水潭」数据连接支持获取的表及字段信息见：平台/表/字段
2）仅当用户注册了「应用系统（云端）」功能点，且「应用系统（云端）-类型数」大于 0 时，才支持使用此数据源。详情参见文档：注册简介
3）因拼多多平台接口限制，自 2025 年 8 月 20 日起，「聚水潭」数据源不再支持获取 拼多多 数据，其他平台的数据可正常获取。
4）工程所在服务器需具备访问外网权限，或者可以配置白名单：
域名白名单：dm.shukuajing.com
IP白名单：47.110.75.116
1.4 注意事项
聚水潭奇门自定义数据只能获取「淘宝、天猫」的「订单查询、销售出入库、店铺商品资料查询、售后（退货退款）查询」数据；
除了「淘宝」、「天猫」、「拼多多」外，其他平台的数据请通过非奇门对接；
由于平台接口限制，「拼多多」平台的数据无法通过任何聚水潭接口获取，请自行对接。
2. 收集连接信息
2.1 接口可获取的数据
1）不同接口可获取数据不同，说明见下表：
| 数据类型 | 应用类型 | 可获取的数据表 | 如何授权 |
|---|---|---|---|
| 聚水潭数据 | - | 仅能获取自有商城店铺、跨境线下店铺的订单数据 | 直接跳转到第 3 节配置连接 |
| 奇门自定义数据 | 服务商 | 淘系、京东等线上订单数据无法获取，可获取所有平台出库类、聚工单等数据 | 1）根据 2.2 节获取 customer_id 2）根据第 3 节配置连接（使用服务商模式） 3）请联系我方销售获取奇门资质信息 |
| 商家自研 | 可以获取所有平台的订单数据 | 1）请自行申请 奇门资质 2）根据 2.2 节获取 customer_id 3）根据第 3 节配置连接（使用商家自研模式） |
2.2 获取 customer_id
想要获取所有平台的数据需要选择「奇门自定义数据」，并获取 customer_id 才可以授权，请根据接下来的步骤获取信息。
1）登录 聚水潭平台，依次点击「设置>基础设置>（业务设置）基础设置」。如下图所示：
2）点击左侧的「开放平台」，选择「奇门自定义场景授权&配置」。如下图所示：
3）根据实际情况填写奇门 appkey：
如您选择「奇门自定义-服务商」类型，提交上线申请需要我方的奇门 appkey，可联系我方销售获取。接口类型可选择「销售出库单、售后单」；
如您选择「奇门自定义-商家自研」类型，请在此填写您自己的奇门 appkey。
4）成功上线后会显示「申请成功」，就可以获取到 customerId ，也就是我们需要的授权信息。如下图所示：
3. 配置连接
3.1 前提条件
详情请参见：前提条件
3.2 驱动准备
下载驱动：
若 FineDataLink 为独立部署的工程，将驱动文件放置到 %FineDataLink%/webroot/web-inf/lib 下；放置后，需要重启 FDL 工程。
若 FineDataLink 为 OPS 部署的工程，将驱动文件上传至 FineDataLink 工程外挂目录的 customlib 文件夹下
如忘记工程外挂目录位置，请参考文档查询：导出项目部署信息；放置后，需要重启 FDL 工程。
注：如需获取驱动文件，请联系技术支持。
3.3 具体连接步骤
1）创建数据连接步骤请参见：创建并管理数据
2）在页面中填写相关信息，说明如下表所示：
| 配置 | 说明 | |
|---|---|---|
聚水潭数据 | 聚水潭 | 登录聚水潭授权，见本文 3.3 节 |
| 奇门自定义数据 | 服务商(ISV) | 需要填写如下信息：
见本文 3.4节 |
| 商家自研 | 需要填写如下信息：
见本文 3.4 节 | |
| 自定义表 | 对于某些数据源的某些表有着特殊的请求参数，必须用户传入。针对这些表，可以通过新增自定义表实现配置。 支持新增自定义表、以及表的取数开始时间。
| |
3.4 类型一：聚水潭数据
1）数据类型选择「聚水潭数据」，「点击授权」后进入授权页面。如下图所示：
2）此时会跳转到服务授权页面，这里填写 商家聚水潭 ERP 主账号的账号密码，不要用开放平台账号登录，如下图所示：
3）若希望同步主仓+所有分仓的数据，在「选择分仓」设置中，不要选择任何一项。选择好授权有效期后，点击「同意授权」，将
聚水潭账号的信息授权给帆软软件有限公司，点击「确定授权」，如下图所示：
4）授权成功后会出现以下页面：
5）看到「已完成」提示表示授权成功。如下图所示：
3.5 类型二：奇门自定义数据
若选择「奇门自定义数据」，请选择应用类型：
服务商：需填写 customer_id ；
商家自研：需填写 customer_id、奇门appkey、奇门appsecret；
4. 使用数据源
4.1 定时管道任务读取
定时管道任务的数据来源支持：聚水潭，详情参见文档：定时管道概述
上一篇：配置吉客云数据源
