开放平台接口文档
  • 基础

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

    • 预报订单
    • 获取面单
    • 费用查询
    • 取消订单
    • 批量取消订单
    • 订单轨迹
    • 预上网推送
    • 获取订单列表
    • 获取用户信息
    • 获取物流服务列表
  • 仓库接口

    • 出库业务流程
      • 流程概述
      • 详细步骤
        • 1. 创建出库订单
        • 2. 获取出库订单信息
        • 成功情况 (pws_status = 2)
        • 失败情况 (pws_status = 6)
      • 注意事项
    • 创建出库订单
    • 获取出库订单
    • 获取仓库列表
    • 拦截出库订单
    • 获取入库订单
    • 获取库存信息
  • 基础
  • 仓库接口
Admin
2024-09-10
目录

出库业务流程

# 仓库出库(一件代发)业务流程

# 流程概述

  1. 创建出库订单
  2. 获取出库订单

# 详细步骤

# 1. 创建出库订单

POST /wms/createOrder

  • 在此之前要先获取用户可用的仓库ID
  • 调用创建出库单接口
  • 成功后获得 outbound_id

# 2. 获取出库订单信息

GET /wms/getOrderList?warehouseId={仓库ID}&outbound_id={出库单ID}

  • 使用 outbound_id 调用接口获取出库单信息
  • 检查返回的 pws_status 值

注意

出单时间根据不同的物流渠道,会有所不同。
建议间隔3-10秒获取一次状态
当 pws_status 为1时,表示运单创建中。
当 pws_status 为2时,表示运单创建成功。

# 成功情况 (pws_status = 2)

表示运单创建成功。此时可以获取以下信息:

{
"tracking_number": "9200190217128900009095",
"label_url": "/upload/pdf/20231120/9200190217128900009095.pdf"
}
  • 使用 label_url 下载面单(需要与接口地址拼接)

# 失败情况 (pws_status = 6)

表示运单创建失败:

  • 运单购买失败,错误信息在 error_body 字段中
  • 仓库端的错误和提示在 tips 字段中

# 注意事项

  • 确保正确处理 pws_status
  • 下载面单时需要将 label_url 与接口基础地址拼接
  • 对于失败情况,应当适当处理并显示 error_body 和 tips 中的信息
获取物流服务列表
创建出库订单

← 获取物流服务列表 创建出库订单→

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