文档中心 > API类目 > 淘宝物流API

qimen.taobao.logistics.wms.inventory.adjust.create (库存调整单下发到仓)

淘天下发库存调整单给到生态仓，仓库进行对应的库存调整

公共参数

请求地址：

环境	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	Request	可选			请求
└ ownerCode String 必须 AX766232 货主编码 └ warehouseCode String 必须 STA 仓库编码 └ adjustOrderCode String 必须 TLBXXXXX1 淘天调整单号 └ outBizCode String 必须 TLBXXXXX1_STATUS 业务幂等码 └ relatedEntryOrderCode String 可选 TLBXXXXX2 淘天作业单code └ relatedTallyOrderCode String 可选 TLBPXXX 淘天理货报告code └ remark String 可选备注备注 inventoryAdjustOrderLines InventoryAdjustOrderLine [] 必须移库明细 └ orderLineCode String 必须 123 淘天侧调整单明细行号 └ itemCode String 必须 7587772 商品编码 └ itemName String 必须眼霜商品名称 └ planQuantity Number 必须 2 计划调整变化量 └ sourceInventoryType String 必须 ZCQC 调整前库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;XQC=效期残;ZCC=收货暂存残-待退废;BLC=不良品/一级残次;ZCZP=收货暂存良-待退废;CZC=残值品/二级残次;FP=报废品;LQC=临期品;XTZP=销退正品;ZCQC-收货暂存待质检) └ targetInventoryType String 必须 ZP 调整后库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;XQC=效期残;ZCC=收货暂存残-待退废;BLC=不良品/一级残次;ZCZP=收货暂存良-待退废;CZC=残值品/二级残次;FP=报废品;LQC=临期品;XTZP=销退正品;YSJH-疑似假货) └ batchCode String 可选 P1234 批次编码 └ productDate String 可选 2016-09-09 商品生产日期(YYYY-MM-DD) └ expireDate String 可选 2016-09-09 商品过期日期(YYYY-MM-DD) └ produceCode String 可选 P1234 生产批号 └ snCode String 可选 X1234 商品序列号 └ secretCode String 可选 asd 暗码，分隔符,拼接 └ abnormalId String 可选 TUNXXX 异常单ID（服务商侧ID） └ extendProps Map 可选扩展信息明细行的扩展属性 └ extendProps Map 可选扩展属性

响应参数

名称	类型	示例值	描述
response	Response		返回值
└ success Boolean true 是否成功，true-成功; false-失败 └ outerOrderCode String xxx 服务商系统的移库单号 └ biz_error_code String E0001 错误编码 └ biz_error_msg String invalid app key 错误描述 └ retry Boolean fasle 是否可重试 true-可重试

请求示例

{"request":{"adjustOrderCode":"TLBXXXXX1","outBizCode":"TLBXXXXX1_STATUS","ownerCode":"AX766232","relatedTallyOrderCode":"TLBPXXX","inventoryAdjustOrderLines":[{"snCode":"X1234","planQuantity":2,"itemCode":"7587772","batchCode":"P1234","secretCode":"asd","sourceInventoryType":"ZCQC","productDate":"2016-09-09","orderLineCode":"123","produceCode":"P1234","itemName":"眼霜","abnormalId":"TUNXXX","targetInventoryType":"ZP","extendProps":"扩展信息","expireDate":"2016-09-09"}],"extendProps":"","relatedEntryOrderCode":"TLBXXXXX2","remark":"备注","warehouseCode":"STA"}}

响应示例

{
    "response":{
        "success":true,
        "outerOrderCode":"xxx",
        "biz_error_code":"E0001",
        "biz_error_msg":"invalid app key",
        "retry":fasle
    }
}

验签示例

{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部