出库包裹
包裹用于承载已复核商品的装箱、称重、面单、打印和发货动作。创建包裹时必须选择已复核商品行并填写本包裹数量,系统据此扣减可装包数量。
包裹创建以复核结果为前置数据。每个包裹可装入一个或多个已复核商品行,同一商品行也可按可装包数量拆分到多个包裹中。
完整操作顺序必须为:创建包裹 → 完成打包 → 称重 → 录入面单 → 标记打印 → 发货。每一步成功后才进入下一步,避免未称重、未面单或未打印的包裹被提前发货。
1 创建包裹
选择已复核商品行
创建包裹时只能选择已完成复核且仍有可装包数量的商品行。未复核、复核失败或可装包数量为 0 的商品行不可加入包裹。
| 选择方式 | 说明 |
|---|---|
| 单商品行装包 | 选择一条已复核商品行,填写本包裹数量后创建一个包裹。 |
| 多商品行装包 | 可同时选择多条已复核商品行装入同一包裹,每条商品行分别填写本包裹数量。 |
| 拆分装包 | 同一商品行可按可装包数量拆分到多个包裹,系统按已创建包裹的数量累计已装包。 |
填写本包裹数量
-
1勾选商品行
在可装包商品列表中勾选需要放入当前包裹的已复核商品行。
-
2填写本包裹数量
为每条已选商品行录入本次装入当前包裹的数量,数量必须大于 0 且不能超过该行可装包数量。
-
3提交创建
系统校验商品行和数量。校验通过后生成包裹;任一商品行数量校验失败时,整个创建请求失败且不创建包裹。
2 操作顺序
必须按顺序执行
创建包裹 → 完成打包 → 称重 → 录入面单 → 标记打印 → 发货。后续操作依赖前一步结果,不能跳步处理。
-
1创建包裹
选择已复核商品行,填写本包裹数量,创建待打包包裹。
-
2完成打包
确认包裹内商品已经实际装箱,关闭商品行调整入口。
-
3称重
录入包裹重量,作为物流计费和发货校验依据。
-
4录入面单
生成或录入快递面单信息,绑定包裹与物流单号。
-
5标记打印
确认面单已打印并贴到包裹,避免未贴单包裹进入发货。
-
6发货
确认包裹交付物流或完成出库交接,包裹进入已发货状态。
3 字段含义
| 字段 | 展示形式 | 说明 |
|---|---|---|
| 已复核数量 | 数字 | 商品行完成复核后的数量,是可装包计算的基础。 |
| 已装包 | 数字 | 该商品行已经被成功创建进包裹的累计数量,包含所有未发货和已发货包裹中的数量。 |
| 可装包 | 数字 | 当前仍可装入新包裹的数量,通常等于已复核数量减去已装包数量。 |
| 本包裹数量 | 数字输入 | 本次准备装入当前包裹的数量。每条已选商品行都需要填写,且不能超过可装包数量。 |
| 包裹重量 | 数字输入 | 完成打包后录入,用于物流称重。未录入重量时不应进入面单或发货确认。 |
| 面单号 | 文本 | 物流承运单号,可由系统生成或人工录入,用于追踪包裹配送。 |
| 打印状态 | 标签 | 标识面单是否已打印。未标记打印的包裹不应发货。 |
4 数量规则
- 创建包裹必须至少选择一条已复核商品行。
- 每条已选商品行都必须填写本包裹数量,数量必须为大于 0 的有效数字。
- 本包裹数量不能超过该商品行的可装包数量。
- 支持多商品行装入同一包裹,各商品行分别校验本包裹数量。
- 任一商品行数量超过可装包数量时,创建包裹失败,系统不创建包裹,也不扣减已装包数量。
- 包裹创建成功后,已装包数量增加,可装包数量同步减少。
失败不创建
数量超限、商品行不可装包、重复提交或数据已变更导致校验失败时,本次创建请求应整体回滚,不生成空包裹或部分成功包裹。
5 包裹卡片操作
包裹创建成功后,包裹卡片操作区重点呈现后续动作:完成打包 → 称重 → 录入面单 → 标记打印 → 发货。卡片应根据当前状态启用下一步按钮,并禁用尚不可执行的按钮。
| 操作 | 前置条件 | 处理结果 |
|---|---|---|
| 完成打包 | 包裹已创建 | 确认实物已经装箱,包裹进入待称重状态。 |
| 称重 | 已完成打包 | 录入包裹重量,包裹进入待面单状态。 |
| 录入面单 | 已称重 | 生成或保存面单号,包裹进入待打印状态。 |
| 标记打印 | 已有面单号 | 标记面单已打印,包裹进入待发货状态。 |
| 发货 | 已标记打印 | 确认包裹发货,更新包裹发货状态并记录发货结果。 |
6 相关接口
| 接口 | 触发场景 | 说明 |
|---|---|---|
| /warehouse/outbound/package/create | 创建包裹 | 提交已复核商品行和本包裹数量,校验通过后生成包裹。 |
| /warehouse/outbound/package/complete | 完成打包 | 确认包裹实物已装箱,推进到可称重状态。 |
| /warehouse/outbound/package/weigh | 称重 | 录入或更新包裹重量,作为面单和发货前置信息。 |
| /warehouse/outbound/express/generate | 录入面单 | 生成或保存快递面单信息,绑定包裹与物流单号。 |
| /warehouse/outbound/express/markPrinted | 标记打印 | 标记面单已完成打印,允许进入发货确认。 |
| /warehouse/outbound/shipping/confirmPackage | 发货 | 确认单个包裹发货,更新包裹发货状态并记录出库交接结果。 |
出库流程 · 包裹 · 更新于 2026-06-20
← 返回文档首页