文档中心 > API类目 > 魅力惠API

qimen.tmall.luxury.wms.order.stock.in (天猫奢品入库通知单下发)

天猫奢品入库通知单下发到wms通过该API将采购单收货入库的信息下发

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
ownerUserId	String	必须	14544	最大长度：200	货主ID
ownerUserName	String	可选	天猫奢品	最大长度：640	货主名称
storeCode	String	必须	4563	最大长度：640	仓储编码
orderCode	String	必须	1255	最大长度：128	仓储中心入库订单编码
orderType	Number	必须	302		单据类型： 302调拨入库单 501销退入库单 601采购入库单 904普通入库单306 B2B入库单 604 B2B干线退货入库 704 库存状态调整入库
inboundTypeDesc	String	可选	加工归还	最大长度：20000	自定义文本透传至WMS 加工归还委外归还借出归还内部归还
orderFlag	String	可选	9	最大长度：640	仓库订单需要履行服务标识适用如下场景：退货入库:8:退换货9:上门服务13: 退货收取发票31：退货入库36：退货时同时换货41:拦截退回，其他单据忽略
orderSource	Number	可选	201		适用如下场景：退货入库:订单来源（213 天猫 201 淘宝　214 京东 202 1688 阿里中文站 203 苏宁在线 204 亚马逊中国 205 当当 208 1号店 207 唯品会 209 国美在线 210 拍拍 206 易贝ebay 211 聚美优品 212 乐蜂网 215 邮乐 216 凡客 217 优购 218 银泰 219 易讯 221 聚尚网 222 蘑菇街 223 POS门店 301 其他不在范围之内请忽略）其他单据忽略
orderCreateTime	String	必须	YYYY-MM-DD HH:MM:SS	默认值：2020-01-01 00:00:00 最大长度：19	订单创建时间(格式为 YYYY-MM-DD HH:mm:ss)
supplierOrderNo	String	可选	379272010	最大长度：640	供应商单号
supplierCode	String	可选	379272010	最大长度：640	供应商编码，往来单位编码适用如下场景：采购入库单
supplierName	String	可选	上海魅力惠贸易有限公司	最大长度：640	供应商名称，往来单位名称适用如下场景：采购入库单
tmsServiceCode	String	可选	ZTO	最大长度：640	配送公司编码适用如下场景：销退买家拒签：原发货单的配送公司编码；销退上门取件消费者退货商家下单：新生成的运单号所属配送公司的编码
tmsServiceName	String	可选	中通	最大长度：640	配送公司名称适用如下场景：销退买家拒签：原发货单的配送公司名称销退上门取件消费者退货商家下单：新生成的运单号所属配送公司的名称
tmsOrderCode	String	可选	17208208270	最大长度：640	运单号适用如下场景：销退买家拒签：原发货单的运单号销退上门取件，消费者退货，商家下单：新生成的运单号
prevOrderCode	String	可选	18202833002	最大长度：640	原仓储作业单号适用如下场景：销退入库单：原发货单号注意：原发货单可能是其他仓库发出
prevStoreCode	String	可选	00001	最大长度：640	前仓库编码
returnReason	String	可选	找不到收货人地址	最大长度：640	退货原因：销退场景下如可能请提供退货的原因多个退货原因用；号分开
expectStartTime	String	可选	YYYY-MM-DD	默认值：2020-01-01 最大长度：100	预期送达开始时间格式为 YYYY-MM-DD
expectEndTime	String	可选	YYYY-MM-DD	默认值：2020-01-01 最大长度：100	预期送达结束时间格式为 YYYY-MM-DD
batchSendCtrlParam	BatchSendCtrlParam	可选			分批下发控制信息
└ totalOrderItemCount Number 必须 1688 下发总共ITEM数 └ distributeType Number 必须 1 是否分批下发: 0 最后一次下发 1 多次发送
senderInfo	SenderInfo	必须			发件方信息
└ senderZipCode String 可选 938900 发件方邮编 └ senderCountry String 可选中国发件方国家 └ senderProvince String 可选四川发件方省份国际地址可能没有 └ senderCity String 可选成都发件方城市 └ senderArea String 可选金牛发件方区县 └ senderTown String 可选未央区发件方镇 └ senderAddress String 必须溪望路888号发件方地址 └ senderDivisionId String 可选 32320323 发件方最小区划ID └ senderName String 必须张三发件方名称（采购入库放供应商名称）（销退入库填买家名称）（调拨入库填写调拨出库仓库联系人名称） └ senderMobile String 可选 13988003833 发件方手机手机和电话不能同时为空 └ senderPhone String 可选 028-28200288 发件方电话手机和电话不能同时为空
receiverInfo	ReceiverInfo	可选			收件人信息
└ receiverZipCode String 可选 100010 收件方邮编 └ receiverCountry String 可选中国收件方国家 └ receiverProvince String 可选北京市收件方省份国际地址可能没有 └ receiverCity String 可选北京市收件方城市市与区不会同时为空 └ receiverArea String 可选朝阳区收件方区县市与区不会同时为空 └ receiveTown String 可选紫禁城收件方镇 └ receiverDivisionId String 可选 3232323 收件方最小区划ID 四级地址ID └ receiverAddress String 可选宣武门3212号收件方详情地址不包含省、市、区、街道信息 └ receiverName String 必须老王收件人名称 └ receiverMobile String 可选 13888888888 收件人手机手机和电话不会同时为空 └ receiverPhone String 可选 010-88888888 收件人电话手机和电话不会同时为空
orderItemList	StockInOrderItem []	必须		最大列表长度：20000	订单商品列表
└ orderItemId String 必须 5642 入库单明细ID └ orderSourceCode String 可选 8302 平台交易编码：只在销退订单时使用，原销售订单的主交易单号 └ subSourceCode String 可选 470302 平台子交易编码:只在销退订单时使用，原销售订单的子交易单号 └ itemId String 必须 4729200 商品ID └ itemName String 可选 iPhone4S 移动3G版商品名称 └ itemCode String 可选 137903 商家对商品的编码 └ barCode String 可选 480323 条形码多条码请用”;”分隔；仓库入库扫码使用 └ inventoryType Number 必须 1 库存类型（1 可销售库存(正品) 101 残次 102 机损 103 箱损301 在途库存 201 冻结库存）注意：采购入库单下发的库存类型是301 └ itemQuantity Number 必须 12 商品数量 └ itemVersion Number 必须 122 商品版本如果版本和WMS系统中的版本不一致需要CP使用商品抓取接口将最新的商品信息抓取下来 └ batchCode String 可选 4 批次号 └ dueDate String 可选 2020-01-01 到效日期保质期商品信息如果商品启用了保质期管理需要仓库按指定保质期生产格式为 YYYY-MM-DD └ produceDate String 可选 2020-02-02 生产日期保质期商品信息如果商品启用了保质期管理需要仓库按指定保质期生产格式为 YYYY-MM-DD └ produceCode String 可选 739300 生产编码同一商品可能因商家不同有不同编码 └ purchaseOrderCode String 可选 PO19040113243435434343 采购单号 └ taxRate Number 可选 300 税率单位% 保留2位小数 └ purchasePrice Number 可选 323323 采购价 └ settlementPrice Number 可选 3232323 结算价格 └ supplierCode String 可选 1404304994 供应商编号 └ supplierName String 可选北京第一国际贸易有限公司供应商名称 └ productTime String 可选 2020-01-01 生产日期 (格式为 YYYY-MM-DD HH:mm:ss) └ expireTime String 可选 2020-01-01 过期日期 (格式为 YYYY-MM-DD HH:mm:ss) └ batchRemark String 可选 **** 批次备注
caseInfoList	WmsStockInCaseInfo []	可选		最大列表长度：20000	装箱列表
└ caseNumber String 必须 8302 箱号 └ caseSequence String 必须 8302 箱编码 └ palletNumebr String 可选 3232323 托盘号 └ containerNumber String 可选 3230400 集装箱编号 └ weight Number 可选 3234412 重量单位克 └ volume Number 可选 324654 体积单位立方厘米 └ length Number 可选 32323 长单位 mm └ width Number 可选 2355432 宽单位 mm └ height Number 可选 235093 高单位 mm caseItemList WmsStockInCaseItem [] 可选装箱明细列表 └ itemId String 必须 323353 商品ID └ itemName String 可选宝来眼霜×1000g 商品名称 └ itemCode String 可选 8302 商家对商品的编码 └ barCode String 可选 480399 条形码多条码请用”;”分隔；仓库入库扫码使用 └ inventoryType Number 必须 1 库存类型（1 可销售库存(正品) 101 残次 102 机损 103 箱损301 在途库存 201 冻结库存）注意：采购入库单下发的库存类型是301 └ itemQuantity Number 必须 8302 商品数量 └ itemVersion Number 必须 323 商品版本
timeZone	String	可选	+0800	最大长度：16	时区
currency	String	可选	CNY	最大长度：8	币种
driverInfo	DriverInfo	可选			装车信息
└ driverName String 可选老张送货人 └ driverIdentityId String 可选 100100101011100101 身份证号 └ driverPhone String 可选 13888888888 电话 └ vehicleType Number 可选 0 车辆类型 0:普通货车 1:平板车 2:箱式货车 3:冷藏车 └ vehicleLoad Number 可选 3000 车辆最大负荷 └ licensePlate String 可选沪A88888 车牌号
remark	String	可选	7天无理由退货	最大长度：2000	备注:销退时留言备注填充到此字段
isAdvSale	Number	可选	1		是否预售
extendFields	String	可选	{"storeAge":365}		扩展字段

响应参数

名称	类型	示例值	描述
result	ResultDO		结果
└ success Boolean true 是否成功 └ errorCode String 200 错误码 └ errorMessage String xxx错误信息错误信息 └ data String data 返回数据

请求示例

{"batchSendCtrlParam":{"distributeType":1,"totalOrderItemCount":1688},"orderType":302,"expectEndTime":"YYYY-MM-DD","orderItemList":[{"supplierName":"北京第一国际贸易有限公司","inventoryType":1,"itemQuantity":12,"orderItemId":"5642","itemCode":"137903","itemVersion":122,"batchCode":"4","dueDate":"2020-01-01","subSourceCode":"470302","purchasePrice":323323,"supplierCode":"1404304994","productTime":"2020-01-01","barCode":"480323","itemId":"4729200","produceCode":"739300","taxRate":300,"itemName":"iPhone4S 移动3G版","produceDate":"2020-02-02","purchaseOrderCode":"PO19040113243435434343","expireTime":"2020-01-01","batchRemark":"****","orderSourceCode":"8302","settlementPrice":3232323}],"expectStartTime":"YYYY-MM-DD","receiverInfo":{"receiverAddress":"宣武门3212号","receiverDivisionId":"3232323","receiverZipCode":"100010","receiverCountry":"中国","receiverPhone":"010-88888888","receiveTown":"紫禁城","receiverName":"老王","receiverMobile":"13888888888","receiverProvince":"北京市","receiverArea":"朝阳区","receiverCity":"北京市"},"inboundTypeDesc":"加工归还","remark":"7天无理由退货","supplierCode":"379272010","tmsServiceCode":"ZTO","tmsOrderCode":"17208208270","driverInfo":{"licensePlate":"沪A88888","vehicleLoad":3000,"driverName":"老张","driverIdentityId":"100100101011100101","driverPhone":"13888888888","vehicleType":0},"returnReason":"找不到收货人地址","extendFields":"{\"storeAge\":365}","ownerUserName":"天猫奢品","currency":"CNY","supplierOrderNo":"379272010","supplierName":"上海魅力惠贸易有限公司","orderSource":201,"orderCreateTime":"YYYY-MM-DD HH:MM:SS","isAdvSale":1,"timeZone":"+0800","tmsServiceName":"中通","senderInfo":{"senderPhone":"028-28200288","senderTown":"未央区","senderAddress":"溪望路888号","senderName":"张三","senderMobile":"13988003833","senderProvince":"四川","senderDivisionId":"32320323","senderZipCode":"938900","senderCountry":"中国","senderCity":"成都","senderArea":"金牛"},"caseInfoList":[{"volume":324654,"caseSequence":"8302","containerNumber":"3230400","caseNumber":"8302","length":32323,"width":2355432,"weight":3234412,"palletNumebr":"3232323","height":235093,"caseItemList":[{"itemId":"323353","itemName":"宝来眼霜×1000g","inventoryType":1,"itemQuantity":8302,"itemCode":"8302","itemVersion":323,"barCode":"480399"}]}],"ownerUserId":"14544","orderFlag":"9","orderCode":"1255","prevStoreCode":"00001","prevOrderCode":"18202833002","storeCode":"4563"}

响应示例

{
    "result":{
        "success":true,
        "errorCode":"200",
        "errorMessage":"xxx错误信息",
        "data":"data"
    }
}

验签示例

{"result":{"success":"false","errorMessage":"Illegal request","errorCode":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

魅力惠API

qimen.tmall.luxury.wms.order.stock.in (天猫奢品入库通知单下发)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ