1. 概述
1.1 应用场景
用户计划深入分析聚水潭平台中的数据，更好的了解业务数据，为未来的决策提供有力支撑。
1.2 功能简介
本产品支持直接与聚水潭平台对接获取相关数据，且获取的数据报告类型在不断的丰富中。
1.3 数据范围
本产品支持获取的数据范围：授权之日起，前 3 个月内的数据。如您有其他需求，可联系技术支持。
1.4 注意事项
1）「聚水潭」为付费数据源，请管理员开通试用或者购买「聚水潭」数据源。
| 如何开通试用/购买数据源 |
超管或管理员，点击「企业设置>版本信息」，即可试用/购买数据源。如下图所示：
|
2）由于聚水潭接口限制，通过 ISV 授权请求奇门自定义数据的「订单查询」和「店铺商品资料查询」表会同步失败。
对于 2024-09-05 之前授权的用户，下表中的奇门数据只支持使用到 2025-2-27。
对于 2024-09-05 之后授权的用户，下表中的奇门数据无法获取，表现为同步失败。
| 分组 | 表名 |
|---|---|
| 【订单类】 | 订单查询-订单主表 订单查询-订单商品信息 订单查询-订单支付信息 |
| 【商品类】 | 店铺商品资料查询 |
| 【售后类】 | 售后（退货退款）查询 |
2. 获取授权信息
2.1 接口可获取的数据
1）不同接口可获取数据不同，说明见下表：
| 数据类型 | 应用类型 | 可获取的数据表 | 如何授权 |
|---|---|---|---|
| 聚水潭数据 | - | 仅能获取自有商城店铺、跨境线下店铺的订单数据 | 直接跳转到第 3 节新增连接 |
| 服务商 | 淘系、京东等线上订单数据无法获取，可获取所有平台出库类、聚工单等数据 | 1）根据 2.2 节获取 customer_id 2）根据第 3 节新增连接（使用服务商模式） | |
| 奇门自定义数据 | 商家自研 | 可以获取所有平台的订单数据 | 1）请自行申请 奇门资质 2）根据 2.2 节获取 customer_id 3）根据第 3 节新增连接（使用商家自研模式） |
2.2 获取 customer_id
想要获取所有平台的数据需要选择「奇门自定义数据」，并获取 customer_id 才可以授权，请根据接下来的步骤获取信息。
1）登录 聚水潭平台，依次点击「设置>基础设置>（业务设置）基础设置」。如下图所示：
2）点击左侧的「开放平台」，选择「奇门自定义场景授权&配置」。如下图所示：
3）根据实际情况填写奇门 appkey：
如您选择「奇门自定义-服务商」类型，提交上线申请需要我方的奇门 appkey，可联系我方销售获取。接口类型可选择「销售出库单、售后单」；
如您选择「奇门自定义-商家自研」类型，请在此填写您自己的奇门 appkey。
4）成功上线后会显示「申请成功」，就可以获取到 customerId ，也就是我们需要的授权信息。如下图所示：
3. 连接「聚水潭」数据源
1）进入数据连接市场，新增「聚水潭」数据源。如下图所示：
2）配置说明如下：
| 配置 | 说明 | |
|---|---|---|
| 名称 | 自定义一个名称，方便之后区分 | |
聚水潭数据 | 聚水潭 | 登录聚水潭授权，见本文 3.1 节 |
| 奇门自定义数据 | 服务商(ISV) | 需要填写如下信息：
见本文 3.2 节 |
| 商家自研 | 需要填写如下信息：
见本文 3.2 节 | |
3.1 类型一：聚水潭数据
1）数据类型选择「聚水潭数据」，「点击授权」后进入授权页面。如下图所示：
2）此时会跳转到服务授权页面，这里填写商家聚水潭ERP主账号的账号密码，不要用开放平台账号登录，如下图所示：
3）若希望同步主仓+所有分仓的数据，在「选择分仓」设置中，不要选择任何一项。选择好授权有效期后，点击「同意授权」，将
聚水潭账号的信息授权给帆软软件有限公司，点击「确定授权」，如下图所示：
4）授权成功后会出现以下页面：
5）回到产品中，看到已完成提示表示授权成功，点击「确定」。如下图所示：
3.2 类型二：奇门自定义数据
若选择「奇门自定义数据」，请根据自身实际情况填写信息。填写完，点击「下一步」。如下图所示：
3.3 选表
1）左侧列表中为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表。如下图所示：
2）添加好数据表后，点击「确认」。如下图所示：
3）在左侧就获取到了数据列表。如下图所示：
4. 同步数据
1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：
2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据
5. 数据源协作
6. 使用数据
获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。
