开放平台接口文档
  • 基础

    • 调用方法
    • 关于鉴权
    • 业务建议
    • 文字符号
    • 返回信息代码含义
  • 物流接口

    • 预报订单
    • 获取面单
    • 费用查询
    • 取消订单
    • 批量取消订单
    • 订单轨迹
    • 预上网推送
    • 获取订单列表
    • 获取用户信息
    • 获取物流服务列表
    • 创建ScanForm
      • 请求参数
      • 提交规则
      • 返回信息
        • data 对象说明
        • 创建成功
        • 可能的错误返回
  • 仓库接口

    • 出库业务流程
    • 创建出库订单
    • 获取出库订单
    • 获取仓库列表
    • 拦截出库订单
    • 获取库存信息
    • 入库业务流程
    • 创建商品
    • 更新商品
    • 获取商品列表
    • 创建入库订单
    • 取消入库订单
    • 获取入库订单
    • 获取箱唛文件
    • 仓库扫描记录
目录

创建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
获取物流服务列表
出库业务流程

← 获取物流服务列表 出库业务流程→

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式