获取面单接口

接口地址:/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