当前位置: 文档中心

查询淘系订单接入说明

一、背景

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

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


二、商家自研软件通过奇门对接旺店通ERP流程如下:


对接过程如有疑问进钉钉群:奇门云网关技术支持群(1群:11746343(已满)、2群 : 21771580(已满)、3群:23396781)


步骤1.注册淘宝开放平台开发者:


步骤2.申请淘宝应用标签以及appkey(完成本步骤后,等待淘宝小二审核)

注:申请下来的应用标签为“奇门-商家自研线下系统”可充当WMS、POS、CRM角色对接奇门ERP-CRM场景、奇门ERP-POS场景、奇门ERP-WMS场景,获取淘系订单数据(含敏感字段)

  • 上传的系统产品说明书模板:系统功能说明书.docx,模板中所有项为必填,系统说明书需要说明软著情况,如没有需先申请软著,再申请appkey。

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



步骤3.创建发布应用

  • 创建应用:如下图进入开放管理->应用管理,点击“创建应用”,然后填写“APP名称”并点击创建,创建成功后跳转至淘宝应用appkey以及appsecret查看页面。

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

步骤4.获取请求奇门接口必须参数session

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

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


步骤5.选择接入场景并关联角色

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

  • 如下图1,路径云工作台->奇门API网关,点击“奇门API网关”跳转至奇门中心;

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

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



步骤6:技术实现(自测以及对接奇门接口)

奇门SDK使用说明:https://open.taobao.com/doc.htm?docId=101618&docType=1&treeId=477


步骤7:向旺店通开放平台申请联调

注:如果对接的是奇门ERP-WMS场景,奇门ERP-POS场景,请联系旺店通实施申请联调,奇门ERP-CRM场景如下发邮件申请。

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

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

  • 淘宝应用appkey:xxxxx

  • 申请应用的主店铺名称:xxxx(举例:xxxx期间店)

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

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

2)邮件回复内容:旺店通已经申请联调,按照如下步骤进行联调。旺店通ERPappkey:xxxxx,此appkey作为请求奇门接口的target_app_key。

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

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


步骤8:上线

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

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

image.png


注:商家购买的第三方软件通过奇门对接旺店通ERP流程,请软件服务商自行联系淘宝开放平台解决。发起联调时所需旺店通ERP的appkey为21363512,联调发起后邮件通知到openapiqyb@wangdian.cn。