API文档
使用手册
API文档
使用手册
  • 简介
  • 使用说明
  • 订单API

    • 创建订单
    • 取消订单
    • 生成ScanForm单据
    • 获取Fba仓
    • 获取用户信息
    • 获取订单信息列表数据
    • 获取面单
    • 费用试算
    • 推送订单物流轨迹协议
    • 根据物流单号获取面单信息
  • 运营API

    • 运营
    • 运营api

获取面单

场景说明

在订单已预报状态时可以返回订单面单标签数据,当返回的响应码为 202 时,表示订单正在预报物流中,需要等待预报物流完成之后才有跟踪号信息

接口名

{域名}/api/svc/getLabel

请求方式

POST

Header请求头

参数名是否必填类型说明
Authorization是string授权码:访问授权 Token

请求参数

参数名二级参数名是否必填类型说明
reference_no否string参考号 订单号与参考号传其一即可
order_code否string订单编号 订单号与参考号传其一即可

输入示例(body)


{
  "order_code": "XXXXXX",
  "reference_no":"XXXXXX"
}


返回参数

参数名二级参数名是否必填类型说明
code-是string响应码,200-成功
result-是object响应结果
msg-是string响应消息
-resultreference_no是string参考号, 用户传入的客户订单号
-resultorder_code是string订单号, 我司系统唯一单号
-resultorder_address_type是stringCommercial 商业 Residential 住宅
-resultorder_status是integer订单状态, 2 已预报 1已提交 3.已预报 4问题件
-resultorder_sub_status是integer
-resultorder_waiting_status是integer
-resultsync_service_status是integer
-resultlogistics_err是string错误信息
-resultlabels是array面单信息
-result.labelstracking_number是string物流单号
-result.labelstracking_number2否string物流单号, UPS MI时产品返回USPS单号,其余产品不返回
-result.labelslabel_url否string面单地址
-result.labelsfile_type否string面单类型
-resultfee是array总费用信息
-result.feeft_code是string费用英文名称
-result.feeamount是string金额
-result.feecurrency_code是string币种
-result.feeft_name是string费用中文名称
-resultfee_detail是array费用详情
-result.fee_detailft_code是string费用英文名称
-result.fee_detailamount是string金额
-result.fee_detailtracking_number是string物流单号
-result.fee_detailbox_code是string箱号
-result.fee_detailcurrency_code是string币种
-result.fee_detailft_name是string费用中文名称

输出示例

{
  "code": 200,
  "result": {
    "reference_no": "XXXXXX",
    "order_code": "XXXXXX",
    "order_address_type": "Commercial",
    "order_status": 2,
    "order_sub_status": 0,
    "order_waiting_status": 0,
    "sync_service_status": 1,
    "logistics_err": "",
    "labels": [
      {
        "tracking_number": "XXXXXX",
        "tracking_number2": "XXXX",
        "label_url": "http://XXXX.pdf",
        "file_type": "pdf"
      }
    ],
    "merge_label": "http://XXXXXX.pdf",
    "fee": [
      {
        "ft_code": "shipping",
        "amount": "1.00",
        "currency_code": "USD",
        "ft_name": "运费"
      },
      {
        "ft_code": "FSC",
        "amount": "0.01",
        "currency_code": "USD",
        "ft_name": "燃油附加费"
      }
    ],
    "fee_detail": [
      {
        "ft_code": "shipping",
        "amount": "1.00",
        "tracking_number": "XXXXXX",
        "box_code": "XXXXXX-1",
        "currency_code": "USD",
        "ft_name": "运费"
      },
      {
        "ft_code": "FSC",
        "amount": "0.01",
        "tracking_number": "XXXXXX",
        "box_code": "XXXXXX-1",
        "currency_code": "USD",
        "ft_name": "燃油附加费"
      }
    ]
  },
  "msg": "Success"
}
最近更新:: 2025/9/29 14:14
Contributors: lizhi
上一页
获取订单信息列表数据
下一页
费用试算