Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zsxsoft/my-beancount-scripts
Git repo to save my Beancount scripts
https://github.com/zsxsoft/my-beancount-scripts
Last synced: about 1 month ago
JSON representation
Git repo to save my Beancount scripts
- Host: GitHub
- URL: https://github.com/zsxsoft/my-beancount-scripts
- Owner: zsxsoft
- Created: 2019-09-12T12:34:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-27T15:26:45.000Z (almost 2 years ago)
- Last Synced: 2024-08-03T14:10:13.853Z (4 months ago)
- Language: Python
- Homepage:
- Size: 79.1 KB
- Stars: 355
- Watchers: 8
- Forks: 72
- Open Issues: 8
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
- my-awesome - zsxsoft/my-beancount-scripts - 02 star:0.4k fork:0.1k Git repo to save my Beancount scripts (Python)
README
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区。
### 账单导入
```bash
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](https://github.com/zsxsoft/my-beancount-scripts/raw/master/jd.user.js)，刷新京东订单页面，即可在浏览器控制台内看到输出。
### 我的导入顺序
推荐的导入顺序：支付宝、微信、银行卡账单。
1. 先导入支付宝和微信账单，因为这两个支付方式留有最多的信息，方便对账。
2. 导入银行卡账单。由于账单去重的存在，不会重复导入之前通过支付宝和微信已导入的交易，且会自动修复支付方式不正确的支付宝账单。
3. 手动添加``balance``指令，并对照余额是否正确，账单是否全部导入。
### 获得账单
#### 支付宝
支付宝App->我的->账单->右上角...->开具交易流水证明，之后可在邮箱中得到zip文件。通过import.py导入时，脚本会提示输入密码。
**不要在支付宝电脑端操作。**
#### 微信
手机进入微信支付->钱包->（右上角）账单->右上角...->账单下载，之后可在邮箱中得到zip文件。通过import.py导入时，脚本会提示输入密码。
#### 信用卡账单
目前仅测试了QQ邮箱的邮件导出，可能不适用其他邮件客户端。导出路径为打开邮件后->文件->另存为，可得eml文件。
##### 招商银行信用卡
招商银行默认只发送「电邮盖章」邮件，如需对账则需要「电邮账单」类型。获取方式为：掌上生活->金融->查账单->右上角...->账单服务->账单补寄->(寄送方式改为「电邮账单」)->申请补寄。
### 价格抓取
示例配置：
```beancount
; 同花顺基金抓取
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代表英镑等。
```
```bash
export PYTHONPATH=$(pwd)
bean-price main.bean -d 2019-04-01
```
#### 蚂蚁财富基金定投数据导入
支付宝的「基金定投」在账单中不显示具体认购份额和净值，本repo内的``fund.py``可对其进行处理。其基于同花顺抓取的基金数据，将以下交易：
```beancount
2018-07-24 * "蚂蚁财富-蚂蚁（杭州）基金销售有限公司" "蚂蚁财富-XXX基金-买入"
Assets:Company:Alipay:Fund 200 CNY
Assets:Company:Alipay:Yuebao
```
改变为
```beancount
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