奇门ISV接入白皮书
4.3 系统调用流程
正向调用：前端ERP系统通过TOP接口与奇门项目应用进行交互，对于想要发送到WMS的请求首先发送到奇门应用，由奇门负责数据的解析、字段映射、数据翻译，再将处理后的数据通过ERP系统所请求的目的地发送至WMS系统；WMS系统收到请求后，将返回结果送回至奇门应用，由奇门应用统一返回至ERP系统；
反向调用：WMS系统主动向ERP系统发出状态更新请求也是类似以上的访问步骤； 以下是简版软件流程图：
ERP奇门WMS①正向发起业务请求HTTP②正向发起WMS业务请求HTTP正向流程④返回WMS响应结果③返回响应结果⑥反向发起ERP业务请求HTTP⑤反向发起业务请求HTTP反向流程⑦返回响应结果⑧返回ERP响应结果
4.4 联调、测试方式
奇门项目支持ERP系统的正向调用以及WMS系统的反向调用，所以对于ERP系统以及WMS系统的测试方法并不一致，以下分别介绍ERP系统以及WMS系统的联调、测试方法：
16
奇门ISV接入白皮书
4.4.1 ERP端
配置信息确认阶段：提前与WMS厂商进行沟通，根据商家的在WMS端的用户信息获取以下配置信息，并提供给奇门项目组，由奇门项目组完成在奇门当中的配置： 奇门标准字段 appkey customerid secretkey 字段含义 appkey 用户id 备注 由开放平台分配，对应ERP软件的编码 访问WMS系统的账号 测试环境配置值 用户密码 该账号访问WMS系统的密码 开发接口阶段：奇门项目当中ERP端支持正向调用也支持反向调用，正向调用的API接口由TOP平台提供，ERP端直接发起对沙箱环境的调用即可完成接口的测试工作，沙箱环境调用地址如下 (只需修改红色标示的method方法字段和test_type字段，test_type值可以取normal和error，normal会返回该请求成功的应答，error会返回该请求失败的应答) ：
http://qimenapi.tbsandbox.com/top/router/qimen/service?method=taobao.qimen.itemlack.report×tamp=2015-04-26 00:00:07&format=xml&test_type=normal&app_key=testerp_appkey&v=1.0&sign=abc&sign_method=md5&customerId=stub-cust-code&uid=123456789
反向调用的API接口由ERP端提供，奇门会直接向ERP端发起调用，在此类型的API接口测试的过程当中，需要由服务商使用一个Http Restful接口的客户端向奇门发起反向调用；（推荐使用Chrome浏览器下的REST Console插件）
系统联调阶段：依次完成正向请求的开发与反向接口的工作后，与奇门项目组共同进行联调，在测试环境当中依次测试之前开发接口的业务逻辑；
系统发布阶段：与WMS端服务商共同确认正式环境的配置值，ERP端直接发起对奇门正式环境的调用，需要将原有访问地址与具体配置地址切换成正式环境地址。
4.4.2 WMS端
配置信息确认阶段：WMS厂商需提前提供商家的在WMS端的用户信息以及如下的配置信息，提供给奇门项目组以及ERP端进行配置：
17
奇门ISV接入白皮书
奇门标准字段 warehouseCode customerid 字段含义 仓库id 用户id 备注 仓储服务商分配给商家的仓库编码 访问WMS系统的账号 测试环境配置值 开发接口阶段：奇门项目当中WMS端支持正向调用也支持反向调用，反向调用的API接口由TOP平台提供，WMS端直接发起对沙箱环境的调用即可完成接口的测试工作，沙箱环境调用地址如下 (只需修改红色标示的method方法字段和test_type字段，test_type值可以取normal和error，normal会返回该请求成功的应答，error会返回该请求失败的应答) ：
http://qimenapi.tbsandbox.com/router/qimen/service?method=taobao.qimen.itemlack.report×tamp=2015-04-26 00:00:07&format=xml&test_type=normal&app_key=【奇门沙箱Appkey】&v=1.0&sign=abc&sign_method=md5&customerId=【奇门分配】&uid=123456789
正向调用的API接口由WMS端提供，奇门会直接向WMS端发起调用，在此类型的API接口测试的过程当中，需要由服务商使用一个Http Restful接口的客户端向奇门发起正向调用；（推荐使用Chrome浏览器下的REST Console插件）
系统联调阶段：依次完成正向请求的开发与反向接口的工作后，与奇门项目组共同进行联调，在测试环境当中依次测试之前开发接口的业务逻辑；
系统发布阶段：WMS服务商与奇门共同确认正式环境的配置值，WMS端直接发起对奇门正式环境的调用，需要将原有访问地址与具体配置地址切换成正式环境地址。
18
奇门ISV接入白皮书
5 接口规范
5.1
ERP与奇门的通信协议
5.1.1 协议描述
接口遵循REST规范，使用HTTP POST方式进行通讯。 标准协议的HTTP入口地址为： ERP发给奇门：
http://qimen.api.taobao.com/router/qimen/service?method=[qimen_API]&session=[1000]×tamp=[2015-02-01 00:00:00]&format=xml&app_key=[erp_appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[QIMENUSR1]
奇门发给ERP：
http://[erp_webservice_url]?method=[erp_API]×tamp=[2015-02-01 00:00:00]&format=xml&app_key=[wms_appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[QIMENUSR1]
注： 1. 2. 3.
[]中需要根据具体业务进行填写。qimen_API，erp_API具体见下方的API名称。 URL需要做URL Encoding处理。 请求和响应的消息主体使用XML格式。 5.1.2 访问授权
需要商家提供TOP的sessionkey（session）以及该商家在对应wms系统的客户ID（customerID）和密钥（用于计算sign）。
19
奇门ISV接入白皮书
5.1.3 请求参数说明
请求参数包含URL中带的系统参数和BODY中带的相关业务参数，系统参数如下： 参数 session method timestamp format app_key v sign sign_method customerid 5.1.4 响应参数
响应参数包含系统参数和业务参数，系统参数如下： 参数 flag code message 参数说明 success|failure 返回状态码 返回状态描述 类型 string（50） string（50） string（200） 必须 必须 必须 约束 参数说明 session，TOP颁发给商家的 ERP相关的业务接口名称，如商品信息同步的请求，method= taobao.qimen.item.synchronize 时间戳，格式为yyyy-mm-dd HH:mm:ss content格式 应用接入时申请的appkey 协议版本号，1.0或者2.0 根据url和密钥计算的结果。具体算法参看附录1 参数加密方法，md5 WMS颁发给用户的ID 类型 string string 必须 string 必须 string string 目前支持XML ERP的appkey 约束 string 必须 string 必须 string 必须 5.2 奇门与WMS的通信协议
5.2.1 协议描述
接口遵循REST规范，使用HTTP POST方式进行通讯。 标准协议的HTTP入口地址为：
20