阿里大于 -

请求地址：

环境	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	必须			请求的根节点
└ workOrderCode String 必须 WO20260515000001 淘退工单编码、全局唯一 └ workOrderType Number 必须 2 工单类型淘退物流场景的枚举值如下：1=咨询工单 2=投诉工单 └ categoryCode String 必须 ttwlPackageBroken 工单问题分类编码淘退物流场景的枚举值如下： ● ttwlCourierPoorAttitude = 快递员态度不好 ● ttwlCourierCancelWithoutPermission = 快递员私自取消订单 ● ttwlCourierModifyPickUpTimeWithoutPermission = 快递员私自修改取件时间 ● ttwlCourierReturnFakeMailNo = 快递员虚假回单 ● ttwlUrgePickUp = 快递员什么时候来取件 ● ttwlSendDelay = 我寄的件什么时候到（发件延迟） ● ttwlDeliveryDelay = 我寄的件什么时候到（配送延迟） ● ttwlLostPackage = 包裹丢失 ● ttwlUrgeReturnMailNo = 催促运单号回传 ● ttwlPackageBroken = 包裹破损 ● ttwlDisputeShippingFee=对寄件运费不认可 ● ttwlDisputePackingFee=对寄件包装费不认可 ● ttwlOfflinePayment=线下支付 ● ttwlPackageDoesNotMatch=实际收到包裹和发出不一致 ● ttwlFakeSign=虚假签收 ● ttwlPackageInterception=包裹拦截退回 └ category String 必须包裹破损淘退物流场景的枚举值如下： ● 快递员态度不好 ● 快递员私自取消订单 ● 快递员私自修改取件时间 ● 快递员虚假回单 ● 快递员什么时候来取件 ● 我寄的件什么时候到（发件延迟） ● 我寄的件什么时候到（配送延迟） ● 包裹丢失 ● 催促运单号回传 ● 包裹破损 ● 对寄件运费不认可 ● 对寄件包装费不认可 ● 线下支付 ● 实际收到包裹和发出不一致 ● 虚假签收 ● 包裹拦截退回 └ description String 必须消费者反馈包裹外箱破损，内部商品有挤压痕迹，请核实并处理。工单问题描述工单问题的主体内容 └ bizOrderCode String 必须 RF1234567890123 业务单号 RF***** 逆向履行单号 └ mailNo String 必须 YT7654321098765 运单号 └ status Number 必须 1 工单状态枚举值如下： ● 1=处理中 ● 2=已完成 ● 3=已撤销 └ expireTime String 可选 2026-05-17 10:53:36 工单的到期时间样式：YYYY-MM-DD HH:MM:SS └ startTime String 必须 2026-05-15 10:53:36 工单的创建时间样式：YYYY-MM-DD HH:MM:SS └ priority Number 可选 2 优先紧急程度枚举值如下： ● 0=低 ● 1=中 ● 2=高 ● 3=紧急 └ extension String 可选 {"fulfillmentTaskOrder":"FT20260515001"} 扩展字段 └ operateTime String 可选 1747278850000 操作时间 └ operatorName String 可选张三操作人 goodsInfos WorkOrderGoodsInfosDTO 可选商品列表信息 goodsInfo WorkOrderGoodsInfoDTO [] 可选商品列表信息 └ skuName String 可选颜色:黑色钛金属;容量:256GB SKU名称 └ returnQuantity String 可选 1 退货数量 └ actualPaymentAmount String 可选 899900 消费者实付金额，单位分-本场景有该字段 └ returnGoodsAmount String 可选 899900 消费者退货商品总金额，单位分-本场景无该字段 └ goodsPicUrl String 可选 https://img.alicdn.com/imgextra/i1/example/goods_001.jpg 商品图片 └ goodsName String 可选 Apple iPhone 15 Pro 256GB 黑色钛金属商品名称 workOrderTask WorkOrderTask 可选节点对象 └ description String 可选请联系网点核实包裹破损情况，并在 24 小时内回传处理结果。任务问题描述内容

名称	类型	示例值	描述
response	Response		响应
└ responseMsg String 异常错误内容 └ success Boolean false 是否成功 └ responseCode String 0 错误编码

{"request":{"extension":"{\"fulfillmentTaskOrder\":\"FT20260515001\"}","workOrderType":2,"workOrderCode":"WO20260515000001","operateTime":"1747278850000","description":"消费者反馈包裹外箱破损，内部商品有挤压痕迹，请核实并处理。","bizOrderCode":"RF1234567890123","categoryCode":"ttwlPackageBroken","priority":2,"operatorName":"张三","mailNo":"YT7654321098765","goodsInfos":{"goodsInfo":[{"skuName":"颜色:黑色钛金属;容量:256GB","returnQuantity":"1","actualPaymentAmount":"899900","returnGoodsAmount":"899900","goodsPicUrl":"https://img.alicdn.com/imgextra/i1/example/goods_001.jpg","goodsName":"Apple iPhone 15 Pro 256GB 黑色钛金属"}]},"workOrderTask":{"description":"请联系网点核实包裹破损情况，并在 24 小时内回传处理结果。"},"expireTime":"2026-05-17 10:53:36","startTime":"2026-05-15 10:53:36","category":"包裹破损","status":1}}

{
    "response":{
        "responseMsg":"异常",
        "success":false,
        "responseCode":"0"
    }
}

{"success":"false","responseCode":"sign-check-failure","responseMsg":"Illegal request"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

新零售供应链API

qimen.alibaba.ascp.industry.work.order.create (工单创建下发)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ