淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
bizType	String	可选	EXPIRATION_PROBLEM		业务类型
workOrderType	Number	可选	2		工单类型
lpCode	String	可选	LP123456789CN		二段LP单
sourceSystem	Number	可选	4		来源系统
creatorInfo	CreatorInfo	可选			创建人
└ role Number 可选 1 角色 └ domain String 可选 83 域 └ id String 可选 CN_USER_10001 用户ID
claimInfo	ClaimInfo	可选			直判索赔信息
└ unitPrice Number 可选 7.49 单价 └ isExceedMaxCompensation Boolean 可选 false 整单是否超上限赔付金额 └ expectedCompensationUnitPrice Number 可选 7.49 期望赔付单价 └ unitPriceCurrency String 可选 CNY 单价币种 └ totalQty Number 可选 1 总数 └ complaintQty Number 可选 1 投诉数量 └ goodsId String 可选 SKU_10001 货品ID └ claimAmount Number 可选 749 索赔总额 └ claimUnitPrice Number 可选 7.49 索赔单价 └ goodsName String 可选某品牌牛奶 250ml*12 货品名称 └ claimAmountCurrency String 可选 CNY 索赔总额币种
description	String	可选	直判：仓内临期问题，建议赔付并结案。		工单创建描述
logisticsOrderNo	String	可选	LOGI_202501010001		物流单号
externalOrderId	String	可选	TMALL_1234567890		供应链下发工单单号
judgeResult	JudgeResult	可选			判责信息
└ established Boolean 可选 true 是否成立 └ responsibilityWaybillNo String 可选 75123456789012 责任运单号 └ deliveryRatio Number 可选 0 配送责任比例 └ responsibilityParty String 可选 WAREHOUSE 责任方 └ claimAmount Number 可选 89.9 索赔金额 └ judgeReason String 可选仓内拣选导致临期判责原因 └ warehouseRatio Number 可选 100 仓方责任比例 └ compensationType String 可选 REFUND 赔付类型
responsibilityPackageNos	String []	可选		最大列表长度：999999	责任包裹号列表
paymentInfo	PaymentInfo	可选			赔付信息
└ payee String 可选 CN_USER_10001 收款方 └ paymentFlowNo String 可选 PAY_202501010001 赔付流水工单号 └ paymentChargeTime Number 可选 1731300005000 赔付出账时间 └ paymentAmount Number 可选 89.9 赔付出账金额 └ paymentStatus String 可选 SUCCESS 赔付状态 └ paymentCreateTime Number 可选 1731300000000 赔付创建时间
waybillNo	String	可选	75123456789012		运单号
tenantId	String	可选	MAOCHAO		账套ID

名称	类型	示例值	描述
error	String	200	错误
data	Data		数据
└ workOrderId Number 10000001 单号
errorMessage	String	操作成功	错误信息
timestamp	Number	1731300000000	时间戳
errorId	String	12	错误ID

{"bizType":"EXPIRATION_PROBLEM","workOrderType":2,"lpCode":"LP123456789CN","sourceSystem":4,"creatorInfo":{"role":1,"domain":"83","id":"CN_USER_10001"},"claimInfo":{"unitPrice":0,"isExceedMaxCompensation":false,"expectedCompensationUnitPrice":0,"unitPriceCurrency":"CNY","totalQty":1,"complaintQty":1,"goodsId":"SKU_10001","claimAmount":749,"claimUnitPrice":0,"goodsName":"某品牌牛奶 250ml*12","claimAmountCurrency":"CNY"},"description":"直判：仓内临期问题，建议赔付并结案。","logisticsOrderNo":"LOGI_202501010001","externalOrderId":"TMALL_1234567890","judgeResult":{"established":true,"responsibilityWaybillNo":"75123456789012","deliveryRatio":0,"responsibilityParty":"WAREHOUSE","claimAmount":0,"judgeReason":"仓内拣选导致临期","warehouseRatio":100,"compensationType":"REFUND"},"tenantId":"MAOCHAO","responsibilityPackageNos":[""],"paymentInfo":{"payee":"CN_USER_10001","paymentFlowNo":"PAY_202501010001","paymentChargeTime":0,"paymentAmount":0,"paymentStatus":"SUCCESS","paymentCreateTime":0},"waybillNo":"75123456789012"}

{
    "error":"200",
    "data":{
        "workOrderId":10000001
    },
    "errorMessage":"操作成功",
    "timestamp":1731300000000,
    "errorId":"12"
}

{"errorMessage":"Illegal request","errorId":"sign-check-failure","error":"500"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

物流API

qimen.alibaba.dchain.workorder.danniao.judge (自营工单-丹鸟判责)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ