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

2.1 KiB
Raw Blame History

网商银行邮件账单

每天从网易邮箱读取网商银行电子凭证,解压 ZIP,转换交易明细 CSV,并导入财务台账“动账明细”。只处理 runtime/private/wangshang-mail-accounts.json 中启用的公司。

首次配置

  1. 在网易邮箱开启 IMAP,并生成客户端授权码。
  2. 从公司表生成私有配置:
pwsh -File scripts\wangshang-mail\import-accounts.ps1

默认读取 D:\Desktop\网商数据抓取.xlsx,生成:

  • runtime/private/wangshang-mail-accounts.json:邮箱授权码、公司、账号和解压密码。
  • runtime/private/wangshang-mail/:下载账单、导入批次和日志。

邮箱授权码只在终端读取,不写入日志。私有配置目录已被 .gitignore 忽略。

手动运行

# 默认读取昨天邮件中的昨天交易账单
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

每日任务

pwsh -File scripts\wangshang-mail\install-daily-task.ps1

任务名为 CaiWuXiTong-WangshangMailDaily,默认每天 10:00 读取当天邮件中的前一日交易明细。电脑休眠后恢复时补跑。

数据规则

  • 按附件文件名中的网商账号和交易日匹配,不依赖邮件标题中的脱敏公司名。
  • 每家公司必须恰好匹配一封内容一致的当日账单;缺失或同一天出现不同附件时,该公司不导入。
  • ZIP 解压密码取账号表中的公司密码;账单企业名称和账号必须与配置一致。
  • Excel 使用只读流式方式遍历,并转换成 CSV;导入器按 CSV 流式读取。
  • 先完成全部账户解析,再生成批次;部分账户失败时,成功账户仍可导入,任务以失败状态结束。
  • 每批按“网商银行来源 + 账号 + 日期”替换,最后统一重算一次台账。