1. 概述
1.1 应用场景
用户计划深入分析旺店通平台中的数据，更好的了解业务数据，为未来的决策提供有力支撑。
1.2 功能简介
本产品支持直接与旺店通平台对接获取相关数据，且获取的数据报告类型在不断的丰富中。
1.3 数据范围
第一次更新 可以获取到第一次更新时间往前推近 3 个月数据，再次更新 可以获取上次更新到这次更新之间的数据，如您有其他需求，可联系技术支持。
1.4 注意事项
1）旗舰版和企业版的区别：例如用户名、手机号这类的隐私字段，企业版是返回加密后的数据；而旗舰版中，仅线下平台和自有平台可以返回，其他平台的隐私字段是无法获取到的，返回的是空值。旗舰版的授权过程请参见文档：旺店通（旗舰版）
2）「旺店通（企业版）」为付费数据源，请管理员开通试用或者购买该数据源。
| 如何开通试用/购买数据源 |
超管或管理员，点击「企业设置>版本信息」，即可试用/购买数据源。如下图所示：
|
2. 连接「旺店通（企业版）」数据源
2.1 新增「旺店通（企业版）」数据源
1）进入数据连接市场，新增「旺店通（企业版）」数据源。如下图所示：
2）填写相关信息，说明如下表所示：
支持连接两种应用：旺店通自定义应用、奇门自定义应用。两种应用都需要前往旺店通平台进行创建，创建后再申请上线。
| 旺店通自定义应用 | 奇门自定义应用 | |
|---|---|---|
| 注意事项 | 1）「奇门自定义应用」获取的数据类型比「旺店通自定义应用」多一个淘宝数据，若有淘宝店铺的商家请选择「奇门自定义应用」 2）若两种应用下的数据用户都需要获取，请重复点击「新增数据连接」创建两个主连接分别获取奇门、非奇门的数据。实现效果见本文第 3.5 节 | |
| 需要的信息 |
在开放平台中，按照 3.2 、3.3 节创建「旺店通自定义对接应用」获取接口数据，在应用上线后获取这三个信息； |
在开放平台中，按照 3.2 、3.4 节创建「奇门自定义对接应用」获取接口数据； |
3.2 接入旺店通企业版平台
1）进入旺店通 企业版开放平台，选择「接入旺店通企业版」，如下图所示：
2）输入旺店通旗舰版账号的相关信息登录开放平台。若没有账号，请先注册一下账号。如下图所示：
2.3 方式一：自定义对接
1）若没有淘宝店铺的数据，创建应用可以选择「旺店通自定义对接」，如下图所示：
2）填写相关信息，选择所需对接的接口，建议第一次授权时就选择全部接口，填写完成后，点击确定，如下图所示：
注 1：其中，基础类接口是我方校验连通性的依据，请一定要勾选！！！否则会导致添加连接后，状态为「未授权」。
注 2：如果在最初授权时没有选择全部接口，后续获取数据没有接口权限时，需要回到这里再次勾选权限，且勾选后还需带着 sid （卖家账号）去找旺店通人员审核。每增加一次接口权限，都需要审核一次。因此，建议第一次授权时就选择全部接口。
| 展开查看基础类接口 |
下图中的基础类接口请一定要勾选！！！！！！！！
|
3）创建完成后，在左侧功能栏点击「应用管理」可查看已创建的应用。需要申请应用上线，点击确认后需联咨询旺店通商务人员审核应用上线，请确保审核通过。
| 卖家账号查看 |
「卖家账号」为登录旺店通企业版的账号，可在「自助对接>用户中心>开发者信息」中查看，如下图所示：
|
4）进入应用管理界面。应用上线后，应用状态为「已上线」。可以查看到「卖家账号」、「接口账号」、「接口密钥」这三个信息，如下图所示：
5）回到产品中，填写上面获取的三个信息，点击「确认」即可完成授权，如下图所示：
2.4 方式二：奇门自定义对接
1）若有淘宝店铺数据的商家，创建应用需要选择「奇门自定义对接」，如下图所示：
2）填写相关信息，选择所需对接的接口，建议第一次授权时就选择全部接口，填写完成后，点击确定，如下图所示：
注 1：其中，基础类接口是我方校验连通性的依据，请一定要勾选！！！否则会导致添加连接后，状态为「未授权」。
注 2：如果在最初授权时没有选择全部接口，后续获取数据没有接口权限时，需要回到这里再次勾选权限，且勾选后还需带着 sid （卖家账号）去找旺店通人员审核。每增加一次接口权限，都需要审核一次。因此，建议第一次授权时就选择全部接口。
| 展开查看基础接口 |
下图中的基础类接口请一定要勾选！！！！！！！！
|
3）创建完成后，在左侧功能栏点击「应用管理」可查看已创建的应用。需要申请应用上线，点击确认后需联咨询旺店通商务人员审核应用上线，请确保审核通过。
| 卖家账号&奇门appkey |
「卖家账号」： 为登录旺店通企业版的账号，可在「自助对接>用户中心>开发者信息」中查看。
奇门appkey： ● 如果用户有自己的奇门资质，在申请上线时可以填写自己的奇门appkey。 ● 如果自己没有奇门资质，可使用我方奇门资质，请联系我方销售获取 奇门appkey。 |
4）进入应用管理界面。应用上线后，应用状态为「已上线」。可以查看到「卖家账号」、「接口账号」、「接口密钥」这三个信息，如下图所示：
5）应用上线后，回到产品中，应用类型选择「奇门自定义应用」。
| 卖家账号 | 填写 3.4 节 4）中获取的信息 | ||
| 奇门资质 | 与申请应用上线时使用的奇门资质保持一致：
|
填写相关信息后点击「确认」即可完成授权，如下图所示：
2.5 注意事项
如果用户需要获取「旺店通自定义应用」和「奇门自定义应用」两种应用下的数据，请点击「新增数据连接」创建两个主连接分别获取奇门、非奇门的数据。如下图所示：
3. 同步数据
3.1 同步操作
1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：
2）特别说明库存类节点下的「全量查询库存」这张数据表，需在凌晨 0-2 点进行更新，且可能存在数据量太大导致更新失败。请对该表设置定时同步，每天 1 点更新。如果同步失败，第二天会继续同步。如下图所示：
3.2 同步失败
1）若同步数据时，同步失败，且提示如下：
2）接口账号（appkey）是有权限校验的，同步失败表示您缺少相应的权限。
解决方案：
在您的旺店通系统上进行对应权限的配置，接口账户 appkey 的值就是员工编号。
在 ERP 内设置->安全设置->员工权限页面搜索对应员工编号，找到接口用户在下方 tab 页可以设置或者查看接口用户的仓库、店铺等权限。
详情请咨询旺店通技术支持人员。
4. 数据源协作
5. 使用数据
获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。
6. 其他说明
在「查询订单管理」中有一个「标旗字段」，其字段值含义如下表所示：
| 字段值 | 含义 |
|---|---|
| 0 | 灰 |
| 1 | 红 |
| 2 | 黄 |
| 3 | 绿 |
| 4 | 蓝 |
| 5 | 紫 |
