跨越速运查询回单运单号API
接口说明
此接口用于查询跨越速运回单返回的运单号。按单号计费，40天内查询，同一单号只计一次费用，扣运单附件查询费用。
请求方式
POST
请求地址
| 环境 | 地址 |
|---|
| 生产 | https://api.kuaidi100.com/label/order |
请求参数（JSON Body）
| 参数 | 类型 | 是否必填 | 说明 |
|---|
method | String | 是 | 固定值：searchBackNum |
key | String | 是 | 授权 key |
sign | String | 是 | 签名 |
t | String | 是 | 时间戳 |
param | Object | 是 | 业务参数 |
param 业务参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|
customerCode | String | 是 | 寄件客户编码（联系跨越获取） |
waybillNumber | String | 是 | 运单号 |
请求示例
{
"method": "searchBackNum",
"key": "your_api_key",
"param": "{\"customerCode\":\"02106542168\",\"waybillNumber\":\"15926542507\"}",
"sign": "CF529FFB8B49499EC30BE2C29C02AE67",
"t": "1715678901234"
}
响应参数
| 参数 | 类型 | 说明 |
|---|
code | Number | 状态码（200 成功） |
message | String | 提示信息 |
success | Boolean | 是否成功 |
time | Number | 响应时间（毫秒） |
data | Object | 返回数据（成功时） |
data 对象
| 参数 | 类型 | 说明 |
|---|
kuaidinum | String | 运单号（原始发货快递单号） |
backOrderNo | String | 回单号（签收后生成的回单返回号） |
backOrderCount | Number | 回单份数 |
backOrderStatus | String | 回单标识：10-回单原件，20-无回单，30-回单图片，40-电子回单 |
响应示例（成功）
{
"code": 200,
"data": {
"kuaidinum": "KY4001060565538",
"backOrderNo": "KY4001056559726",
"backOrderCount": 1,
"backOrderStatus": "10"
},
"message": "success",
"time": 0,
"success": true
}
响应示例（失败）
{
"code": 30005,
"message": "运单号不存在",
"success": false,
"time": 0
}
错误码
| code | message | 说明 |
|---|
200 | 成功 | 查询成功 |
30001 | customerCode不能为空 | 缺少客户编码 |
30001 | waybillNumber不能为空 | 缺少运单号 |
30005 | 运单号不存在 / 查询失败 | 跨越速运返回无数据 |
500 | 系统异常: xxx | 系统内部错误 |
