wandering1/Auto-Finance

Fork 0

Files

wandering f754386695 Initial commit: Auto-Finance 财务报销自动化系统

2026-05-25 11:18:12 +08:00

10 KiB

Raw Blame History

阜阳师范大学财务报销系统 - 自动化脚本操作指南

适用场景：日常报销录入（基于 reimburse.py 脚本）最后更新：2026-05-23

一、系统概览

整体流程:

信息门户(SSO登录) → 财务系统入口 → 单点登录页 → 网络报销 → 日常报销录入
(tyrz.fynu.edu.cn)   (点击"财务系统")  (新标签页)   (a:has(img))   (/expen/common/common)

目标系统: http://210.45.32.214:8081
用户: 王建锋 (工号: 202407021)

关键 URL

系统	URL	说明
SSO 登录	`https://tyrz.fynu.edu.cn/sso/login`	统一认证入口
信息门户	`https://tyrz.fynu.edu.cn/oshall`	登录后跳转目标
报销系统	`http://210.45.32.214:8081`	网络报销主系统
日常报销录入	`/expen/common/common?v=4.0`	目标录入页面

二、数据准备

2.1 发票数据 CSV

脚本从 invoice_summary.csv（GBK 编码）读取发票数据，CSV 需包含以下列：

列名	说明	示例
序号	发票序号	1, 2, 3...
发票号码	发票编号	26442000005432652421
开票日期	发票开具日期	2026/5/18
项目名称	采购项目名称	电阻一批
规格型号	规格型号	—
价税合计	发票金额	2900.00
销售方名称	商户/销售方	佛山市泓宇芯科技有限公司
人员姓名	报销人	王建锋（默认值）
刷卡日期	公务卡消费日期	2026/5/18 → 自动转为 2026-05-18
公务卡号	公务卡卡号	6282880139161682（默认值）
刷卡金额	实际刷卡金额	2900.00
备注	备注信息	—
工号	人员工号	202407021（默认值）

2.2 附件文件

脚本自动扫描当前工作目录下所有 .pdf 文件，按文件名排序后与发票一一对应上传。确保 PDF 文件名与发票顺序一致。

三、脚本执行流程

运行方式

python reimburse.py --data invoice_summary.csv

支持命令行覆盖配置：

python reimburse.py \
  --data invoice_summary.csv \
  --username 202407021 \
  --password "your_password" \
  --user-data-dir browser_profile

执行步骤

脚本按以下顺序自动执行，截图保存在 images/ 目录：

Step 0: 登录信息门户
  ├── 访问 SSO 登录页
  ├── 填写工号 + 密码
  ├── 勾选用户协议复选框
  ├── 点击"登录"按钮
  └── 等待跳转到信息门户 (zs-uip/oshall/portal)

Step 1: 进入报销系统
  ├── 点击"财务系统"快捷入口
  ├── 等待新标签页打开 (含 dddl 或 210.45.32.214)
  ├── 切换到新标签页
  ├── 关闭旧标签页
  ├── 通过 a:has(img[src*="wlbx"]) 定位"网络报销"链接
  ├── 提取链接 URL 并导航
  ├── 等待"报销录入"文本出现
  └── 导航到 /expen/common/common?v=4.0

Step 2: 创建新报销单
  ├── 等待 2 秒
  ├── 点击 button:has-text("新增")
  └── 等待表单加载 3 秒

Step 3: 填写基本信息
  ├── 填写 #EXPENEXPLAIN → "元器件采购报销"
  ├── 点击 #PROJECTCODE 打开项目选择弹窗
  ├── 在 #promodal .fixed-table-body tbody tr 中点击第一行
  └── 点击 #saveAndNext 进入下一步

Step 4: 录入报销明细（一条总明细）
  ├── 计算所有发票的刷卡金额合计
  ├── 点击 #insertDetail 打开增加明细弹窗
  ├── 点击 #economicscode2 打开经济科目选择
  ├── 在 #econmodal 中选择第 3 行经济科目
  ├── 填写单据数 = 发票张数
  ├── 填写报销总金额 = 刷卡金额合计
  └── 点击 #detailAdd 确认

Step 5: 录入支付方式（逐张发票）
  ├── 点击 "下一步(支付方式)"
  ├── 对每张发票循环:
  │   ├── 点击 #insertPay
  │   ├── 填写 #personid2 (工号)
  │   ├── 填写 #accountname2 (姓名)
  │   ├── 填写 #receiptdate2 (刷卡日期)
  │   ├── 填写 #localaccount2 (固定卡号: 6282880139161682)
  │   ├── 填写 #receiptmoney2 (刷卡金额)
  │   ├── 填写 #money2 (实报金额 = 刷卡金额)
  │   ├── 填写 #merchant2 (销售方名称)
  │   ├── 填写 #smark2 (备注)
  │   └── 点击 #payAdd 确认
  └── 所有发票录入完成

Step 6: 上传附件（逐张发票）
  ├── 点击 #next3 切换到附件清单页面
  ├── 对每张发票循环:
  │   ├── 点击 #insertAcc 打开附件弹窗
  │   ├── select_option #fjlx → '1' (发票类型)
  │   ├── 填写 #fpsmxx (项目名称 - 发票号码)
  │   ├── set_input_files #file (对应 PDF 文件)
  │   └── 点击 #cjtj 确认
  └── 所有附件上传完成

提交阶段:
  └── 点击 #submit (当前已注释，需手动取消注释)

四、页面元素速查

基本信息页 (Step 3)

字段	选择器	操作
报销说明	`#EXPENEXPLAIN`	fill
项目代码	`#PROJECTCODE`	click → 弹窗选择
项目弹窗	`#promodal .fixed-table-body tbody tr`	点击第一行
下一步按钮	`#saveAndNext`	click

报销明细页 (Step 4)

字段	选择器	操作
增加按钮	`#insertDetail`	click
经济事项代码	`#economicscode2`	click → 弹窗选择
经济科目弹窗	`#econmodal .fixed-table-body tbody tr`	点击第 3 行
单据数	`input[name="expenPwCommondetail.HOWBILLS"]`	fill
报销总金额	`#je_zwzcdz`	fill
确定按钮	`#detailAdd`	click

支付方式页 (Step 5)

字段	选择器	操作
增加按钮	`#insertPay`	click
人员编号	`#personid2`	fill
人员姓名	`#accountname2`	fill
刷卡日期	`#receiptdate2`	fill
公务卡号	`#localaccount2`	fill (固定值)
刷卡金额	`#receiptmoney2`	fill
实报金额	`#money2`	fill
商户	`#merchant2`	fill
备注	`#smark2`	fill
确定按钮	`#payAdd`	click

附件清单页 (Step 6)

字段	选择器	操作
增加按钮	`#insertAcc`	click
附件类型	`#fjlx`	select_option → '1'(发票)
附件说明	`#fpsmxx`	fill
文件上传	`#file`	set_input_files
确定按钮	`#cjtj`	click

提交

操作	选择器
提交按钮	`#submit`
提交按钮(备用)	`#submit2`

五、数据流向

invoice_summary.csv (GBK)
    │
    ▼ load_invoice_data()
    │
    ├── 读取 CSV 行
    ├── 日期格式转换 (2026/5/18 → 2026-05-18)
    ├── 填充默认值 (姓名/卡号/工号)
    └── 输出: list[dict]
            │
            ▼ add_reimburse_items()
            ├── 计算: card_amount = sum(所有发票刷卡金额)
            ├── 单据数 = len(invoices)
            └── 录入 1 条总明细
            │
            ▼ fill_payment()
            └── 对每张发票录入 1 条支付记录
            │
            ▼ upload_attachments()
            ├── 扫描 *.pdf 文件
            └── 按索引匹配发票 → PDF，逐张上传

六、关键设计说明

6.1 浏览器复用

脚本使用 launch_persistent_context 持久化浏览器上下文，登录状态保存在 browser_profile/ 目录。再次运行时复用已有会话，无需重复登录。

6.2 明细录入策略

脚本采用"一条总明细"策略：将所有发票合并为一条报销明细，报销总金额为所有发票刷卡金额之和，单据数为发票总张数。支付方式则逐张发票分别录入，每张发票对应一条支付记录。

6.3 经济科目选择

脚本在经济科目弹窗中固定选择第 3 行。如需更改科目，修改 rows[2] 的索引即可。

6.4 项目选择

脚本在项目选择弹窗中固定选择第 1 行。如需更改项目，修改 first_row 的选择逻辑即可。

6.5 网络报销链接动态获取

单点登录页的"网络报销"链接参数每次不同，脚本通过 a:has(img[src*="wlbx"]) 精确定位链接，动态提取 href 属性后导航，不硬编码 URL。

6.6 提交控制

脚本默认注释了 bot.submit() 调用。完成所有录入后停留在附件清单页面，需人工确认数据无误后，取消注释 bot.submit() 再运行，或手动点击提交按钮。

七、日志与调试

日志输出

控制台实时输出（DEBUG 级别）
文件日志：reimburse.log（UTF-8 编码）

截图保存

每个关键步骤自动截图到 images/ 目录：

截图文件	对应步骤
`debug_portal_loaded.png`	登录成功
`debug_step3_project_modal.png`	项目弹窗打开
`debug_step3_project_selected.png`	项目选择完成
`debug_step3_done.png`	基本信息完成
`debug_after_add_click.png`	点击新增后
`debug_item_total.png`	总明细录入完成
`debug_step5_done.png`	支付方式完成
`debug_step6_done.png`	附件上传完成
`debug_submitted.png`	提交完成
`debug_error.png`	异常状态

超时设置

页面默认超时：30 秒
登录门户等待：最多 30 秒
单点登录页等待：最多 15 秒

八、常见问题

问题	原因	解决方案
登录超时	SSO 需要手动验证码/微信扫码	手动完成验证后脚本继续
未找到财务系统入口	门户页面结构变化	检查 `images/debug_*` 截图定位
经济科目选择失败	弹窗加载延迟	检查超时设置，增加等待时间
附件上传失败	PDF 文件不存在或路径错误	确认 PDF 在当前工作目录
金额不匹配	明细合计 ≠ 支付合计	检查 CSV 数据中刷卡金额
提交被拦截	必填项为空	检查 `reimburse.log` 定位失败步骤

10 KiB Raw Blame History Unescape Escape