- 1、本文档共16页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 5、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 6、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 7、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 8、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
奇门对接方案说明文档
序言
奇门对接步骤:
接口开发
阅读白皮书和测试说明文档,完成所需接口开发,不仅是接口开发,还包含对应业务功效。
挡板自测
也称二方联调,首先配置自测参数,然后完成和奇门挡板自测。
三方联调
自测经过以后开始三方联调,首先配置联调参数,然后进行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
您可能关注的文档
- 宏业10万锭安全施工组织设计样本.doc
- 天津地铁XX盾构区间施工组织设计样本.doc
- 大学生创业专业策划专题计划书范文模版.doc
- 2025届河南省周口市扶沟高级中学高考化学全真模拟密押卷含解析.doc
- 陕西省延安中学2025届高考考前模拟化学试题含解析.doc
- 2025届林芝市重点中学高考化学四模试卷含解析.doc
- 云南省云天化中学2025届高考历史考前最后一卷预测卷含解析.doc
- 2025届江西省新余市渝水区第一中学高三下学期联考生物试题含解析.doc
- 江西省信丰中学2025届高考化学倒计时模拟卷含解析.doc
- 贵州省黔东南州天柱二中2025届高三下第一次测试化学试题含解析.doc
- 四川省德阳市罗江中学2025届高三考前热身化学试卷含解析.doc
- 山东省枣庄现代实验学校2025届高三下学期第五次调研考试化学试题含解析.doc
- 吉林省长春市十一高中等九校教育联盟2025届高三一诊考试生物试卷含解析.doc
- 2025届江苏省盐城市伍佑中学高考仿真模拟化学试卷含解析.doc
- 2025届广西贺州中学高考冲刺押题(最后一卷)生物试卷含解析.doc
- 安徽省池州市贵池区2025届高三第一次模拟考试生物试卷含解析.doc
- 宁夏银川一中2025届高三(最后冲刺)化学试卷含解析.doc
- 广东省广州市增城区四校联考2025届高考压轴卷化学试卷含解析.doc
- 2025届邯郸市第一中学高考生物必刷试卷含解析.doc
- 2025届安徽省安庆市石化第一中学高考仿真卷化学试卷含解析.doc
文档评论(0)