hhzz-outbound-order

出库单管理

开始前阅读 ../hhzz-shared/SKILL.md。查询读取目标操作的 --help；写入读取 hhzz-cli schema outbound-order <操作>。

何时使用

用户需要查询出库单，或者创建、导入和编辑发货计划时使用。

不在本 Skill 范围

第一期不开放实际出库，也不负责现场拣货、装车或实物离库。

目标与完成边界

目标出库单及明细能够查回，计划数量、完成数量和状态均有查询证据。写入只完成到计划单据及其状态变化。

必要输入或前置条件

查询需要单据编号、ID 或足以收敛结果的筛选条件。写入前必须确认仓库仓位、物料、单位、客户或其他业务关系、计划数量和唯一单据编号。

命令选择

• 通用筛选使用 outbound-order list。详情接口需要正整数 ID：先按编号查询唯一结果，再使用返回的 ID 执行 outbound-order detail。
• 创建时根据当前合同选择 outbound-order create 或 outbound-order import；编辑使用 outbound-order update。
• 第一期不公开出库单下发、撤回和实际出库操作，不得通过近义命令或底层接口绕过。

关键业务约束

• 创建和导入合同中的 issueFlag 必须为 false，不得绕过独立下发审计。
• 不把计划数量当作完成数量，也不根据单据状态推断实物已经离库。

重复执行与错误恢复

多条结果先让用户确认业务编号。写响应异常时先回查；查询为空只能说明当前条件下未查到数据，权限或状态不允许时停止。

结果与证据

返回单据编号、仓库、物料、计划数量、完成数量和状态。不能只凭单据状态宣称实物已出库。