奇门白皮书(5)

奇门ISV接入白皮书

奇门发给WMS：

http://[wms_webservice_url]?method=[wms_API]&format=xml&app_key=[erp _appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId

=[QIMENUSR1]

WMS发给奇门：

http://qimen.api.taobao.com/router/qimen/service?method=[qimen_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.

[]中需要根据具体业务进行填写。qimen_API，wms_API具体见下方的API名称。 2. 3.

URL需要做URL Encoding处理。 请求和响应的消息主体使用XML格式。 5.2.2 请求参数

请求参数包含URL中带的系统参数和BODY中带的相关业务参数，以下是系统参数： 参数 method format 参数说明 WMS相关的业务接口名称，如商品信息同步的请求，method= item.synchronize content格式 类型 约束 string 必须 string 目前支持XML WMSapp_key v sign 应用接入时申请的appkey 协议版本号，1.0或者2.0 根据url和密钥计算的结果。具体算法参看附录1 21

string 的appkey string 必须 string 必须

奇门ISV接入白皮书

sign_method customerid 参数加密方法，md5 WMS颁发给用户的ID string 必须 5.2.3 响应参数

响应参数包含系统参数和业务参数。以下是系统参数： 参数 flag code message 参数说明 success|failure 返回状态码 返回状态描述 类型 string（50） string（50） string（200） 必须 必须 必须 约束 6 接口说明

注：所有非叶子节点下都可以增加remark和extendProps ? ?

remark

备注，string(500) extendProps使用key-value结构， 扩展属性 value1 value2 …

6.1 商品同步接口（iwms）

6.1.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.singleitem.synchronize 奇门调用WMS的API名称：singleitem.synchronize

6.1.2 入参规范

22

奇门ISV接入白皮书

add|update, 必填

仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER

货主编码, string (50) , 必填 供应商编码, string (50) 供应商名称, string (200)

商品编码, string (50) , 必填

仓储系统商品编码, string (50) , 条件必填, 条件为商品同步接口, 出参itemId不为空

货号，string（50） 商品名称, string (200) , 必填 商品简称, string (200)

英文名, string (200)

条形码, string (500) , 可多个，用分号（;）隔开，必填 商品属性 (如红色, XXL) , string (200) 商品计量单位, string (50) 长 (厘米) , double (18, 2) 宽 (厘米) , double (18, 2) 高 (厘米) , double (18, 2) 体积 (升) , double (18, 3)

毛重 (千克) , double (18, 3) 净重 (千克) , double (18, 3) 颜色, string (50) 尺寸, string (50)

商品类别ID, string (50)

商品类别名称, string (200) 计价货类, string (200) 安全库存, int

商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) , string (10) , 必填, (只传英文编码)

吊牌价, double (18, 2)

23

奇门ISV接入白皮书

零售价, double (18, 2) 成本价, double (18, 2)

采购价, double (18, 2) 季节编码, string (50) 季节名称, string (50) 品牌代码, string (50) 品牌名称, string (50)

是否需要串号管理, Y/N (默认为N) 生产日期, string (10) , YYYY-MM-DD 过期日期, string (10) , YYYY-MM-DD

是否需要保质期管理, Y/N (默认为N) 保质期 (小时) , int

保质期禁收天数, int 保质期禁售天数, int 保质期临期预警天数, int 是否需要批次管理, Y/N (默认为N) 批次代码, string (50) 批次备注, string (200) 包装代码, string (50) 箱规, string(50)

商品的原产地, string (50) 批准文号, string (50) 是否易碎品, Y/N, (默认为N) 是否危险品, Y/N, (默认为N) 备注, string (500)

创建时间, string (19) , YYYY-MM-DD HH:MM:SS 更新时间, string (19) , YYYY-MM-DD HH:MM:SS 是否有效, Y/N (默认为Y) 是否sku, Y/N, (默认为Y)

商品包装材料类型, string (200) 扩展属性 value1 value2

24

奇门ISV接入白皮书

6.1.3 出参规范

success|failure 响应码

响应信息

仓储系统商品Id, string (50) ,条件必填，当这个字段不为空的时候, 所有erp传输的时候都碰到itemid必传

6.2 商品同步接口 (批量)（iwms）

6.2.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.items.synchronize 奇门调用WMS的API名称：items.synchronize

6.2.2 入参规范

add|update, 必填

仓库编码, string (50)，必填 ，统仓统配等无需ERP指定仓储编码的情况填OTHER

货主编码, string (50) , 必填

供应商编码, string (50) 供应商名称, string (200) 商品编码, string (50) , 必填

仓储系统商品编码, string (50) , 条件必填, 条件为商品同步接口, 出参itemId不为空

25