阿里大于 -

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
request	SingleitemSynchronizeRequest	可选			请求
└ actionType String 必须 add 操作类型(两种类型：add\|update) └ warehouseCode String 必须 CK1234 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER) └ ownerCode String 必须 HZ123 货主编码 └ supplierCode String 可选 GY123 供应商编码 └ supplierName String 可选淘宝供应商名称 └ extendProps String 可选 {"key":"value"} 扩展属性;json序列化格式 item Item 可选商品信息 └ actualAmount String 可选 100.00 实际金额 └ actualQty String 可选 100 实际数量 └ adventLifecycle Number 可选 1 保质期临期预警天数 └ amount String 可选 100.00 金额 └ approvalNumber String 可选 PB123 批准文号 └ barCode String 必须 T1;T2 条形码(可多个;用分号;隔开) └ batchCode String 可选 P1234 批次代码 └ batchRemark String 可选备注信息批次备注 batchs Batch [] 可选批次信息 └ actualQty String 可选 100 实际数量 └ batchCode String 可选 B20240101 批次代码 └ expireDate String 可选 2025-01-01 过期日期 └ inventoryType String 可选 ZP 库存类型 └ produceCode String 可选 SC20240101 生产编码 └ productDate String 可选 2024-01-01 生产日期 └ quantity String 可选 100 数量 └ remark String 可选备注备注 └ brandCode String 可选 LAL 品牌代码 └ brandName String 可选 HM 品牌名称 └ categoryId String 可选 LB123 商品类别ID └ categoryName String 可选手机商品类别名称 └ changeTime String 可选 2024-01-01 12:00:00 变更时间 └ channelCode String 可选 123 渠道变量 └ color String 可选红色颜色 └ costPrice String 可选 12.0 成本价 └ createTime String 可选 2017-09-09 12:00:00 创建时间(YYYY-MM-DD HH:MM:SS) └ defectiveQty String 可选 5 残次品数量 └ diffQuantity String 可选 5 差异数量 └ discount String 可选 0.85 折扣 └ discountPrice String 可选 85.00 折扣价 └ englishName String 可选 EN123 英文名 └ exCode String 可选 EX123 扩展编码 └ expireDate String 可选 2016-09-09 过期日期(YYYY-MM-DD) └ extCode String 可选 EC123 扩展编码 └ goodsCode String 可选 H1234 货号 └ grossWeight String 可选 12.0 毛重(单位：千克) └ height String 可选 12.0 高(单位：厘米) └ inventoryType String 可选 ZP 库存类型 └ isAreaSale String 可选 N 是否区域销售 └ isBatchMgmt String 可选 N 是否需要批次管理(Y/N ;默认为N) └ isFragile String 可选 N 是否易碎品(Y/N ;默认为N) └ isHazardous String 可选 N 是否危险品(Y/N ;默认为N) └ isLiquid String 可选 Y 是否液体;Y/N;(默认为N) └ isSNMgmt String 可选 N 是否需要串号管理(Y/N ;默认为N) └ isShelfLifeMgmt String 可选 N 是否需要保质期管理(Y/N ;默认为N) └ isSku String 可选 N 是否sku(Y/N ;默认为N) └ isValid String 可选 N 是否有效(Y/N ;默认为N) └ itemCode String 必须 I1234 商品编码 └ itemId String 可选 WI1234 仓储系统商品编码(该字段是WMS分配的商品编号;WMS如果分配了商品编码;则后续的商品操作都需要传该字段;如果WMS不使用;WMS可以返回itemId=itemCode的值) └ itemName String 必须 SN123 商品名称 └ itemType String 必须 ZC 商品类型(ZC=正常商品;FX=分销商品;ZH=组合商品;ZP=赠品;BC=包材;HC=耗材;FL=辅料;XN=虚拟品;FS=附属品;CC=残次品;OTHER=其它;只传英文编码) └ lackQty String 可选 0 缺货数量 └ latestUpdateTime String 可选 2024-01-01 12:00:00 最近更新时间 └ length String 可选 12.0 长(单位：厘米) └ lockQuantity String 可选 10 锁定数量 └ lockupLifecycle Number 可选 1 保质期禁售天数 └ logisticsType String 可选 0 销售配送方式（0=自配\|1=菜鸟） └ netWeight String 可选 12.0 净重(单位：千克) └ normalQty String 可选 90 正常数量 └ orderCode String 可选 ORD123 订单编码 └ orderLineNo String 可选 1 订单行号 └ orderType String 可选 JYCK 订单类型 └ originAddress String 可选 HK 商品的原产地 └ originCode String 可选 CN 原产地编码 └ outBizCode String 可选 OB123 外部业务编码 └ ownerCode String 可选 HZ123 货主编码 └ packCode String 可选 B12 包装代码 └ packageMaterial String 可选 BX123 商品包装材料类型 └ paperQty String 可选 1 纸质单证数量 └ pcs String 可选 XG123 箱规 └ planQty String 可选 100 计划数量 └ price String 可选 100.00 价格 priceAdjustment PriceAdjustment 可选优惠信息 └ discount String 可选 0.85 折扣 └ endDate String 可选 2025-12-31 结束日期 └ remark String 可选备注备注 └ standardPrice String 可选 100.00 标准价格 └ startDate String 可选 2025-01-01 开始日期 └ type String 可选 FIXED 价格调整类型 └ pricingCategory String 可选手机类计价货类 └ produceCode String 可选 SC20240101 生产编码 └ productCode String 可选 PC123 产品编码 └ productDate String 可选 2016-09-09 生产日期(YYYY-MM-DD) └ purchasePrice String 可选 12.0 采购价 └ quantity String 可选 100 数量 └ reason String 可选入库原因 └ receiveQty String 可选 95 收货数量 └ referencePrice String 可选 99.00 参考价格 └ rejectLifecycle Number 可选 1 保质期禁收天数 └ remark String 可选备注信息备注 └ retailPrice String 可选 12.0 零售价 └ safetyStock Number 可选 12 安全库存 └ seasonCode String 可选 CHUN 季节编码 └ seasonName String 可选春季季节名称 └ shelfLife Number 可选 1 保质期(单位：小时) └ shortName String 可选 JC123 商品简称 └ size String 可选 5英尺尺寸 └ skuProperty String 可选红色商品属性(如红色;XXL) └ sn String 可选 SN123456 序列号 └ snCode String 可选 SN123456 串号编码 └ sourceOrderCode String 可选 SO123 来源订单编码 └ standardPrice String 可选 100.00 标准价格 └ stockStatus String 可选 NORMAL 库存状态 └ stockUnit String 可选个商品计量单位 └ subSourceOrderCode String 可选 SSO123 子来源订单编码 └ supplierCode String 可选 GY123 供应商编码 └ supplierName String 可选淘宝供应商名称 └ tagPrice String 可选 12.0 吊牌价 └ tareWeight String 可选 0.5 皮重 └ tempRequirement String 可选常温温度要求 └ title String 可选淘公仔渠道中的商品标题 └ unit String 可选个单位 └ updateTime String 可选 2017-09-09 12:00:00 更新时间(YYYY-MM-DD HH:MM:SS) └ volume String 可选 12.0 体积(单位：升) └ warehouseCode String 可选 CK1234 仓库编码 └ width String 可选 12.0 宽(单位：厘米)

名称	类型	示例值	描述
response	SingleitemSynchronizeResponse		返回
└ success Boolean true 是否成功: true-成功; false-失败 └ bizErrorCode String E0001 错误编码 └ bizErrorMsg String invalid app key 错误描述 └ itemId String CH123 仓储系统商品Id(当这个字段不为空的时候;所有erp传输的时候都碰到itemid必传) └ extendProps String {"key":"value"} 扩展属性;json序列化格式

{"request":{"supplierName":"淘宝","actionType":"add","item":{"orderType":"JYCK","reason":"入库","originAddress":"HK","discount":"0.85","pricingCategory":"手机类","itemName":"SN123","packCode":"B12","price":"100.00","brandCode":"LAL","height":"12.0","safetyStock":12,"seasonCode":"CHUN","paperQty":"1","productDate":"2016-09-09","stockUnit":"个","itemId":"WI1234","size":"5英尺","rejectLifecycle":1,"shortName":"JC123","planQty":"100","ownerCode":"HZ123","defectiveQty":"5","diffQuantity":"5","supplierCode":"GY123","tempRequirement":"常温","skuProperty":"红色","referencePrice":"99.00","exCode":"EX123","normalQty":"90","seasonName":"春季","packageMaterial":"BX123","expireDate":"2016-09-09","sn":"SN123456","shelfLife":1,"orderLineNo":"1","actualAmount":"100.00","isValid":"N","latestUpdateTime":"2024-01-01 12:00:00","costPrice":"12.0","updateTime":"2017-09-09 12:00:00","tagPrice":"12.0","isSku":"N","changeTime":"2024-01-01 12:00:00","isLiquid":"Y","productCode":"PC123","createTime":"2017-09-09 12:00:00","width":"12.0","goodsCode":"H1234","retailPrice":"12.0","tareWeight":"0.5","priceAdjustment":{"endDate":"2025-12-31","discount":"0.85","remark":"备注","standardPrice":"100.00","type":"FIXED","startDate":"2025-01-01"},"snCode":"SN123456","itemCode":"I1234","lockQuantity":"10","purchasePrice":"12.0","lackQty":"0","stockStatus":"NORMAL","originCode":"CN","brandName":"HM","inventoryType":"ZP","receiveQty":"95","barCode":"T1;T2","volume":"12.0","batchs":[{"produceCode":"SC20240101","inventoryType":"ZP","quantity":"100","batchCode":"B20240101","expireDate":"2025-01-01","remark":"备注","actualQty":"100","productDate":"2024-01-01"}],"netWeight":"12.0","unit":"个","extCode":"EC123","sourceOrderCode":"SO123","isSNMgmt":"N","lockupLifecycle":1,"englishName":"EN123","itemType":"ZC","color":"红色","adventLifecycle":1,"discountPrice":"85.00","remark":"备注信息","title":"淘公仔","actualQty":"100","categoryName":"手机","warehouseCode":"CK1234","produceCode":"SC20240101","isShelfLifeMgmt":"N","isAreaSale":"N","isFragile":"N","channelCode":"123","supplierName":"淘宝","isHazardous":"N","pcs":"XG123","amount":"100.00","quantity":"100","batchCode":"P1234","length":"12.0","standardPrice":"100.00","subSourceOrderCode":"SSO123","approvalNumber":"PB123","grossWeight":"12.0","isBatchMgmt":"N","batchRemark":"备注信息","outBizCode":"OB123","orderCode":"ORD123","logisticsType":"0","categoryId":"LB123"},"ownerCode":"HZ123","extendProps":"{\"key\":\"value\"}","supplierCode":"GY123","warehouseCode":"CK1234"}}

{
    "response":{
        "success":true,
        "bizErrorCode":"E0001",
        "bizErrorMsg":"invalid app key",
        "itemId":"CH123",
        "extendProps":"{\"key\":\"value\"}"
    }
}

{"response":{"bizErrorMsg":"Illegal request","success":"false","bizErrorCode":"sign-check-failure"}}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

阿里健康API

qimen.alibaba.alihealth.wms.singleitem.synchronize (商品同步)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ