# 销售出库流程数据带入与查询方案

## 一、整体流程

```
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  销售订单   │───>│ 发货通知单  │───>│ 销售出库单  │───>│  出库完成   │
│ (ERP模块)   │    │  (MES模块)  │    │  (MES模块)  │    │  状态回写   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       ▼                  ▼                  ▼                  ▼
  出库状态同步      出库状态同步       执行出库           状态回写上游
```

## 二、单据层级结构

### 1. 发货通知单（mes_wm_sales_notice）

| 层级 | 表名 | 说明 |
|------|------|------|
| 主表 | mes_wm_sales_notice | 发货通知单基本信息 |
| 行表 | mes_wm_sales_notice_line | 按物料维度的发货明细 |

### 2. 销售出库单（mes_wm_product_sales）

| 层级 | 表名 | 说明 |
|------|------|------|
| 主表 | mes_wm_product_sales | 出库单基本信息 |
| 行表 | mes_wm_product_sales_line | 按物料/批次维度的出库行 |
| 明细表 | mes_wm_product_sales_detail | 拣货明细，具体仓库/库区/库位 |

## 三、上下游数据带入规则

### 1. 销售订单 → 发货通知单

**主表带入：**

| 销售订单字段 | 发货通知单字段 | 说明 |
|-------------|---------------|------|
| id | saleOrderId | 销售订单ID |
| no | saleOrderCode | 销售订单号 |
| customerId | clientId | 客户ID |

**行表带入：**

| 销售订单明细字段 | 发货通知单行字段 | 说明 |
|-----------------|-----------------|------|
| id | saleOrderItemId | 销售订单明细ID |
| productId | itemId | 物料ID |
| count | quantity | 发货数量 |

**API 调用：**
- `ErpSaleOrderApi.getSaleOrder(saleOrderId)` - 获取销售订单信息
- `ErpSaleOrderApi.getSaleOrderItemList(saleOrderId)` - 获取销售订单明细列表

### 2. 发货通知单 → 销售出库单

**主表带入：**

| 发货通知单字段 | 销售出库单字段 | 说明 |
|---------------|---------------|------|
| id | noticeId | 发货通知单ID |
| clientId | clientId | 客户ID |
| saleOrderId | saleOrderId | 销售订单ID |
| saleOrderCode | salesOrderCode | 销售订单号 |
| salesDate | salesDate | 出库日期 |
| recipientName | contactName | 收货人 → 联系人 |
| recipientTelephone | contactTelephone | 联系电话 |
| recipientAddress | contactAddress | 收货地址 |

**行表带入：**

| 发货通知单行字段 | 销售出库单行字段 | 说明 |
|-----------------|-----------------|------|
| id | noticeLineId | 发货通知单行ID |
| saleOrderItemId | saleOrderItemId | 销售订单明细ID |
| itemId | itemId | 物料ID |
| quantity | quantity | 出库数量 |
| batchId | batchId | 批次ID |
| batchCode | batchCode | 批次号 |
| oqcCheckFlag | oqcCheckFlag | 是否检验 |

**注意：**
- 销售出库单明细表（拣货信息）需要手动添加
- 一个发货通知单可以生成多个销售出库单（部分出库场景）

## 四、状态同步机制

### 1. 出库完成时的状态回写

**触发时机：** 销售出库单执行出库（finishProductSales）

**回写流程：**

```
销售出库单行.noticeLineId → 发货通知单行.outCount（累加）
                                ↓
                        计算发货通知单.outStatus
                                ↓
                    全部出库时 → 发货通知单.status = 已完成
                                ↓
销售出库单行.saleOrderItemId → ERP销售订单明细.outCount（累加）
                                ↓
                        计算ERP销售订单.outStatus
```

### 2. 出库状态枚举

| 值 | 名称 | 说明 |
|----|------|------|
| 0 | 未出库 | 所有行的 outCount = 0 |
| 1 | 部分出库 | 部分行已出库，或部分数量已出库 |
| 2 | 全部出库 | 所有行的 outCount >= quantity |

## 五、关联信息查询

### 1. 发货通知单查询时

**需要查询的关联数据：**

| 关联对象 | API/方法 | 用途 |
|---------|---------|------|
| 客户信息 | CrmCustomerApi.getCustomerMap(clientIds) | 显示客户名称 |
| 销售订单 | ErpSaleOrderApi.getSaleOrder(saleOrderId) | 显示订单信息 |

### 2. 销售出库单查询时

**需要查询的关联数据：**

| 关联对象 | API/方法 | 用途 |
|---------|---------|------|
| 客户信息 | CrmCustomerApi.getCustomerMap(clientIds) | 显示客户名称 |
| 发货通知单 | SalesNoticeService.getSalesNoticeMap(noticeIds) | 显示通知单编码 |
| 物料信息 | MesMdItemService.getItemMap(itemIds) | 显示物料编码、名称、规格型号 |
| 批次信息 | MesWmBatchService.getBatchMap(batchIds) | 显示批次号、生产日期 |
| 仓库信息 | MesWmWarehouseService.getWarehouseMap(warehouseIds) | 显示仓库名称 |
| 库区信息 | MesWmWarehouseLocationService.getLocationMap(locationIds) | 显示库区名称 |
| 库位信息 | MesWmWarehouseAreaService.getAreaMap(areaIds) | 显示库位名称 |

### 3. 物料信息查询 API

```java
// 获取物料基本信息
MesMdItemDO item = itemService.getItem(itemId);

// 批量获取物料信息
Map<Long, MesMdItemDO> itemMap = itemService.getItemMap(itemIds);

// 校验物料存在且启用
itemService.validateItemExistsAndEnable(itemId);
```

**物料关键信息：**

| 字段 | 说明 |
|------|------|
| id | 物料ID |
| code | 物料编码 |
| name | 物料名称 |
| spec | 规格型号 |
| unitId | 主单位ID |
| unitCode | 主单位编码 |
| batchCode | 是否批次管理 |
| qualityFlag | 是否质检 |

## 六、API 接口清单

### 1. 发货通知单 API

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /mes/wm/sales-notice/create | 创建发货通知单 |
| PUT | /mes/wm/sales-notice/update | 修改发货通知单 |
| DELETE | /mes/wm/sales-notice/delete | 删除发货通知单 |
| GET | /mes/wm/sales-notice/get | 获取发货通知单详情 |
| GET | /mes/wm/sales-notice/page | 分页查询发货通知单 |
| PUT | /mes/wm/sales-notice/submit | 提交发货通知单 |
| POST | /mes/wm/sales-notice/generate-from-sale-order | 从销售订单生成 |
| POST | /mes/wm/sales-notice/generate-product-sales | 生成销售出库单 |

### 2. 销售出库单 API

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /mes/wm/product-sales/create | 创建销售出库单 |
| PUT | /mes/wm/product-sales/update | 修改销售出库单 |
| DELETE | /mes/wm/product-sales/delete | 删除销售出库单 |
| GET | /mes/wm/product-sales/get | 获取销售出库单详情 |
| GET | /mes/wm/product-sales/page | 分页查询销售出库单 |
| PUT | /mes/wm/product-sales/submit | 提交销售出库单 |
| PUT | /mes/wm/product-sales/stock | 执行拣货 |
| PUT | /mes/wm/product-sales/shipping | 填写运单 |
| PUT | /mes/wm/product-sales/finish | 执行出库 |
| PUT | /mes/wm/product-sales/cancel | 取消销售出库单 |

## 七、前端展示字段

### 1. 发货通知单列表

| 字段 | 来源 | 说明 |
|------|------|------|
| code | mes_wm_sales_notice | 通知单编码 |
| name | mes_wm_sales_notice | 通知单名称 |
| clientName | crm_customer | 客户名称（关联查询） |
| saleOrderCode | mes_wm_sales_notice | 销售订单号 |
| salesDate | mes_wm_sales_notice | 发货日期 |
| status | mes_wm_sales_notice | 单据状态 |
| outStatus | mes_wm_sales_notice | 出库状态 |

### 2. 发货通知单行列表

| 字段 | 来源 | 说明 |
|------|------|------|
| itemCode | mes_md_item | 物料编码（关联查询） |
| itemName | mes_md_item | 物料名称（关联查询） |
| itemSpec | mes_md_item | 规格型号（关联查询） |
| batchCode | mes_wm_sales_notice_line | 批次号 |
| quantity | mes_wm_sales_notice_line | 发货数量 |
| outCount | mes_wm_sales_notice_line | 已出库数量 |
| outProgress | 计算 | 出库进度 = outCount / quantity |
| oqcCheckFlag | mes_wm_sales_notice_line | 是否检验 |

### 3. 销售出库单列表

| 字段 | 来源 | 说明 |
|------|------|------|
| code | mes_wm_product_sales | 出库单编码 |
| name | mes_wm_product_sales | 出库单名称 |
| clientName | crm_customer | 客户名称（关联查询） |
| noticeCode | mes_wm_sales_notice | 通知单编码（关联查询） |
| salesOrderCode | mes_wm_product_sales | 销售订单号 |
| salesDate | mes_wm_product_sales | 出库日期 |
| contactName | mes_wm_product_sales | 联系人 |
| contactTelephone | mes_wm_product_sales | 联系电话 |
| status | mes_wm_product_sales | 单据状态 |

### 4. 销售出库单行列表

| 字段 | 来源 | 说明 |
|------|------|------|
| itemCode | mes_md_item | 物料编码（关联查询） |
| itemName | mes_md_item | 物料名称（关联查询） |
| batchCode | mes_wm_product_sales_line | 批次号 |
| quantity | mes_wm_product_sales_line | 出库数量 |
| oqcCheckFlag | mes_wm_product_sales_line | 是否检验 |
| qualityStatus | mes_wm_product_sales_line | 质量状态 |

### 5. 销售出库明细列表（拣货信息）

| 字段 | 来源 | 说明 |
|------|------|------|
| itemCode | mes_md_item | 物料编码（关联查询） |
| batchCode | mes_wm_product_sales_detail | 批次号 |
| quantity | mes_wm_product_sales_detail | 拣货数量 |
| warehouseName | mes_wm_warehouse | 仓库名称（关联查询） |
| locationName | mes_wm_warehouse_location | 库区名称（关联查询） |
| areaName | mes_wm_warehouse_area | 库位名称（关联查询） |

## 八、业务规则

### 1. 生成规则

| 场景 | 规则 |
|------|------|
| 发货通知单生成条件 | 销售订单状态为"已审核" |
| 销售出库单生成条件 | 发货通知单状态为"待出库" |
| 生成后状态 | 均为"草稿"状态，需要提交后才能流转 |

### 2. 提交校验

| 单据 | 校验规则 |
|------|---------|
| 发货通知单 | 至少有一条行记录 |
| 销售出库单 | 至少有一条行记录，每行出库数量 > 0 |

### 3. 出库流程

```
草稿 → 提交 → 待拣货 → 拣货 → 待填写运单 → 填写运单 → 待出库 → 执行出库 → 已完成
              ↑                                                    ↓
              └──────────── 如果需要OQC检验 ←──────────────────────┘
                               草稿 → 提交 → 待检测 → OQC检验完成 → 待拣货
```

### 4. 状态回写规则

| 触发动作 | 回写对象 | 回写内容 |
|---------|---------|---------|
| 执行出库 | 发货通知单行 | outCount += 实际出库数量 |
| 执行出库 | 发货通知单 | outStatus = 计算结果 |
| 执行出库 | 发货通知单 | 如果 outStatus=全部出库，则 status=已完成 |
| 执行出库 | ERP销售订单明细 | outCount += 实际出库数量 |
| 执行出库 | ERP销售订单 | outStatus = 计算结果 |