# Batch 5: ERP 销售出库单审批集成 - 前端修改文档

## 概述

本批次为 ERP 销售出库单模块集成 BPM 流程审批功能。销售出库单审批通过后会自动减少库存。

## 涉及页面

- 修改页面：销售出库管理页面（新增提交审批、审批状态展示）

---

## API

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /erp/sale-out/submit | 提交销售出库审批 |

**请求参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| id | Long | 是 | 销售出库单编号 |

---

## 前端修改点

### 1. 销售出库列表页面修改

**文件路径：** `src/views/erp/sale/out/index.vue`

#### 1.1 新增提交审批按钮

```vue
<el-button
  link
  type="primary"
  @click="handleSubmit(scope.row.id)"
  v-hasPermi="['erp:sale-out:update']"
  v-if="scope.row.status === 0"
>
  提交审批
</el-button>
```

#### 1.2 新增提交审批方法

```typescript
/** 提交审批 */
const handleSubmit = async (id: number) => {
  try {
    await message.confirm('确认提交该销售出库单进行审批？审批通过后将减少库存')
    await SaleOutApi.submitSaleOut(id)
    message.success('提交成功')
    await getList()
  } catch {}
}
```

### 2. API 接口文件修改

**文件路径：** `src/api/erp/sale/out/index.ts`

```typescript
// 提交销售出库审批
export const submitSaleOut = async (id: number) => {
  return await request.post({ url: '/erp/sale-out/submit?id=' + id })
}
```

---

## 注意事项

1. 销售出库单审批通过后会自动减少库存（负数变更）
2. 审批不通过或取消不会变更库存
3. BPM 流程 Key：`erp-sale-out-audit`

---

**文档版本**: v1.0
**创建日期**: 2026-06-26