1. 概述
1.1 应用场景
用户计划深入分析旺店通平台中的数据，更好的了解业务数据，为未来的决策提供有力支撑。
1.2 功能简介
本产品支持直接与旺店通平台对接获取相关数据，且获取的数据报告类型在不断的丰富中。
1.3 注意事项
「旺店通（网页版）」数据源为 Alpha版本，可能存在一些不稳定因素。诚邀您 参与共创，帮助数据源团队改进和完善功能。
如您愿意参与共创，可填写 表单 ，数据源团队将主动和您联系并协助配置。
2. 收集连接信息
在配置旺店通（网页版）数据连接之前，需要先获取以下信息：
支持连接两种应用：旺店通自定义应用、奇门自定义应用。两种应用都需要前往旺店通平台进行创建，创建后再申请上线。
| 旺店通自定义应用 | 奇门自定义应用 | |
|---|---|---|
| 注意事项 | 1）「奇门自定义应用」获取的数据类型比「旺店通自定义应用」多一个淘宝数据，若有淘宝店铺的商家请选择「奇门自定义应用」 2）若两种应用下的数据用户都需要获取，请重复点击「新增数据连接」创建两个主连接分别获取奇门、非奇门的数据。实现效果见本文第 3.5 节 | |
| 需要的信息 |
在开放平台中，按照 2.1、2.2 节创建「旺店通自定义对接应用」获取接口数据，在应用上线后获取这三个信息。 |
在开放平台中，按照 2.1 、2.3 节创建「奇门自定义对接应用」获取接口数据； 奇门资质： ● 如果用户有自己的奇门资质，在申请上线时可以填写自己的奇门资质信息。 ● 如果自己没有奇门资质，可使用帆软的奇门资质。请联系帆软销售获取奇门信息。 |
2.1 登录旺店通网页版平台
1）进入旺店通 开放平台，选择「接入旺店通网页版」，如下图所示：
2）输入旺店通账号的相关信息登录开放平台。若没有账号，请先注册一下账号。如下图所示：
2.2 方式一：自定义对接
1）若没有淘宝店铺的数据，创建应用可以选择「旺店通自定义对接」，如下图所示：
2）填写相关信息，选择所需对接的接口，建议第一次授权时就选择全部接口，填写完成后，点击确定，如下图所示：
注 1：其中，基础类接口是我方校验连通性的依据，请一定要勾选！！！否则会导致添加连接后，状态为「未授权」。
注 2：如果在最初授权时没有选择全部接口，后续获取数据没有接口权限时，需要回到这里再次勾选权限，且勾选后还需带着 sid （卖家账号）去找旺店通人员审核。每增加一次接口权限，都需要审核一次。因此，建议第一次授权时就选择全部接口。
| 展开查看基础类接口 |
下图中的基础类接口请一定要勾选！！！！！！！！
|
3）创建完成后，在左侧功能栏点击「正式授权管理」可查看已创建的应用。需要申请应用上线，点击确认后需联咨询旺店通商务人员审核应用上线，请确保审核通过。
| 卖家账号查看 |
「卖家账号」： 可在「自助对接>用户中心>开发者信息」中查看，如下图所示：
|
4）进入应用管理界面。应用上线后，应用状态为「已上线」。可以查看到「卖家账号」、「接口账号」、「接口密钥」这三个信息，如下图所示：
2.3 方式二：奇门自定义对接
1）若有淘宝店铺数据的商家，创建应用需要选择「奇门自定义对接」，如下图所示：
2）填写相关信息，选择所需对接的接口，建议第一次授权时就选择全部接口，填写完成后，点击确定，如下图所示：
注 1：其中，基础类接口是我方校验连通性的依据，请一定要勾选！！！否则会导致添加连接后，状态为「未授权」。
注 2：如果在最初授权时没有选择全部接口，后续获取数据没有接口权限时，需要回到这里再次勾选权限，且勾选后还需带着 sid （卖家账号）去找旺店通人员审核。每增加一次接口权限，都需要审核一次。因此，建议第一次授权时就选择全部接口。
| 展开查看基础接口 |
下图中的基础类接口请一定要勾选！！！！！！！！
|
3）创建完成后，在左侧功能栏点击「应用管理」可查看已创建的应用。需要申请应用上线，点击确认后需联咨询旺店通商务人员审核应用上线，请确保审核通过。
| 卖家账号&奇门appkey |
「卖家账号」： 在「自助对接>用户中心>开发者信息」中查看。
奇门appkey： ● 如果用户有自己的奇门资质，在申请上线时可以填写自己的奇门appkey。 ● 如果自己没有奇门资质，可使用我方奇门资质，请联系我方销售获取 奇门appkey。 |
4）进入应用管理界面。应用上线后，应用状态为「已上线」。可以查看到「卖家账号」、「接口账号」、「接口密钥」这三个信息，如下图所示：
3. 连接「旺店通（网页版）」数据源
1）进入数据连接市场，新增「旺店通（网页版）」数据源。如下图所示：
2）填写相关信息，说明如下表所示：
支持连接两种应用：旺店通自定义应用、奇门自定义应用。两种应用都需要前往旺店通平台进行创建，创建后再申请上线。
| 旺店通自定义应用 | 奇门自定义应用 | |
|---|---|---|
| 注意事项 | 1）「奇门自定义应用」获取的数据类型比「旺店通自定义应用」多一个淘宝数据，若有淘宝店铺的商家请选择「奇门自定义应用」 2）若两种应用下的数据用户都需要获取，请重复点击「新增数据连接」创建两个主连接分别获取奇门、非奇门的数据，即重复 1）步骤新建数据连接。 | |
| 需要的信息 |
在开放平台中，按照 2.1 、2.2 节创建「旺店通自定义对接应用」获取接口数据，在应用上线后获取这三个信息； |
在开放平台中，按照 2.1、2.3 节创建「奇门自定义对接应用」获取接口数据； |
3）左侧列表为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表。
若用户希望自动获取新增的表，可在选表界面开启「新增表自动勾选」。
4）添加好数据表后，点击「确认」。如下图所示：
5）在左侧就获取到了数据列表。如下图所示：
4. 同步数据
4.1 同步操作
1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：
2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据
4.2 同步失败
问题描述：
若同步数据时，同步失败，提示如下。或同步数据成功，但是同步数据为空。
解决方案：
接口账号（appkey）是有权限校验的，同步失败或同步数据为空表示缺少对应权限。订单类的表需要：店铺权限、仓库权限、供应商权限。
在您的旺店通系统上进行对应权限的配置，接口账户 appkey 的值就是员工编号。
在 ERP 内设置->安全设置->员工权限页面搜索对应员工编号，找到接口用户在下方 tab 页可以设置或者查看接口用户的仓库、店铺等权限。
详情请咨询旺店通技术支持人员。
5. 数据源协作
6. 使用数据
获取到数据后，需要将数据添加至「分析空间」模块的项目中，进一步地分析。详情参见：将数据添加进项目中
6. 常见问题
6.1 权限不足
若某张表同步时提示：权限不足，请按照以下步骤检查：
1）非订单类接口，请自行进入开放平台，变更已有应用并开通相关权限。（订单类接口请看 2.3 节）
2）「订单查询接口」请用户先联系旺店通平台，发送 sid、appKey 信息开通接口权限。（订单类接口请看 2.3 节）
3）若上述接口全部开通，但同步仍报错：权限不足。请先将 sid 信息发送给技术支持，等待处理后再联系旺店通平台开通权限。
