创建ScanForm
POST /order/makeScanForm
# 请求参数
请求参数列表:
| 参数名称 | 必须 | 描述 | 类型 |
|---|---|---|---|
| tracking_number | 是 | 要生成 ScanForm 的运单号列表 | Array[String] |
完整请求 body 示例:
{
"tracking_number": ["940011189922...", "940011189933..."]
}
# 提交规则
发件地址不一样不能创建到一起 物流服务不一样不能创建到一起
# 返回信息
响应参数列表:
| 参数名称 | 描述 | 类型 |
|---|---|---|
| code | 状态码 | Number |
| msg | 返回信息 | String |
| data | 返回数据对象 | Object |
# data 对象说明
| 参数名称 | 描述 | 类型 |
|---|---|---|
| scanform_label | ScanForm PDF 路径(返回 pdf_path),拼接API网关地址后下载 | String |
# 创建成功
完整响应数据示例:
{
"code": 200,
"msg": "ScanForm 创建成功",
"data": {
"scanform_label": "/upload/pdf/20260105/scanform_xxx.pdf"
}
}
# 可能的错误返回
tracking_number为空:缺少运单号: tracking_number- 运单号不存在:
tracking_number运单号不存在 - 运单不支持创建:
tracking_number当前运单不支持创建ScanForm - 已创建:
tracking_number已经创建ScanForm不能重复创建 - 渠道接口失败:生成失败 或渠道返回的
msg