自研系统&三方系统接入奇门自定义场景

注："奇门自定义API"与"旺店通开放平台标准API"可实现的业务场景是相同的，如需要从旺店通ERP获取淘系非敏感数据的，可通过奇门自定义接口实现。

一、 奇门自定义API对接背景说明

1.1  国家在2017年6月1号正式实施《网络安全法》，法规明确网络运营者保障消费者数据的责任和义务。（阿里生态的合作伙伴，商家都属于网络运营者）
1.2  淘宝开放平台2017年5月18号发布数据安全违规排查公告，将于2017年6月1号开始做排查。公告地址：http://open.taobao.com/support/announcementDetail.htm?spm=a219a.7839801.0.0.xZ5mBu&id=25247
1.3  为了达到用户隐私数据安全保护的规范要求，奇门自定义中涉及到的用户隐私的字段数据将无法提供。

隐私字段列表

二、申请奇门appkey及创建应用

1.1 自研系统：商家自研发系统，参考“自研系统接入”流程申请appkey,“查看详情”。

1.2 三方系统：线下ERP（SAP、金蝶、用友等）、线下CRM，线下POS、WMS参考“三方系统接入”流程申请appkey,“查看详情”。

1.3 其他业务系统：自研及上述三方系统以外的系统，参考淘宝开放平台新手指南申请appkey，https://open.taobao.com/doc.htm?docId=118395&docType=1

注：只要拥有任意应用类型的淘宝开放平台appkey都可以对接奇门自定义场景下的API，奇门自定义场景接口可以返回旺店通系统内所有平台订单数据（已加密平台敏感信息不返回）

三、奇门自定义API对接实现

1.1  奇门介绍

• 奇门只是一个数据传输的通道，卖家只需要与奇门对接，将请求发送给奇门。奇门通过卖家请求参数中的目标appkey：target_app_key来锁定卖家目标请求的是旺店通，因此请求到旺店通接口，旺店通再通过奇门将数据返回给卖家。

• 针对原始形式的接口，如果客户需要对接三个系统，那么需要开发三套对接逻辑。改造成奇门接口之后，只要开发一套对接奇门的逻辑，改变参数target_app_key就可以对接任意系统。（前提是，该系统支持奇门对接）。

  
  

1.2 数据传输描述：

1.3旺店通对商家（服务商）奇门appkey授权，方式如下，授权后可开始进行测试开发

1.3.1 奇门自定义场景如下步骤申请联调，联调协助方式：点击“联系我们”查看入群方式，入群沟通联调相关事项：

     商家方登录开放平台：在“自助对接”—“奇门自助指南”中，根据指引步骤进行联调申请操作：

1.3.2 收到联调通过邮件回复授权结果，并附带旺店通appkey（奇门API请求必传参数target_app_key）

1.4 测试开发

• SDK下载（含使用说明）：奇门自定义sdk

• 测试开发过程问题解决：点击“联系我们”查看入群方式，入群沟通相关问题。

• 奇门自定义API与旺店通标准API参数对比说明。

请求地址：

 接口名：

 公共参数：

业务参数：

与旺店通标准API相同,可通过下述1.5奇门API与旺店通标准API对应关系，查看准确业务参数。查看旺店通标准API

 响应参数：

1.5奇门自定义API列表

四、上线

• 将测试环境地址：http://hu3cgwt0tc.api.taobao.com/router/qmtest变更为正式环境地址：http://hu3cgwt0tc.api.taobao.com/router/qm