商家自研系统接入旺店通ERP

一、背景

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

1.1 商家自研系统的软件著作权，著作权所属公司主体要和申请appkey店铺公司主体相同。

1.2 确认商家自研系统与旺店通ERP的对接场景：可对接的场景有奇门官方场景（见下图）、奇门自定义场景（查看奇门自定义场景对接说明）

2.申请第一步，注册开发者账号：

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

2.1 打开开放平台首页（https://open.taobao.com/），点击控制台。

2.2 使用天猫主账号登陆，账号必须完成支付宝账号绑定。再填写开发者基本信息，邮箱和手机。

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

3.申请第二步，提交开发者信息（完成本步骤后，等待淘宝小二审核,审核周期一般5~7天）

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

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

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

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

4.创建发布应用

4.1创建应用：如下图进入开放管理->应用管理，点击“创建应用”，然后填写“APP名称”（APP名称根据自研系统业务自定义命名即可）并点击创建，创建成功后跳转至淘宝应用appkey以及appsecret查看页面。

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

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）“选择业务角色”，填写“关联描述”，点击“申请接入”。提示关联成功后，进入自测开发环节。

2.SDK下载及使用说明

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

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

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

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

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

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