蚂蚁进销存 / 出库流程 · 包裹 返回文档

包裹创建以复核结果为前置数据。每个包裹可装入一个或多个已复核商品行,同一商品行也可按可装包数量拆分到多个包裹中。

完整操作顺序必须为:创建包裹 → 完成打包 → 称重 → 录入面单 → 标记打印 → 发货。每一步成功后才进入下一步,避免未称重、未面单或未打印的包裹被提前发货。


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 ← 返回文档首页