淘宝开放平台 - 文档中心

请求地址：

环境	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		业务类型（id/枚举，通过映射关系获取）
attachments	Attachments []	可选		最大列表长度：999999	附件（外部可浏览/下载 URL，后端转存）
└ fileName String 可选问题货品照片1.jpg 附件名称 └ filePath String 可选 https://example.com/attachment/photo1.jpg 附件url（外部传入可浏览/下载的地址）
workOrderType	Number	可选	2		工单类型：1咨询/2投诉/3申诉/4任务（任务不接入）
lpCode	String	可选	LP987654321CN		LP 单号（2段 LP 单号）
sourceSystem	Number	可选	4		来源系统：1交易/2XP/3主动感知/4菜鸟/5丹鸟/6供应链工单
creatorInfo	CreatorInfo	可选			创建者信息 TmallCreatorInfoDTO
└ role Number 可选 1 角色：1消费者/2商家/3CP/6供应链系统（落库仅取1、2，其余归类"其他"） └ domain String 可选 83 账号类型域：83菜鸟账号/81淘宝账号（丹鸟不回推） └ id String 可选 CN_USER_10001 账号ID
claimAmount	String	可选	8990		判责金额
claimInfoList	ClaimInfoList	可选			直判索赔信息（简化版）
└ unitPrice String 可选 7.49 单价 └ expectedCompensationUnitPrice String 可选 7.49 期望赔付单价 └ unitPriceCurrency String 可选 CNY 单价币种 └ totalQty String 可选 1 总数 └ complaintQty String 可选 1 投诉数量 └ goodsId String 可选 SKU_10001 货品ID └ detailId String 可选 DETAIL_001 明细 id └ claimUnitPrice String 可选 7.49 索赔单价 └ goodsName String 可选某品牌牛奶 250ml*12 货品名称 └ judgmentQty String 可选 1 索赔数量
description	String	可选	直判工单测试：货品临期问题，消费者反馈收到时距离过期不足7天，建议赔付并结案。		工单创建描述/诉求描述
appealOriginalId	String	可选	APPEAL_20250416_001		申诉原单ID（申诉工单专有）
logisticsOrderNo	String	可选	LOGI_202504160001		物流单号（用于服务发起的单号，与 lpCode 不同）
externalOrderId	String	可选	TMALL_DIRECT_20250416_001		外部工单号（猫超侧工单ID）
judgeResult	JudgeResult	可选			判责结果
└ established Boolean 可选 true 是否成立 └ responsibilityWaybillNo String 可选 75123456789012 责任运单号 └ deliveryRatio String 可选 0 配送责任比例 └ responsibilityParty String 可选 WAREHOUSE 责任方 └ claimAmount String 可选 89.9 判责金额 └ judgeReason String 可选仓内拣选导致临期，责任归属仓库方判责原因 └ warehouseRatio String 可选 100 仓方责任比例 └ compensationType String 可选 REFUND 赔付类型
externalBizLine	String	可选	MC_COMPLAINT		外部业务线
claimAmountCurrency	String	可选	CNY		索赔总额币种
isExceedMaxCompensation	Boolean	可选	false		整单是否超上限赔付金额
externalCreateTime	Number	可选	1744800000000		外部创建时间（毫秒）
tenantId	String	可选	TMALL_CS		租户 code
responsibilityPackageNos	String []	可选	责任包裹号列表	最大列表长度：999999	责任包裹号列表
appealOriginalType	String	可选	COMPLAINT		申诉原单类型（申诉工单专有）
paymentInfo	PaymentInfo	可选			赔付信息
└ payee String 可选 CN_USER_10001 收款方 └ paymentFlowNo String 可选 PAY_20250416_001 赔付流水工单号（赔付出账工单号） └ payer String 可选 TMALL_WAREHOUSE 付款方（固定值，无需回传） └ paymentChargeTime Number 可选 1744800005000 赔付出账时间（毫秒时间戳） └ paymentAmount String 可选 89.9 赔付出账金额 └ paymentStatus String 可选 SUCCESS 赔付状态（是否成功） └ paymentCreateTime Number 可选 1744800000000 赔付创建时间（毫秒时间戳）
waybillNo	String	可选	75123456789012		运单号

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

{"bizType":"EXPIRATION_PROBLEM","attachments":[{"fileName":"问题货品照片1.jpg","filePath":"https://example.com/attachment/photo1.jpg"}],"workOrderType":2,"lpCode":"LP987654321CN","sourceSystem":4,"creatorInfo":{"role":1,"domain":"83","id":"CN_USER_10001"},"claimAmount":"8990","description":"直判工单测试：货品临期问题，消费者反馈收到时距离过期不足7天，建议赔付并结案。","appealOriginalId":"APPEAL_20250416_001","logisticsOrderNo":"LOGI_202504160001","externalOrderId":"TMALL_DIRECT_20250416_001","judgeResult":{"established":true,"responsibilityWaybillNo":"75123456789012","deliveryRatio":"0","responsibilityParty":"WAREHOUSE","claimAmount":"89.9","judgeReason":"仓内拣选导致临期，责任归属仓库方","warehouseRatio":"100","compensationType":"REFUND"},"externalBizLine":"MC_COMPLAINT","claimAmountCurrency":"CNY","claimInfoList":[{"unitPrice":"7.49","judgmentQty":"1","expectedCompensationUnitPrice":"7.49","unitPriceCurrency":"CNY","totalQty":"1","complaintQty":"1","goodsId":"SKU_10001","detailId":"DETAIL_001","claimUnitPrice":"7.49","goodsName":"某品牌牛奶 250ml*12"}],"isExceedMaxCompensation":false,"externalCreateTime":0,"tenantId":"TMALL_CS","responsibilityPackageNos":["责任包裹号列表"],"appealOriginalType":"COMPLAINT","paymentInfo":{"payee":"CN_USER_10001","paymentFlowNo":"PAY_20250416_001","payer":"TMALL_WAREHOUSE","paymentChargeTime":0,"paymentAmount":"89.9","paymentStatus":"SUCCESS","paymentCreateTime":0},"waybillNo":"75123456789012"}

{
    "success":true,
    "data":{
        "workOrderId":10000001
    },
    "message":"操作成功",
    "timestamp":1731300000000,
    "errorId":"12",
    "code":"0"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

物流API

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ