获取面单接口
接口地址:/openapi/v1/order/label
请求方式:POST
请求数据类型:application/json
响应数据类型:application/json
接口描述: 获取面单接口、换单调用,可以通过newFlag来区分,如果为false,则每次取到的是同一个,如果为true,每次获取最新的面单
请求示例:
{
"newFlag": false,
"numbers": ["TEST001"]
}
请求参数:
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| orderLabelRequest | orderLabelRequest | body | true | ApiOrderLabelRequest | ApiOrderLabelRequest |
| newFlag | 新单标识 | true | boolean | 传true则每次获取新单 | |
| numbers | 单号(订单号/转单号/客户单号/追踪号) | true | array | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«ExpressMakingResult»» |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int64) | integer(int64) | |
| data | array | ExpressMakingResult | |
| customerOrderNo | 客户订单号 | string | |
| fileList | 文件 | array | ExpressMakingFile |
| fileUrl | oss存储的url | string | |
| labelType | 文件类型(0-面单;1-发票;) | string | |
| message | 消息 | string | |
| orderId | 订单id | string | |
| orderNo | 订单号 | string | |
| orderType | 订单类型(0-线下快递;1-平台快递) | string | |
| subSwitchNumber | 子单号 | array | string |
| success | 是否成功 | boolean | |
| switchNumber | 转单号 | string | |
| trackingNumber | 追踪号 | string | |
| message | string | ||
| success | boolean |
响应示例:
{
"code": 200,
"data": [
{
"success": true,
"message": "成功",
"orderId": "2085231574471139330",
"orderNo": "OO26080600001",
"switchNumber": "********",
"subSwitchNumber": [
"********"
],
"fileList": [
{
"labelType": "0",
"fileUrl": "https://oss.bfeservice.com/oipOut/ups/2026-08-06/*******_label.PDF"
},
{
"labelType": "1",
"fileUrl": "https://oss.bfeservice.com/oipOut/ups/2026-08-06/*******_invoice.PDF"
},
{
"labelType": "2",
"fileUrl": "https://oss.bfeservice.com/oipOut/ups/2026-08-06/*******_copy.PDF"
}
]
}
],
"message": "",
"success": true
}作者:admin 创建时间:2025-11-27 10:48
最后编辑:admin 更新时间:2026-10-16 10:03
最后编辑:admin 更新时间:2026-10-16 10:03