# Excel导入格式说明

## 📋 合作成本表导入格式

### 文件要求
- 文件格式：`.xlsx` 或 `.xls`
- 第一行为标题行（必须）
- 从第二行开始为数据行

### Excel列格式

| 列序号 | 列名 | 是否必填 | 数据类型 | 说明 | 示例 |
|--------|------|---------|---------|------|------|
| A | 门店ID | ✅ 必填 | 文本 | 门店ID（关联lq_mdxx.F_Id） | `1649328471923847168` |
| B | 门店名称 | ⚪ 可选 | 文本 | 门店名称（如果为空，系统会根据门店ID自动查询） | `川师店` |
| C | 年份 | ✅ 必填 | 数字 | 年份（4位数字） | `2025` |
| D | 月份 | ✅ 必填 | 文本 | 月份（YYYYMM格式，6位） | `202501` |
| E | 合计金额 | ✅ 必填 | 数字 | 合计金额（支持小数） | `5000.00` |
| F | 备注说明 | ⚪ 可选 | 文本 | 备注说明 | `1月合作项目成本` |

### Excel示例

```
门店ID                     | 门店名称 | 年份 | 月份   | 合计金额 | 备注说明
---------------------------|---------|------|--------|----------|------------------
1649328471923847168        | 川师店   | 2025 | 202501 | 5000.00  | 1月合作项目成本
1649328471923847169        | 春熙店   | 2025 | 202501 | 3000.00  | 1月合作项目成本
```

### 注意事项
1. **门店ID**：必须存在系统中，否则导入会失败
2. **年份**：必须是4位数字，如：2025
3. **月份**：必须是YYYYMM格式的6位字符串，如：202501（表示2025年1月）
4. **合计金额**：必须是数字，支持小数，如：5000.00
5. **重复检查**：系统会检查相同门店、年份、月份是否已存在记录，如果存在会跳过并提示
6. **空行处理**：如果门店ID和门店名称都为空，该行会被跳过

---

## 📋 店内支出表导入格式

### 文件要求
- 文件格式：`.xlsx` 或 `.xls`
- 第一行为标题行（必须）
- 从第二行开始为数据行

### Excel列格式

| 列序号 | 列名 | 是否必填 | 数据类型 | 说明 | 示例 |
|--------|------|---------|---------|------|------|
| A | 门店ID | ✅ 必填 | 文本 | 门店ID（关联lq_mdxx.F_Id） | `1649328471923847168` |
| B | 门店名称 | ⚪ 可选 | 文本 | 门店名称（如果为空，系统会根据门店ID自动查询） | `川师店` |
| C | 支出分类ID | ⚪ 可选 | 文本 | 支出分类ID（关联lq_reimbursement_category.F_Id） | `xxx` |
| D | 支出分类名称 | ⚪ 可选 | 文本 | 支出分类名称 | `办公用品` |
| E | 支出日期 | ✅ 必填 | 日期 | 支出日期（格式：YYYY-MM-DD） | `2025-01-15` |
| F | 单价 | ⚪ 可选 | 数字 | 单价（支持小数） | `10.50` |
| G | 数量 | ⚪ 可选 | 数字 | 数量（整数） | `5` |
| H | 金额 | ✅ 必填 | 数字 | 金额（支持小数） | `52.50` |
| I | 备注说明 | ⚪ 可选 | 文本 | 备注说明 | `购买办公用品` |
| J | 关联报销申请ID | ⚪ 可选 | 文本 | 关联的报销申请ID | `xxx` |
| K | 关联购买记录ID | ⚪ 可选 | 文本 | 关联的购买记录ID | `xxx` |

### Excel示例

```
门店ID                     | 门店名称 | 支出分类ID | 支出分类名称 | 支出日期   | 单价  | 数量 | 金额   | 备注说明     | 关联报销申请ID | 关联购买记录ID
---------------------------|---------|-----------|------------|-----------|-------|------|--------|-------------|--------------|---------------
1649328471923847168        | 川师店   | xxx       | 办公用品    | 2025-01-15 | 10.50 | 5    | 52.50  | 购买办公用品 | xxx          | xxx
1649328471923847168        | 川师店   | xxx       | 水电费      | 2025-01-20 | 0.00  | 0    | 500.00 | 1月水电费    |              |
```

### 注意事项
1. **门店ID**：必须存在系统中，否则导入会失败
2. **支出日期**：必须是日期格式，推荐格式：`YYYY-MM-DD`，如：`2025-01-15`
3. **金额**：必须是数字，支持小数，如：52.50
4. **单价和数量**：如果为空，默认为0
5. **空行处理**：如果门店ID和门店名称都为空，该行会被跳过

---

## 🔗 导入接口说明

### 合作成本表导入接口
```
POST /api/Extend/LqCooperationCost/Actions/Import
Content-Type: multipart/form-data

参数：
- file: Excel文件（必填）
```

### 店内支出表导入接口
```
POST /api/Extend/LqStoreExpense/Actions/Import
Content-Type: multipart/form-data

参数：
- file: Excel文件（必填）
```

### 返回结果
```json
{
  "success": true,
  "message": "导入完成：成功2条，失败0条",
  "successCount": 2,
  "failCount": 0,
  "failMessages": []
}
```

---

## 📝 测试数据准备

### 合作成本表测试数据（示例）

请创建一个Excel文件，包含以下测试数据：

| 门店ID | 门店名称 | 年份 | 月份 | 合计金额 | 备注说明 |
|--------|---------|------|------|----------|----------|
| （请填写实际门店ID） | 测试门店1 | 2025 | 202501 | 5000.00 | 测试数据1 |
| （请填写实际门店ID） | 测试门店2 | 2025 | 202501 | 3000.00 | 测试数据2 |
| （请填写实际门店ID） | 测试门店1 | 2025 | 202502 | 6000.00 | 测试数据3 |

### 店内支出表测试数据（示例）

请创建一个Excel文件，包含以下测试数据：

| 门店ID | 门店名称 | 支出分类ID | 支出分类名称 | 支出日期 | 单价 | 数量 | 金额 | 备注说明 | 关联报销申请ID | 关联购买记录ID |
|--------|---------|-----------|------------|---------|------|------|------|----------|--------------|--------------|
| （请填写实际门店ID） | 测试门店1 | | 办公用品 | 2025-01-15 | 10.50 | 5 | 52.50 | 测试支出1 | | |
| （请填写实际门店ID） | 测试门店1 | | 水电费 | 2025-01-20 | 0 | 0 | 500.00 | 测试支出2 | | |
| （请填写实际门店ID） | 测试门店2 | | 交通费 | 2025-01-25 | 50.00 | 2 | 100.00 | 测试支出3 | | |

---

## ⚠️ 重要提示

1. **门店ID获取**：可以通过门店列表接口获取实际的门店ID
2. **日期格式**：支出日期必须使用标准日期格式，推荐使用 `YYYY-MM-DD`
3. **月份格式**：合作成本表的月份必须是YYYYMM格式（6位字符串），如：202501
4. **金额精度**：所有金额字段支持2位小数
5. **重复数据**：合作成本表会检查相同门店、年份、月份是否已存在，如果存在会跳过
6. **错误处理**：导入过程中如果有错误，会在返回结果中列出所有错误信息