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

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

自营工单创建-丹鸟工单操作，用于创建、驳回、取消

公共参数

请求地址：

环境	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		业务类型
attachments	Attachments []	可选		最大列表长度：999999	附件
└ filePath String 可选 https://xxx.com/image/abc.jpg 文件路径 └ realFileName String 可选问题货品照片1 文件名称
workOrderType	Number	可选	2		工单类型
lpCode	String	可选	LP123456789CN		二段LP
goodsInfoList	GoodsInfoList []	可选		最大列表长度：999999	货品列表
└ actualWeight Number 可选 1080 重量 └ planWeightWithPackage Number 可选 1100 包装方案 └ packagePlanName String 可选包装方案A 包装方案名称 └ boxNo String 可选 BOX001 箱号 └ planWeightNoPackage Number 可选 1000 计划重量含包材 └ flashSale Boolean 可选 false 是否秒杀 └ protectionPlanName String 可选防护方案B 防护方案名称
sourceSystem	Number	必须	4		来源系统
creatorInfo	CreatorInfo	必须			创建者信息
└ role Number 可选 1 角色 └ domain String 可选 83 域 └ id String 可选 CN_USER_10001 ID
description	String	可选	货品临期问题，消费者反馈收到货品时距离过期不足 7 天。		描述
externalOrderId	String	必须	TMALL_1234567890		外部工单号
logisticsOrderNo	String	可选	LOGI_202501010001		履行单号
claimInfoList	ClaimInfoList []	可选		最大列表长度：999999	猫超索赔信息
└ planQty Number 可选 1 计划件数 └ damageQty Number 可选 0 破丢件数 └ biValue Number 可选 120.0 BI 货值 └ goodsId String 可选 SKU_10001 货品ID └ dealAmount Number 可选 89.9 成交金额 └ claimAmount Number 可选 89.9 索赔金额 └ exemptType String 可选 NONE 免责类型 └ goodsName String 可选某品牌牛奶 250ml*12 货品名称 └ actualQty Number 可选 1 实际件数 └ detailId String 可选 LVDOxxx 明细ID
complainantInfo	ComplainantInfo	可选			投诉人信息
└ senderPhone String 可选 13800000000 发件人电话 └ senderName String 可选张三发件人姓名 └ receiverPhone String 可选 13900000000 收件人电话 └ addressDetail String 可选世纪大道 100 号详情地址 └ province String 可选上海市省 └ city String 可选上海市市 └ receiverName String 可选李四收件人姓名 └ district String 可选浦东新区区 └ complainantPhone String 可选 13800000000 投诉人号码
sceneCode	String	可选	MC_COMPLAINT		场景 code
action	String	必须	CREATE		操作
waybillNo	String	可选	75123456789012		运单号
tenantId	String	必须	MAOCHAO		账套
judgeRatio	Number	可选	90		认责比例
judgeAmount	Number	可选	10		认责金额

响应参数

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

请求示例

{"bizType":"EXPIRATION_PROBLEM","attachments":[{"filePath":"https://xxx.com/image/abc.jpg","realFileName":"问题货品照片1"}],"workOrderType":2,"lpCode":"LP123456789CN","judgeAmount":10,"goodsInfoList":[{"actualWeight":1080,"planWeightWithPackage":1100,"packagePlanName":"包装方案A","boxNo":"BOX001","planWeightNoPackage":1000,"flashSale":false,"protectionPlanName":"防护方案B"}],"judgeRatio":90,"sourceSystem":4,"creatorInfo":{"role":1,"domain":"83","id":"CN_USER_10001"},"description":"货品临期问题，消费者反馈收到货品时距离过期不足 7 天。","externalOrderId":"TMALL_1234567890","logisticsOrderNo":"LOGI_202501010001","claimInfoList":[{"planQty":1,"damageQty":0,"biValue":0,"goodsId":"SKU_10001","dealAmount":0,"claimAmount":0,"detailId":"LVDOxxx","exemptType":"NONE","goodsName":"某品牌牛奶 250ml*12","actualQty":1}],"complainantInfo":{"senderPhone":"13800000000","senderName":"张三","receiverPhone":"13900000000","addressDetail":"世纪大道 100 号","province":"上海市","city":"上海市","receiverName":"李四","district":"浦东新区","complainantPhone":"13800000000"},"sceneCode":"MC_COMPLAINT","tenantId":"MAOCHAO","action":"CREATE","waybillNo":"75123456789012"}

响应示例

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

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

物流API

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ