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