d055b5e1
 “wangming”
fix: update devel...
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
# 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. **错误处理**：导入过程中如果有错误，会在返回结果中列出所有错误信息
|
