出库业务流程
# 仓库出库(一件代发)业务流程
# 流程概述
- 创建出库订单
- 获取出库订单
# 详细步骤
# 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
中的信息