入库业务流程
# 仓库入库业务流程
# 流程概述
- 创建商品（如果商品不存在）
- 创建入库订单
- 获取入库订单状态
- 仓库接收货物
- 完成入库
# 详细步骤
# 1. 创建商品（可选）
POST /wms/goodsAdd
- 如果要入库的商品在系统中不存在，需要先创建商品
- 成功后获得
goods_id，用于后续创建入库订单
# 2. 创建入库订单
POST /wms/createInBoundOrder
- 调用创建入库单接口
- 需要提供发件人信息、预计到仓时间、箱子信息和产品信息
- 成功后获得
inbound_id和platform_no
# 3. 获取入库订单信息
GET /wms/getInBoundOrderList?warehouseId={仓库ID}&inbound_id={入库单ID}
- 使用
inbound_id调用接口获取入库单信息 - 检查返回的
order_status值
注意
入库订单状态说明：
order_status为1时，表示草稿状态。order_status为2时，表示待收货状态。order_status为3时，表示仓库已收货。order_status为4时，表示完成状态。order_status为5时，表示作废状态。
# 4. 取消入库订单（可选）
POST /wms/cancelInBoundOrder
- 只有在草稿状态（order_status=1）或待收货状态（order_status=2）时才能取消
- 已收货或完成状态的入库订单无法取消
# 5. 获取库存信息
GET /wms/getInventoryList?warehouseId={仓库ID}
- 入库完成后，可以通过此接口查看商品库存
- 实际可用库存数量 = qualified_num - picked_num
# 注意事项
- 创建入库订单前，确保商品已在系统中存在
- 只有草稿状态和待收货状态的订单可以取消
- 入库完成后，商品库存会自动更新
- 建议定期检查入库订单状态，及时处理异常情况
- 发件人信息要准确填写，便于仓库联系和验收货物