📦 接口文档

🌐 English Version

对外 API 接口说明：

1：使用 vendor-token 请求头鉴权，请联系业务经理。

2：使用 域名，请联系业务经理。

POST scan-form 批量扫描汇总单

地址：/api/order/scan-form　·　说明：将同一渠道下一批「已打印」订单的跟踪号汇总成一张扫描单（如 USPS Scan Form），便于一次扫描入网。仅支持实现了 scanForm 的渠道（其余渠道会明确报错）。

使用条件：
  1. 仅部分渠道服务支持该接口，具体是否可用请咨询业务经理确认。
  2. 所关联订单的 ship_date 必须是今天之后的日期（即晚于当前日期，不含今天）。

参数说明

参数 必填 类型 说明
order_id 二选一 array / string 订单 ID 列表。与 order_no 二选一。值可为数组，或以英文分号（;）分隔的字符串（后端另兼容逗号 / 换行 / 空白分隔）。纯整型值按 order_id 查询，仅当前客户名下「已打印」订单有效。
order_no 二选一 array / string 订单号列表。与 order_id 二选一。值与分隔规则同上；非纯整型值按 order_no 查询。

请求示例

POST /api/order/scan-form
Header: vendor-token: xxxxx
Content-Type: application/json
{
    "order_id": [1024, 1025, 1026]
}
POST /api/order/scan-form
Header: vendor-token: xxxxx
Content-Type: application/json
{
    "order_no": "AB20240101;AB20240102;AB20240103"
}

返回示例（data 为渠道统一返回结构）

{
    "success": true,
    "message": "批量扫描汇总单创建成功！",
    "code": 200,
    "data": {
        "scanFormNo": "SF1234567890",   // 扫描单号
        "scanFormLabel": "https://cdn.example.com/scanform/SF1234567890.pdf"  // 扫描单面单地址
    }
}