50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# 网商银行邮件账单
|
||
|
||
每天从网易邮箱读取网商银行电子凭证,解压 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 流式读取。
|
||
- 先完成全部账户解析,再生成批次;部分账户失败时,成功账户仍可导入,任务以失败状态结束。
|
||
- 每批按“网商银行来源 + 账号 + 日期”替换,最后统一重算一次台账。
|