hhzz-inbound-order

入库单管理

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

何时使用

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

不在本 Skill 范围

不负责现场收货、库存入账或实物到仓，也不把单据下发描述为库存增加。

目标与完成边界

目标入库单能够按唯一编号查回，计划行、仓库、物料、计划数量、完成数量和状态均有查询证据。写入只完成到计划单据及其状态变化。

必要输入或前置条件

查询需要单据编号、ID 或足以收敛结果的筛选条件。写入前必须确认仓库、启用仓位、物料、单位、计划数量和唯一单据编号；用户只提供模糊描述时，先查询候选。

命令选择

• 通用筛选使用 inbound-order list；已知唯一业务编号时使用 inbound-order detail --code <编号>。
• 创建时根据当前合同选择 inbound-order create 或 inbound-order import；编辑使用 inbound-order update。
• 第一期不公开入库单下发和撤回操作，不得通过近义命令或底层接口绕过。

关键业务约束

• 创建和导入合同中的 issueFlag 必须为 false，CLI 不主动请求下发。生产租户若已启用“入库单自动下发”，服务端仍可能自动下发；审计时必须把这一影响告诉用户，无法确认租户配置时不得承诺创建后保持“新建”，执行后立即回查状态。
• 多条近似结果不得默认取第一条。“已下发”只表示收货计划进入执行阶段，不表示已经收货或库存入账。

重复执行与错误恢复

查询为空只能说明当前条件下未查到数据，可在用户同意后扩大范围。写响应异常时先按编号回查；认证、权限或状态校验失败时停止，不改用其他命令绕过。

结果与证据

返回单据编号、计划行、仓库仓位、物料、计划数量、完成数量和状态，不输出无关内部字段。