淘宝开放平台 - 文档中心

请求地址：

环境	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/images/product_issue_001.jpg 附件url（外部传入可浏览/下载的地址）
workOrderType	Number	可选	2		工单类型：1咨询/2投诉/3申诉/4任务（任务不接入）
judgeAmount	String	可选	89.9		认责金额
lpCode	String	可选	LP987654321CN		LP 单号（2段 LP 单号）
judgeRatio	String	可选	100		认责比例
goodsInfoList	GoodsInfoList []	可选		最大列表长度：999999	商品/包装信息列表
└ actualWeight String 可选 1080 实际重量 └ planWeightWithPackage String 可选 1100 计划重量含包材 └ packagePlanName String 可选包装方案A 包装方案名称 └ boxNo String 可选 BOX001 箱号 └ planWeightNoPackage String 可选 1000 计划重量不含包材 └ flashSale Boolean 可选 false 是否秒杀 └ protectionPlanName String 可选防护方案B 防护方案名称
sourceSystem	Number	可选	4		来源系统：1交易/2XP/3主动感知/4菜鸟/5丹鸟/6供应链工单
creatorInfo	CreatorInfo	可选			创建者信息 TmallCreatorInfoDTO
└ role Number 可选 1 角色：1消费者/2商家/3CP/6供应链系统 └ domain String 可选 83 账号类型域：83菜鸟账号/81淘宝账号 └ id String 可选 CN_USER_10001 账号ID
description	String	可选	货品临期问题，消费者反馈收到货品时距离过期不足 7 天，要求赔付处理。		工单创建描述/诉求描述
appealOriginalId	String	可选	申诉原单ID（申诉工单专有）		申诉原单ID（申诉工单专有）
externalOrderId	String	可选	TMALL_1731300000001		外部工单号（猫超侧工单ID）
logisticsOrderNo	String	可选	LOGI_202504160001		物流单号（用于服务发起的单号）
claimInfoList	ClaimInfoList []	可选		最大列表长度：999999	猫超索赔信息列表（新视图）
└ unitPrice String 可选 89.9 单价 └ planQty String 可选 1 计划件数 └ expectedCompensationUnitPrice String 可选 89.9 期望赔付单价 └ unitPriceCurrency String 可选 CNY 单价币种 └ goodsId String 可选 SKU_10001 货品ID └ dealAmount String 可选 89.9 成交金额 └ goodsAttribute String 可选常温/乳制品货品属性 └ detailId String 可选 DETAIL_001 明细 id └ claimUnitPrice String 可选 89.9 索赔单价 └ exemptType String 可选 NONE 免责类型 └ actualQty String 可选 1 实际件数 └ judgmentQty String 可选 1 仓/平台判定件数 └ compensationTotalQty String 可选 1 赔付总数 └ damageQty String 可选 0 破丢件数 └ biValue String 可选 120.0 BI 货值 └ goodsShelfType String 可选 NORMAL 货品上架类型（仓收情况） └ goodsName String 可选某品牌牛奶 250ml*12 货品名称 └ complainQty String 可选 1 投诉数量
isExceedMaxCompensation	Boolean	可选	false		整单是否超上限赔付金额
complainantInfo	ComplainantInfo	可选			投诉人信息 TmallComplainantInfoDTO
└ addressDetail String 可选世纪大道 100 号详情地址 └ province String 可选上海市省 └ city String 可选上海市市 └ district String 可选浦东新区区
sceneCode	String	可选	MC_COMPLAINT		场景 code（上游业务线 code）
tenantId	String	可选	TMALL_CS		租户 code
action	String	可选	CREATE		下发动作：CREATE/RESTART/CANCEL
claimTotalAmount	String	可选	89.9		索赔总额，精确到分
claimTotalAmountCurrency	String	可选	CNY		索赔总额币种
responsibilityPackageNos	String []	可选	责任包裹号列表	最大列表长度：999999	责任包裹号列表
appealOriginalType	String	可选	申诉原单类型（申诉工单专有）		申诉原单类型（申诉工单专有）
waybillNo	String	可选	75123456789012		运单号

名称	类型	示例值	描述
error	Number	200	错误与码
data	Data		数据
└ action String CREATE 动作 └ workOrderId Number 10000001 工单ID
message	String	操作成功	错误信息
timestamp	Number	1731300000000	时间戳
code	String	12	系统错误

{"bizType":"EXPIRATION_PROBLEM","attachments":[{"fileName":"问题货品照片1.jpg","filePath":"https://example.com/images/product_issue_001.jpg"}],"workOrderType":2,"judgeAmount":"89.9","lpCode":"LP987654321CN","judgeRatio":"100","goodsInfoList":[{"actualWeight":"1080","planWeightWithPackage":"1100","packagePlanName":"包装方案A","boxNo":"BOX001","planWeightNoPackage":"1000","flashSale":false,"protectionPlanName":"防护方案B"}],"sourceSystem":4,"creatorInfo":{"role":1,"domain":"83","id":"CN_USER_10001"},"description":"货品临期问题，消费者反馈收到货品时距离过期不足 7 天，要求赔付处理。","appealOriginalId":"申诉原单ID（申诉工单专有）","externalOrderId":"TMALL_1731300000001","logisticsOrderNo":"LOGI_202504160001","claimInfoList":[{"unitPrice":"89.9","planQty":"1","expectedCompensationUnitPrice":"89.9","unitPriceCurrency":"CNY","goodsId":"SKU_10001","dealAmount":"89.9","goodsAttribute":"常温/乳制品","detailId":"DETAIL_001","claimUnitPrice":"89.9","exemptType":"NONE","actualQty":"1","judgmentQty":"1","compensationTotalQty":"1","damageQty":"0","biValue":"120.0","goodsShelfType":"NORMAL","goodsName":"某品牌牛奶 250ml*12","complainQty":"1"}],"isExceedMaxCompensation":false,"complainantInfo":{"addressDetail":"世纪大道 100 号","province":"上海市","city":"上海市","district":"浦东新区"},"sceneCode":"MC_COMPLAINT","tenantId":"TMALL_CS","action":"CREATE","claimTotalAmount":"89.9","claimTotalAmountCurrency":"CNY","responsibilityPackageNos":["责任包裹号列表"],"appealOriginalType":"申诉原单类型（申诉工单专有）","waybillNo":"75123456789012"}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

物流API

qimen.alibaba.dchain.workorder.danniao.action (自营工单-丹鸟工单操作)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ