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 | 紫 |