hhzz-material

物料管理

开始前阅读 ../hhzz-shared/SKILL.md。查询读取目标操作的 --help；写入先读取 hhzz-cli schema material <操作>。单位和 BOM 分别按 unit、bom 的当前 CLI 处理。

命令选择

• 通用筛选使用 material list；明确提供一个或多个编码并需要详情字段时使用 material detail。
• 用户以物料编码、名称、单位编码等外部业务字段描述新增物料时，默认使用 material import；该合同适合 Agent 从业务信息构造请求。
• 只有用户明确要求结构化创建，且能够通过查询补齐 baseInfo、unitList 及其内部 ID 关系时，才使用 material create。不得因为只创建一个物料就自动选择 create。
• 编辑使用 update，只改自定义字段使用其子操作；不得把新增请求改写成更新已有物料。

业务约束

• baseInfo.bizRange 包含 1=仓储 时顶层 inventoryInfo 必须存在；不包含仓储时不得传入该对象。
• 创建批次时，只有启用“供应商批次”属性后才能传 supplierBatch。
• 写操作先 --dry-run，授权后 --confirm，再按唯一编码查询回读；响应异常但对象已能查回时禁止重复创建。
• 物料可查回只证明主数据存在，不代表 BOM、库存或生产条件已经建立。