/my-beancount-scripts

Git repo to save my Beancount scripts

Primary LanguagePython

my-beancount-scripts

Beancount 我的个人自用脚本,包含以下功能:

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

使用

脚本需要自行修改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,刷新京东订单页面,即可在浏览器控制台内看到输出。

我的导入顺序

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

  1. 先导入支付宝和微信账单,因为这两个支付方式留有最多的信息,方便对账。
  2. 导入银行卡账单。由于账单去重的存在,不会重复导入之前通过支付宝和微信已导入的交易,且会自动修复支付方式不正确的支付宝账单。
  3. 手动添加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