韵达开放平台 API
接口简介
API鉴权说明
快递投放
校验运单号手机号
POST
禁投第三方校验
POST
电子面单
包裹信息接入
POST
电子面单取消
POST
电子面单下单
POST
电子面单余量查询
POST
电子面单更新
POST
电子面单打印
POST
停发查询
POST
散件下单
运单推送接口
POST
取消散件订单（新）
POST
预估运费
POST
散件下单(新)
POST
物流轨迹
物流轨迹推送
POST
物流轨迹查询
POST
物流轨迹订阅
POST
售后服务
物流工单下发
POST
国际件
国际进口下单
POST
外部发券
外部直发券
POST
发券结果查询
POST
电子面单取消开发中
POST/openapi-api/v1/accountOrder/cancelBmOrder
创建时间: 2025-06-03 00:39
请求参数
Header 参数
| 参数名 | 示例值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| app-key | {{app-key}} | 是 | string | 开放平台发放 |
| sign | {{sign}} | 是 | string | 签名说明参看附录《鉴权说明》 |
| req-time | {{$timestamp}} | 是 | string | 当前时间戳（毫秒） |
Body 参数application/json
数据结构
appidstring
必填
合作商appid（等同app-key）
partner_idstring
必填
电子面单账号（韵达业务方提供）
secretstring
必填
电子面单账号秘钥（韵达业务方提供）
ordersarray<object>
必填
订单详情
order_serial_nostring
可选
客户订单号 由字母、数字、下划线组成，必须保证唯一，请对特殊符号进行过滤
mailnostring
可选
运单号
示例数据
{
"appid": "999999",
"partner_id": "YUNDA",
"secret": "a123456",
"orders": [
{
"order_serial_no": "2012121715001",
"mailno": "5100709876543"
}
]
}响应示例
成功
HTTP状态码：200
内容格式：JSON
数据结构
resultboolean
可选
请求是否成功
codestring
可选
响应编码
messagestring
可选
响应内容
dataobject
可选
返回对象信息
order_serial_nostring
可选
订单唯一序列号
mailnostring
可选
筛单成功，则不为空；筛单失败，则为空
statusstring
可选
返回状态，1表示成功，0表示失败
msgstring
可选
成功或者错误的提示信息
响应示例
{
"code": "0000",
"message": "请求成功",
"result": true,
"data": [
{
"order_serial_no": "2012121715001",
"mail_no": "5100709876543",
"status": "1",
"msg": "订单取消成功",
}
]
}失败
HTTP状态码：200
内容格式：JSON
数据结构
resultboolean
可选
请求是否成功
codestring
可选
响应编码
messagestring
可选
响应内容
dataobject
可选
返回对象信息
order_serial_nostring
可选
订单唯一序列号
mailnostring
可选
筛单成功，则不为空；筛单失败，则为空
statusstring
可选
返回状态，1表示成功，0表示失败
msgstring
可选
成功或者错误的提示信息
响应示例
{
"result": false,
"code": "7777",
"message": "内部接口服务失败",
"sub_code" "s10",
"sub_msg": "参数校验不合法"
}最后更新: -