WMS奇门对接配置手册
修订记录
1 2020-12-18 新增
2 2021-02-20 修改
3 2021-08-10 修改
摘要
- OMS系统和iWMS系统对接将采用奇门API接口方式，基础档案由OMS提供接口，进销存单据由iWMS提供接口，将单据状态同步到OMS；
- 对接业务主要有：零售、批发、采购、移仓、库存调整、上下架/直接移位六类主体业务；
- 仓库对接模式：仓对库区；仓对库区模式中，OMS仓库的外部编码必须与iWMS库区的外部编码一致（胜境iWMS属性自定义）；
- 仓库库存采用进销存单据对接方式更新，iWMS出入库记账后，库存做相应的扣减和增加，出入库单据记账后，单据状态、SKU、数量同步到OMS， OMS扣减和增加库存；
- E3+仓对iWMS库区时，iWMS的上下架/直接移位操作，如果发生可卖库区与不可卖库区商品的内部调整，iWMS要将单据同步到OMS，OMS生成对应的移仓单，OMS可卖库区和不可卖库区的商品库存发生变化；
一、 奇门联调申请对接
(一) 上游发起上线申请
1． 我的场景：由OMS在奇门云网关发起联调奇门仓储业务（OMS appkey: xxxxxxx 百胜产品申请联系邓莉）
2．上线申请对接胜境iWMS申请时使用 appkey：24602748
3．上线申请参数配置
对应的应用appkey：目标WMS系统的appkey
商家名称（主店铺）：淘宝店铺
我的正式服务地址：
申请上线原因：必填
填写完以上参数就可以申请上线。
(二) WMS接收申请
OMS申请上线后WMS后台配置
正式Customerid：客户编码为自定义值自己编写上线后不可以修改
我的服务地址： http://xxx.xxx.xxx.xxx:xxx/xxxOpenAPI/router 类似格式（配置在应用服务器上，需要能够访问外网）
(一) iWMS配置
IWMS系统支持多套上游系统对接。如果多套上游系统业务一致只用部署一套接口。
- 打开iWMS客户端，打开OpenAPI接口配置中心，点击【新增】按钮，见图2-1
图2-1 OpenAPI接口配置中心
- 打开web.config文件进行配置，如图1-7；
Customerid:申请上线时的客户编码 ；
Tnid:默认为 * 号；
对接系统：选择当前要对接的上游系统名称；
外部编码：使用wsm未配置过的属性；
Akkkey&appSecret: 使用的签名有百胜跟胜境两个，上线申请时使用哪个就配置哪一套（签名联系胜境获取）；
胜境：
AppKey：24602748
回传上游地址：奇门正式地址http://qimen.api.taobao.com/router/qimen/service；
WMS自动任务地址：http://ip/openApi对应IIS应用程序名/Task/TaskList.aspx 类似格式。
OpenAPI接口配置中心明细
图2-2
2． WMS接口日志配置
Select * from tplatdatabase 表配置category=’syslog’ 的connstring值。
图2-3 日志库配置
- iWMS任务配置：
选中对接的客户编码，点击【回传任务设置】 然后F5将左边任务配置到当前的对接的客户编码上。
图2-4 接口任务配置
设置对接库区；登录iWMS，转入基础档案-仓库档案-库区，设置库区的属性三与OMS一致
(二) 图2-5 库区外部编码配置
(三) 常见Q&A
