其他出入库模块，由 yudao-module-mes 后端模块的 wm.miscissue、wm.miscreceipt 包实现，用于处理不属于常规采购、生产、销售、外协链路的杂项出入库场景（如库存调整、报废出库、样品入库等）。

本文涉及两个子模块：

• 其他出库：将仓库物料以非常规原因出库（如库存调整、报废出库）。行表中直接指定出库库位。
• 其他入库：将物料以非常规原因入库到仓库。行表中直接指定入库库位。

本文涉及表如下图所示：

1. 其他出库

其他出库，由 MesWmMiscIssueController 提供接口。

1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_wm_misc_issue` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `code` varchar(64) NOT NULL COMMENT '出库单编码',
  `name` varchar(255) DEFAULT NULL COMMENT '出库单名称',
  `type` tinyint DEFAULT NULL COMMENT '出库类型',

  `source_doc_id` bigint DEFAULT NULL COMMENT '来源单据ID',
  `source_doc_code` varchar(64) DEFAULT NULL COMMENT '来源单据编号',
  `source_doc_type` varchar(64) DEFAULT NULL COMMENT '来源单据类型',

  `issue_date` datetime DEFAULT NULL COMMENT '出库日期',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 其他出库单';

① type 为出库类型，枚举 MesWmMiscIssueTypeEnum（1=库存调整，2=报废出库）。

② source_doc_id、source_doc_code、source_doc_type 为来源单据信息（选填），用于追溯该出库单的业务来源。

③ status 为出库单状态，枚举 MesWmMiscIssueStatusEnum：

状态值	枚举	说明	可执行操作
0	PREPARE	草稿	编辑、提交、删除
3	APPROVED	待执行出库	执行出库、取消
4	FINISHED	已完成	—
5	CANCELED	已取消	—

状态流转说明

创建 ──→ 草稿(0) ──提交──→ 待执行出库(3) ──执行出库──→ 已完成(4)
                                              │
                                              └──取消──→ 已取消(5)

• 创建（createMiscIssue）：创建其他出库单，初始状态为草稿。
• 提交（submitMiscIssue）：校验出库行不能为空，状态变为「待执行出库」。
• 执行出库（finishMiscIssue）：产生库存事务（OUT 出库），扣减库存台账（mes_wm_material_stock）。
• 取消（cancelMiscIssue）：已完成和已取消状态不允许取消，其他状态均可取消。

与常规出库的区别

其他出库的流程没有拣货环节。出库行中直接指定仓库/库区/库位，提交后即��执行出库。适用于库存调整、报废等简单出库场景。

---

该表包含一个子表：

• mes_wm_misc_issue_line（出库行）：在新增/编辑弹窗中维护，记录出库物料、数量和出库库位。

1.2 管理后台

对应 [MES 系统 -> 仓库管理 -> 其他出库] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/wm/miscissue 目录。

列表

支持按出库单编码、名称、业务类型、来源单据类型、来源单据编号、出库日期、状态等条件搜索。

新增

点击【新增】按钮，弹出其他出库新增表单。主要填写出库单编码（可自动生成）、出库单名称、出库类型、来源单据信息（选填）、出库日期。新建成功后弹窗自动切换为编辑模式，在表单下方展示出库行列表。

修改

点击编码链接或【编辑】按钮（仅草稿状态可编辑），弹出其他出库修改表单。表单下方通过 el-divider 分隔展示出库行列表。

★ 出库行（编辑弹窗下方）：由 mes_wm_misc_issue_line 表存储，记录出库物料、数量和出库库位。由 MesWmMiscIssueLineController 提供接口。

mes_wm_misc_issue_line 表结构

CREATE TABLE `mes_wm_misc_issue_line` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `issue_id` bigint NOT NULL COMMENT '出库单ID',
  `source_doc_line_id` bigint DEFAULT NULL COMMENT '来源单据行ID',

  `item_id` bigint NOT NULL COMMENT '物料ID',
  `quantity` decimal(14,2) NOT NULL COMMENT '出库数量',

  `material_stock_id` bigint DEFAULT NULL COMMENT '库存记录ID',
  `batch_id` bigint DEFAULT NULL COMMENT '批次ID',
  `batch_code` varchar(64) DEFAULT NULL COMMENT '批次号',

  `warehouse_id` bigint NOT NULL COMMENT '仓库ID',
  `location_id` bigint NOT NULL COMMENT '库区ID',
  `area_id` bigint NOT NULL COMMENT '库位ID',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 其他出库单行';

① issue_id 关联主表 mes_wm_misc_issue 的 id 字段。source_doc_line_id 关联来源单据行（选填）。

② item_id 关联 mes_md_item 表的 id 字段，标识出库物料。quantity 为出库数量。

③ material_stock_id 关联 mes_wm_material_stock（选填）。batch_id、batch_code 关联批次管理（选填）。

④ warehouse_id、location_id、area_id 指定出库的仓库/库区/库位。在行表中直接指定，无需单独的拣货明细。

提交

在编辑弹窗中点击【提交】按钮（仅草稿状态下显示）。系统会先检查表单是否有修改（脏检查），有修改则先保存再提交。提交后主表不可再修改。

执行出库

在「待执行出库」状态下，点击【执行出库】按钮。系统通过 MesWmMiscIssueServiceImpl 的 finishMiscIssue 方法，遍历所有出库行，批量创建 OUT 库存事务，扣减库存台账。

已知问题

当前 finishMiscIssue 在构建库存事务请求时，未将出库行的 batchId/batchCode 传递给事务服务，导致生成的 mes_wm_transaction 记录丢失批次维度。如果业务依赖库存事务按批次追溯，需要修复 createTransactionList 方法补传批次字段。

状态变为「已完成」。

取消

在列表页点击【取消】按钮（已完成和已取消状态不允许取消，其他状态均可取消），需二次确认��取消后不可恢复。

2. 其他入库

其他入库，由 MesWmMiscReceiptController 提供接口。

2.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_wm_misc_receipt` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `code` varchar(64) NOT NULL COMMENT '入库单编码',
  `name` varchar(255) DEFAULT NULL COMMENT '入库单名称',
  `type` tinyint DEFAULT NULL COMMENT '入库类型',

  `source_doc_id` bigint DEFAULT NULL COMMENT '来源单据ID',
  `source_doc_code` varchar(64) DEFAULT NULL COMMENT '来源单据编号',
  `source_doc_type` varchar(64) DEFAULT NULL COMMENT '来源单据类型',

  `receipt_date` datetime DEFAULT NULL COMMENT '入库日期',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 其他入库单';

① type 为入库类型（选填），用于分类标识入库原因。

② source_doc_id、source_doc_code、source_doc_type 为来源单据信息（选填），用于追溯该入库单的业务来源。

③ status 为入库单状态，枚举 MesWmMiscReceiptStatusEnum：

状态值	枚举	说明	可执行操作
0	PREPARE	草稿	编辑、提交、删除
3	APPROVED	已审批	执行入库、取消
4	FINISHED	已完成	—
5	CANCELED	已取消	—

状态流转说明

创建 ──→ 草稿(0) ──提交──→ 已审批(3) ──执行入库──→ 已完成(4)
                                          │
                                          └──取消──→ 已取消(5)

• 创建（createMiscReceipt）：创建其他入库单，初始状态为草稿。
• 提交（submitMiscReceipt）：校验入库行不能为空，状态变为「已审批」。
• 执行入库（finishMiscReceipt）：产生库存事务（IN 入库），增加库存台账（mes_wm_material_stock）。
• 取消（cancelMiscReceipt）：已完成和已取消状态不允许取消，其他状态均可取消。

与常规入库的区别

其他入库的流程没有上架环节。入库行中直接指定仓库/库区/库位，提交审批后即可执行入库。适用于样品入库、库存调增等简单入库场景。

---

该表包含一个子表：

• mes_wm_misc_receipt_line（入库行）：在新增/编辑弹窗中维护，记录入库物料、数量和入库库位。

2.2 管理后台

对应 [MES 系统 -> 仓库管理 -> 其他入库] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/wm/miscreceipt 目录。

列表

支持按入库单编码、名称、杂项类型、来源单据类型、来源单据编号等条件搜索。

新增

点击【新增】按钮，弹出其他入库新增表单。主要填写入库单编码（可自动生成）、入库单名称、入库类型、来源单据信息（选填）、入库日期。新建成功后弹窗自动切换为编辑模式，在表单下方展示入库行列表。

修改

点击编码链接或【编辑】按钮（仅草稿状态可编辑），弹出其他入库修改表单。表单下方通过 el-divider 分隔展示入库行列表。

★ 入库行（编辑弹窗下方）：由 mes_wm_misc_receipt_line 表存储，记录入库物料、数量和入库库位。由 MesWmMiscReceiptLineController 提供接口。

mes_wm_misc_receipt_line 表结构

CREATE TABLE `mes_wm_misc_receipt_line` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `receipt_id` bigint NOT NULL COMMENT '入库单ID',

  `item_id` bigint NOT NULL COMMENT '物料ID',
  `quantity` decimal(14,2) NOT NULL COMMENT '入库数量',

  `batch_code` varchar(64) DEFAULT NULL COMMENT '批次号',

  `warehouse_id` bigint NOT NULL COMMENT '仓库ID',
  `location_id` bigint NOT NULL COMMENT '库区ID',
  `area_id` bigint NOT NULL COMMENT '库位ID',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 其他入库单行';

① receipt_id 关联主表 mes_wm_misc_receipt 的 id 字段。

② item_id 关联 mes_md_item 表的 id 字段，标识入库物料。quantity 为入库数量。

③ batch_code 为批次号（选填）。

④ warehouse_id、location_id、area_id 指定入库的仓库/库区/库位。在行表中直接指定，无需单独的上架明细。

提交

在编辑弹窗中点击【提交】按钮（仅草稿状态下显示）。系统会先检查表单是否有修改（脏检查），有修改则先保存再提交。提交后主表不可再修改。

执行入库

在「已审批」状态下，点击【执行入库】按钮。系统通过 MesWmMiscReceiptServiceImpl 的 finishMiscReceipt 方法，遍历所有入库行，批量创建 IN 库存事务，增加库存台账。

状态变为「已完成」。

取消

在列表页点击【取消】按钮（已完成和已取消状态不允许取消，其他状态均可取消），需二次确认。取消后不可恢复。

3. 其他出入库对比

与常规出入库的差异

差异点	常规出入库（采购/生产/销售/外协）	其他出入库
拣货/上架	有独立的拣货或上架环节（行+明细双层结构）	无，行表直接指定库位
状态节点	4~6 个状态（含检验、拣货、上架等）	3 个核心状态（草稿→待执行→已完成）
质检	可关联 IQC/OQC/RQC 检验	无质检环节
业务关联	关联工单、客户、供应商等	仅可选关联来源单据
适用场景	标准业务流程	库存调整、报废、样品、赠品等杂项场景