奇门ISV测试专项方案说明文档.docxVIP

奇门对接方案说明文档

序言

奇门对接步骤：

接口开发

阅读白皮书和测试说明文档，完成所需接口开发，不仅是接口开发，还包含对应业务功效。

挡板自测

也称二方联调，首先配置自测参数，然后完成和奇门挡板自测。

三方联调

自测经过以后开始三方联调，首先配置联调参数，然后进行ERP-奇门-WMS联调。

商家验收

联调经过后，在奇门预发环境配置真实参数，商家公布真实商品进行验收。

系统上线

经奇门确定商家验收经过后，可切换到奇门正式环境，上线完成。

整个奇门ERP和WMS相互调用时序图以下所表示，分正向和反向。所谓正向，我们约定为ERP提议，调用WMS接口，接口实现方是WMS（如：商品同时接口，出库单创建和入库单创建接口等）；同理，反向即WMS提议，调用ERP接口，接口实现方是ERP（如：出库、入库确定接口，缺货通知接口等）。

在挡板自测步骤：（1）ERP测试正向：ERP提议接口调用，奇门挡板会模拟WMS向ERP返回响应；（2）ERP测试反向，需要ERP模拟WMS向自己提议调用请求，测试自己ERP系统是否能接收到请求并正确响应。WMS挡板自测同理。

假如代码还没有实现调用方法，能够利用chrome浏览器或火狐浏览器插件RestClient来测试。

相关RestClient安装，能够在浏览器应用中心里搜索restclient关键字，随便安装一个即可，chrome浏览器下载应用有时候网络不畅，换个时间段多试几次，火狐相对好部分。下载界面以下：

测试方法以下：

相关配置参数

首先解释一下奇门环境和ISV环境。奇门总共有三个环境，分别是日常环境（即沙箱环境），预发环境和线上环境，其中日常环境配置全部是测试数据，预发和线上配置全部是真实数据。对接过程中，参数配置遵照标准以下。其中，商家验收经过以后，奇门确定没有问题，能够切换到线上环境：

在奇门参数配置中关键包含到下面多个关键参数：

ERP_APPKEY

ERP_URL

WMS_APPKEY

WMS_URL

CUSTOMER_ID

奇门作用是针对不一样应用（比如一个ERP）提议请求，正确路由给其对应另一方（比如对应WMS），以下图。

那么奇门路由策略是怎样呢？下面是一段标准调用URL例子：

****timestamp=-04-2620:00:07format=xmlapp_key=****v=2.0sign=abcsign_method=md5customerId=****

其中，各个字段含义，请见下表：

字段名

含义

域名

/router/qimen/service

是奇门测试环境域名地址，自测和联调时候全部是使用这个域名，注意，千万不要直接写成对方ISV应用服务地址

Method

调用方法

timestamp

使用目前调用接口时间，做encode编码

format

临时只支持xml

appkey

调用方自己appkey，即起源appkey

sign

MD5加密，加密策略参看附录1

customerId

是仓储为这个用户分配唯一用户帐号，自测和联调时候由奇门统一分配，等到切到预发和正式环境时候，使用仓储自己分配真实值，注意，对于一个WMS，这个customerId一定要确保唯一

言归正传，奇门怎样依据这一段URL来做路由呢？奇门首先会依据调用url中customerId来找这个用户配置ERP信息和对应WMS信息，所以customerId一定要唯一。

需要配置参数地方有三个，这里分别介绍一下：

注：

Q:什么是沙箱appkey，怎么获取？

A:登陆开放平台，进入控制台，找到对接奇门要使用应用，应用设置里有沙箱环境参数。

相关挡板自测

2.1ERP端：

2.1.1ERP自测正向调用

ERP端做正向接口调用，奇门测试挡板会模拟WMS返回信息，挡板自测调用地址以下(只需修改红色标示method方法字段)：

:00:07format=xmlapp_key=****v=2.0sign=abcsign_method=md5customerId=****

注：app_key是ERPappkey；

sign署名:采取md5不可逆加密方法，具体操作见附录2；

v字段：我们是经过v来区分1.0版本（白皮书v1.5）和2.0版本（白皮书v2.0），不一样v，调用奇门测试挡板是不一样，请注意！临时只有1.0和2.0两种。以后进行三方联调以后，v值怎样定义由双方自行协商了。

ERP自测反向调用

ERP需模拟WMS提议请求，访问url和WMS调用奇门url一致，奇门测试环境调用地址以下，其中，需要修改红色标示method方法字段：

:00:07format=xmlapp_key=*****v=2.0sign=abcsign_method=md5customerId=****

注：app_key是wmsap