# qm接口对接
# 文档参见doc目录

## 回调接口文件
QmController
## 商品测试文件
SingleItemTest
## 发货单测试文件
DeliveryOrderTest
## 出货单测试文件
StockOrderTest
## 重要说明:
商品接口itemCode货主唯一<br>
商品ID对接方式<br>
  1 商品接口得到wms的id记录到自己的商品表，订单接口中itemId传wmsId<br>
  2 所有接口不传itemId,wms通过itemCode匹配（ERP无需记录wmsId,耦合度更小）<br>
关于接口的选择<br>
发货接口适用于电商订单，不可部分发货订单<br>
出库接口适用于2B订单支持部分发货和全发控制<br>

SpringMVC 支持特殊字符的开发("+ % &")<br>
SprintBoot 不支持特殊字符开发

## 接口开发顺序
+ 商品接口 6.2
+ 入库单接口 6.5
+ 入库单反馈接口 6.6
+ 出库或发货单接口 6.11或6.14
+ 出库或发货单反馈接口 6.12或6.17 并一一对应
+ 取消接口 6.28 含所有单据取消
+ 退货入库单同步接口 6.8
+ 退货入库单确认接口 6.9
+ 库存盘点通知6.33或库存异动通知接口6.37 二选一即可(wms发起的损益反馈给ERP)

## 关于多仓多货主说明
1 wms支持 一个APPKEY一个货主(customerId和ownerCode一样) ERP和WMS同步新增货主 wms还需要同步新增奇门配置<br>
2 一个APPKY多个货主（customerId不变ownerCode变，可以使用货主同步接口自动同步货主）


### 签名计算方式
详见 文档目录7 sign 签名算法
测试地址 http://tool.chinaz.com/tools/md5.aspx

### 系统常见问题解答

1、采购单的反馈机制 <br>
采购单支持按单反馈（即订单结束后反馈）和按收货单反馈维度。

2、订单取消需要下发订单类型 <br>
订单取消的订单类型即各种订单下发时的订单类型。