my-beancount-scripts

Beancount 我的个人自用脚本，包含以下功能：

账单导入
- 支付宝（ZIP / CSV）
- 微信（ZIP / CSV）
- ~~余额宝（XLS）（不用于导入，仅用于支付宝账单去重）（已经失去意义）~~
- ~~中信银行信用卡（EML邮件）（已不再发送）~~
- 民生银行信用卡（EML邮件）
- 招商银行信用卡（EML邮件）
- 工商银行信用卡（EML邮件）
- 工商银行对账单（邮件附件）（仅余额与交易明细部分）
- 京东订单（仅商品信息与价格）
账单去重
- 由于个人有手工记账的习惯，因此导入账单时可能出现重复现象。脚本根据金额与时间判断两笔交易是否相同，如果是，则不会导入这笔交易，但有可能添加额外信息（见下）。
- 如果同一天存在两笔同金额交易，则需要人工处理。
- 如果同时导入支付宝、微信和银行账单，必然会重复。如在导入支付宝、微信账单时，发现正在导入的交易已经存在，则会为原先已存在的交易添加支付宝和微信的订单号及时间戳，不会重复导入同一笔交易。
价格抓取（基于bean-price）
- 10jqka抓取同花顺数据
- coinmarketcap抓取BTC数据
- 中国银行（BOC）抓取人民币外汇数据
蚂蚁财富基金定投数据导入

使用

脚本需要自行修改accounts.py配置后才可使用，另外某些导入器可能存在问题，使用前请务必翻阅Issue区。

账单导入

python import.py ~/民生信用卡2019年09月电子对账单.eml
python import.py ./alipay_record_20191007_1634_1.csv
python import.py ./alipay_record_20191007_1634.zip
python import.py 微信支付账单\(20190802-20190902\).csv --out out.bean

其会自动识别文件类型，自动进行编码转换，不需人工判断。配置见accounts.py.

京东订单

京东订单仅导入商品名和优惠后价格。在浏览器内安装TamperMonkey等UserScript扩展后，安装此UserScript，刷新京东订单页面，即可在浏览器控制台内看到输出。

我的导入顺序

推荐的导入顺序：支付宝、微信、银行卡账单。

先导入支付宝和微信账单，因为这两个支付方式留有最多的信息，方便对账。
导入银行卡账单。由于账单去重的存在，不会重复导入之前通过支付宝和微信已导入的交易，且会自动修复支付方式不正确的支付宝账单。
手动添加balance指令，并对照余额是否正确，账单是否全部导入。

获得账单

支付宝

支付宝App->我的->账单->右上角...->开具交易流水证明，之后可在邮箱中得到zip文件。通过import.py导入时，脚本会提示输入密码。

不要在支付宝电脑端操作。

微信

手机进入微信支付->钱包->（右上角）账单->右上角...->账单下载，之后可在邮箱中得到zip文件。通过import.py导入时，脚本会提示输入密码。

信用卡账单

目前仅测试了QQ邮箱的邮件导出，可能不适用其他邮件客户端。导出路径为打开邮件后->文件->另存为，可得eml文件。

招商银行信用卡

招商银行默认只发送「电邮盖章」邮件，如需对账则需要「电邮账单」类型。获取方式为：掌上生活->金融->查账单->右上角...->账单服务->账单补寄->(寄送方式改为「电邮账单」)->申请补寄。

价格抓取

示例配置：

; 同花顺基金抓取
2010-01-01 commodity F161725
  export: "F161725"
  price: "CNY:modules.price_sources.10jqka/161725"

; CoinMarketCap 加密货币抓取
2010-01-01 commodity BTC
  export: "BTC"
  price: "CNY:modules.price_sources.coinmarketcap/bitcoin--cny"

; 中行人民币外汇抓取
2010-01-01 commodity JPY
  export: "JPY"
  price: "CNY:modules.price_sources.boc/_E6_97_A5_E5_85_83"
  ; 请打开网页 http://www.boc.cn/sourcedb/whpj/
  ; 之后打开浏览器控制台，输入：
  ; $('#pjname option').each((a, b) => console.log(encodeURIComponent(b.value).replace(/%/g,'_') + ' ' + b.innerText))
  ; 按下回车后，即可显示所有对应字符串。例如，_E8_8B_B1_E9_95_91代表英镑等。

export PYTHONPATH=$(pwd)
bean-price main.bean -d 2019-04-01

蚂蚁财富基金定投数据导入

支付宝的「基金定投」在账单中不显示具体认购份额和净值，本repo内的fund.py可对其进行处理。其基于同花顺抓取的基金数据，将以下交易：

2018-07-24 * "蚂蚁财富-蚂蚁（杭州）基金销售有限公司" "蚂蚁财富-XXX基金-买入"
  Assets:Company:Alipay:Fund   200 CNY
  Assets:Company:Alipay:Yuebao

改变为

2018-07-24 * "蚂蚁财富-蚂蚁（杭州）基金销售有限公司" "蚂蚁财富-XXX基金-买入"
  Assets:Company:Alipay:Fund 99.87 FXXXXXXX { 2.000 CNY }
  Expenses:Finance:TradeFee 0.26 CNY
  Equity:Deviation
  Assets:Company:Alipay:Yuebao -200 CNY

具体使用请直接修改fund.py。

开源协议

The MIT License

zsxsoft / my-beancount-scripts

readme