shanshi 65d37c8093 feat: 接入网商银行邮件账单自动导入 (#1199)
独立邮箱机器人读取网商银行加密账单,解密并导入财务台账。
2026-11-16 16:41:07 +08:00

50 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 网商银行邮件账单
每天从网易邮箱读取网商银行电子凭证,解压 ZIP,转换交易明细 CSV,并导入财务台账“动账明细”。只处理 `runtime/private/wangshang-mail-accounts.json` 中启用的公司。
## 首次配置
1. 在网易邮箱开启 IMAP,并生成客户端授权码。
2. 从公司表生成私有配置:
```powershell
pwsh -File scripts\wangshang-mail\import-accounts.ps1
```
默认读取 `D:\Desktop\网商数据抓取.xlsx`,生成:
- `runtime/private/wangshang-mail-accounts.json`:邮箱授权码、公司、账号和解压密码。
- `runtime/private/wangshang-mail/`:下载账单、导入批次和日志。
邮箱授权码只在终端读取,不写入日志。私有配置目录已被 `.gitignore` 忽略。
## 手动运行
```powershell
# 默认读取昨天邮件中的昨天交易账单
pwsh -File scripts\wangshang-mail\run-wangshang-mail-daily.ps1
# 只下载与解析,不上传
pwsh -File scripts\wangshang-mail\run-wangshang-mail-daily.ps1 -Date 2026-11-15 -SkipImport
# 上传并只校验,不写台账
pwsh -File scripts\wangshang-mail\run-wangshang-mail-daily.ps1 -Date 2026-11-15 -DryRun
```
## 每日任务
```powershell
pwsh -File scripts\wangshang-mail\install-daily-task.ps1
```
任务名为 `CaiWuXiTong-WangshangMailDaily`,默认每天 10:00 读取当天邮件中的前一日交易明细。电脑休眠后恢复时补跑。
## 数据规则
- 按附件文件名中的网商账号和交易日匹配,不依赖邮件标题中的脱敏公司名。
- 每家公司必须恰好匹配一封内容一致的当日账单;缺失或同一天出现不同附件时,该公司不导入。
- ZIP 解压密码取账号表中的公司密码;账单企业名称和账号必须与配置一致。
- Excel 使用只读流式方式遍历,并转换成 CSV;导入器按 CSV 流式读取。
- 先完成全部账户解析,再生成批次;部分账户失败时,成功账户仍可导入,任务以失败状态结束。
- 每批按“网商银行来源 + 账号 + 日期”替换,最后统一重算一次台账。