当前位置: 文档中心

三方系统接入旺店通ERP

一、背景


        淘宝开放平台于2017年已发布数据安全违规排查公告,公告地址:http://open.taobao.com/support/announcementDetail.htm?spm=a219a.7839801.0.0.xZ5mBu&id=25247

为了达到用户隐私及数据安全保护的规范要求,淘系订单数据将无法直接提供。


二、适用范围:

本方案适用于以下场景的对接指导:

  • 线上ERP-CRM场景:数云、纷享销客等客户关系管理三方软件为CRM角色,从旺店通ERP获取销售订单、售后订单等数据(含敏感数据)完成营销和数据分析等业务。

  • 线上ERP-线下ERP(财务系统)场景:线上ERP角色为旺店通ERP,用友、金蝶、SAP等三方软件为线下ERP角色,从从旺店通ERP获取销售订单、售后订单等数据(不含敏感数据)完成财务对账等业务。

  • 奇门自定义场景:旺店通在奇门定义的接标准口,可实现线上ERP-线下ERP(财务系统)场景,奇门自定义场景下的API不含淘系敏感数据,有淘宝开放平台appkey即可对接(不限appkey的标签类型)查看奇门自定义场景对接说明



三、奇门appkey申请及应用创建:

1.appkey申请准备

1.1 服务商资质:

  • 情况1:三方软件由软件厂商的代理商进行售卖及技术维护的,需代理商的公司主体企业支付宝账号注册淘宝开放平台。代理商在申请应用提交的说明书中需提供软件厂商(SAP、金蝶、用友等)的代理授权资质说明;

  • 情况2:三方软件由软件厂商直营售卖及技术支持维护的,需软件厂商公司主体企业支付宝账号注册淘宝开放平台。


1.2服务商需要提供的资料:

淘宝暂未提供模板,但提供的系统说明书需包含:MRD至少包含市场需求分析、产品功能、产品卖点以及营销策略;PRD至少包含产品功能具体描述、功能点业务流程、界面demo、系统的各功能截图(全图)、软著原件截图(厂商代理使用厂商授权的资质证明截图代替)。


1.3特殊情况:三方软件服务商或代理商无法申请appkey情况下(例如SAP无法入驻奇门),商家如果满足以下条件,可尝试按照自研系统申请对接奇门

  • 商家需满足条件:1)具备三方软件永久使用权(需合同条款证明);2)商家具备开发(运维)团队并对三方系统进行持久维护;3)承诺并承担奇门接口的后续维护查看自研软件接入流程

  • SAP、金蝶、用友这类的财务软件按照自研系统去申请奇门appkey,因与旺店通对接隶属于奇门线上ERP-线下ERP场景,所以无法获取淘系隐私数据。


2.申请第一步,注册开发者账号:(如已注册可忽略)

使用开放平台任何能力和产品首先要入驻成为开放平台开发者。

2.1 打开开放平台首页(https://open.taobao.com/),点击控制台。

2.2 网址https://open.taobao.com,进入淘宝开放平台,使用企业支付宝账号登陆并注册。再填写开发者基本信息,邮箱和手机。

2.3 完成手机验证,提交即可完成入驻。 


3.申请第二步,提交开发者信息完成本步骤后,等待淘宝小二审核,审核周期一般5~7天,已有淘宝appkey的三方软件可忽略此步骤


3.1CRM、线下ERP(SAP、金蝶、用友)等,请根据奇门应用申请说明(https://open.taobao.com/doc.htm?docId=118393&docType=1&treeId=477),提交开发者信息。

3.2应用申请页面填写时,根据自研发软件业务类型进行选择,假设自研发系统为POS,下图提交信息页面“系统类型”选择POS,“对接场景”选择OMS-POS。

3.3上传的系统产品说明书,淘宝暂未提供模板,但提供的系统说明书需包含:MRD至少包含市场需求分析、产品功能、产品卖点以及营销策略;PRD至少包含产品功能具体描述、功能点业务流程、界面demo、系统的各功能截图(全图)、软著原件截图(厂商代理使用厂商授权的资质证明截图代替)。

3.4通过奇门对接的公司名称为“北京掌上先机网络科技有限公司”


4.创建发布应用

  • 应用appkey申请通过后会有短信或邮件通知,从原申请入口进入,会出现如下创建应用页面,然后填写“APP名称”并点击创建,创建成功后跳转至淘宝应用appkey以及appsecret查看页面。

  • APP名称商家根据申请时的系统名称自定义填写。

  • 发布应用:点开放管理刷新后会显示应用,此时点击如下图“发布应用”进行应用发布,如果发布应用按钮不能点击,说明已经发布成功,忽略即可。



四、自测准备


1.1获取请求奇门接口必须参数session

如下图2应用管理->应用基本设置->基本信息填写回调URL并保存后,使用网址:https://open.taobao.com/doc.htm?docId=1&docType=17,获取session。

注:回调URL就是您放置自己应用的服务器地址或域名,比如我的应用放置在我自己的服务器上,域名是http://www.taobao.com,那这个就是我的回调地址。回调地址的作用是在用户通过淘宝授权地址登录授权后跳转至回调地址,并传递相应的参数。



1.2选择接入场景并关联角色


1.2.1如下图1路径奇门->三方互通->场景列表,旺店通为线上ERP角色,根据自身软件系统(WMS、ERP、CRM、POS)角色在场景列表,点击“接入”,进行场景选择;

1.2.2点击接入后如下图2,选择“已发布”应用,选择自身软件系统角色(WMS、ERP、CRM、POS)“选择业务角色”,填写“关联描述”,点击“申请接入”。提示关联成功后,进入自测开发环节。


注:亦可以参考淘宝开放平台“三方互通说明使用文档”,地址:https://open.taobao.com/doc.htm?spm=a219a.7386797.0.0.73b1669apYFgil&source=search&docId=109580&docType=1

五、对接奇门技术实现及自测

1.奇门自定义场景使用如下SDK进行对接

2.奇门官方场景按照奇门官方文档进行对接

奇门官方API场景接入流程:https://open.taobao.com/doc.htm?docId=106849&docType=1&treeId=477


六、申请与旺店通ERP联调

1.向旺店通开放平台申请联调--联调沟通渠道

1.1.1 如果对接的是奇门ERP-WMS场景,奇门ERP-POS场景,请联系旺店通销售协调相关资源进行联调。

1.1.2 如果是奇门ERP-CRM场景、线下ERP-线上ERP场景联调、奇门自定义场景如下发邮件申请联调,联调协助方式:点击“联系我们”查看入群方式,入群沟通联调相关事项。

商家方邮件申请:开发者对接自测完毕后,发送邮件至openapiqyb@wangdian.cn申请联调,邮件标题【xx公司申请奇门xx场景联调(卖家账号)】,例如【天津掌商先机网络科技有限公司申请奇门CRM场景联调(test2)】。

  • 公司名称:xxxx(举例:xxxx有限公司)

  • 淘宝应用appkey:xxxxx

  • 旺店通ERP卖家账号:xxxx(举例:test2)

  • 对接的场景名称:线上ERP-CRM奇门接口



2.收到邮件后,旺店通发起联调,商家同意联调,同意联调操作具体如下,请求必须参数旺店通ERPappkey:21363512,此appkey作为请求奇门接口的target_app_key。


  • 同意联调:三方互通->我的场景->线上ERP-CRM奇门接口 选择第二页最后一个接口qimen.taobao.crm.order.detail.get接入。然后点击联调,如收到申请,点击‘通过’ ,并维护上可访问的服务地址。确定保存即可

  • 联调域名:http://qimen.api.taobao.com/top/router/qmtest


七、申请上线

  • 点击“上线”进入上线配置页面

  • 点击上线申请进行线上授权申请,目前只支持部分角色发起,如果您没有该按钮,请联系旺店通方发起申请

image.png