Excel导入格式说明.md 6.34 KB

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文件(必填)

返回结果

{
  "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. 错误处理:导入过程中如果有错误,会在返回结果中列出所有错误信息