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

注：对接奇门自定义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 如果是奇门ERP-CRM场景、奇门自定义场景如下步骤申请联调

1.3.1 申请步骤：奇门场景申请联调，点击查看奇门自助指南（https://open.wangdian.cn/qjb/open/abut/zzzn_qimen）

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

1.4 测试开发

• SDK下载（含使用说明）：淘宝SDK及使用说明

• 测试开发过程问题解决：联调时会有相应联调群，问题在群中处理
  

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

请求地址：

 接口名：

奇门公共参数：

旺店通公共参数：

业务参数请求参数：

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

 响应参数：

1.5奇门自定义API列表

四、上线

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