• 一部装有 beancount 、fava 以及 double-entry-generator 的 Mac 或 PC。
• 一部 iPhone 或 Android 手机。
• 本地存储个人 my-bookkeepings 账本最新内容。

开始工作！

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

; wechat pay balance
0000-00-00 document Assets:Digital:Wechat:Cash "./path/to/your_wechat_bills.csv"
0000-00-01 balance  Assets:Digital:Wechat:Cash    <balance_value> ~ 0.00 CNY

; alipay balance
0000-00-00 document Assets:Digital:Alipay:Cash "./path/to/your_alipay_bills.csv"
0000-00-01 balance  Assets:Digital:Alipay:Cash    <balance_value> ~ 0.00 CNY

; bank balance
0000-00-01 balance Assets:Bank:CN:ICBC:Savings          <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:ICBC:SocialSecurity   <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:BOCOM:Savings         <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:BOC:Savings           <balance_value> ~ 0.00 CNY
0000-00-01 balance Liabilities:CreditCard:CN:ICBC       <balance_value> ~ 0.00 CNY
1111-11-19 balance Liabilities:CreditCard:CN:CMB        <balance_value> ~ 0.00 CNY
1111-11-20 balance Liabilities:CreditCard:CN:BOCOM      <balance_value> ~ 0.00 CNY

导入微信支付账单

先查看上月微信 beancount 账单，确定最后导入日。

在「微信」中导出从最后导入日至今日的微信支付账单。

使用如下命令生成账单：

1
2
3
4
5

double-entry-generator translate \
  --config ./config/double-entry-generator/wechat.yaml \
  --provider wechat \
  --output tmp-wechat.beancount \
  your_wechat_bills.csv

修改相关 FIXME 账户交易（posting）。

在当月 index.beancount 中添加微信支付的相关 balance 和 document 语句，例：

1
2

0000-00-00 document Assets:Digital:Wechat:Cash "./path/to/your_wechat_bills.csv"
0000-00-01 balance  Assets:Digital:Wechat:Cash    <balance_value> ~ 0.00 CNY

balance 日期必须为 T+1，否则语句会忽略今日交易，导致对账失败。

若对账失败，特别是小额差异，极有可能是「零钱通」发放利息所致。值得注意的是，微信「零钱通」的利息发放并不包括在微信导出的账单当中。

值得注意的是，从「理财通」转入至「银行卡」的交易，微信支付是没有记录的，见这里。

导入支付宝账单

先查看上月支付宝 beancount 账单，确定最后导入日。

在「支付宝」导出从最后导入日至今日的支付宝账单。

使用如下命令生成账单：

1
2
3
4
5

double-entry-generator translate \
  --config ./config/double-entry-generator/alipay.yaml \
  --provider alipay \
  --output tmp-alipay.beancount \
  your_alipay_bills.csv

修改相关 FIXME 账户交易（posting）。

在当月 index.beancount 中添加支付宝的相关 balance 和 document 语句，例：

1
2

0000-00-00 document Assets:Digital:Alipay:Cash "./path/to/your_alipay_bills.csv"
0000-00-01 balance  Assets:Digital:Alipay:Cash    <balance_value> ~ 0.00 CNY

balance 日期必须为 T+1，否则语句会忽略今日交易，导致对账失败。

导入火币账单

（可选，依据月度是否有火币交易）

先查看上月火币 beancount 账单，确定最后导入日。

在「火币」导出从最后导入日至今日的火币账单。

使用如下命令生成账单：

1
2
3
4
5

double-entry-generator translate \
  --config ./config/double-entry-generator/huobi.yaml \
  --provider huobi \
  --output tmp-huobi.beancount \
  your_huobi_bills.csv

修改相关 FIXME 账户交易（posting）。

导入中国工商银行账单

先查看上月工商银行 beancount 账单，确定最后导入日。

在「中国工商银行」导出从最后导入日至今日中国工商银行的借记卡和信用卡账单。

使用如下命令生成账单：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 生成贷记卡账单
double-entry-generator translate \
  --config ./config/double-entry-generator/icbc-1120-5595.yaml \
  --provider icbc \
  --output tmp-icbc-1120-5595.beancount \
  your_icbc_1120_5595_bills.csv
# 生成借记卡账单
double-entry-generator translate \
  --config ./config/double-entry-generator/icbc-9855.yaml \
  --provider icbc \
  --output tmp-icbc-9855.beancount \
  your_icbc_9855_bills.csv
double-entry-generator translate \
  --config ./config/double-entry-generator/icbc-5868.yaml \
  --provider icbc \
  --output tmp-icbc-5868.beancount \
  your_icbc_5868_bills.csv

修改相关 FIXME 账户交易（posting）。

在当月 index.beancount 中添加中国工商银行的相关 balance 和 document 语句，例：

1
2
3
4

0000-00-00 document Assets:Bank:CN:ICBC:Savings "./path/to/your_icbc_debit_bills.csv"
0000-00-00 document Liabilities:CreditCard:CN:ICBC "./path/to/your_icbc_credit_bills.csv"
0000-00-01 balance Assets:Bank:CN:ICBC:Savings          <balance_value> ~ 0.00 CNY
0000-00-01 balance Liabilities:CreditCard:CN:ICBC       <balance_value> ~ 0.00 CNY

导入其他银行卡账单

double-entry-generator 目前仅支持中国工商银行账单的转换，鉴于个人使用银行卡的交易较少（<10 笔/月），可以直接使用手动记账。

打开：

• 中国工商银行
• 招商银行
• 中国银行
• 交通银行

先写一个 T+1 的 balance 对账语句，对相关的账户进行断言。

1
2
3
4
5
6
7

0000-00-01 balance Assets:Bank:CN:ICBC:Savings          <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:ICBC:SocialSecurity   <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:BOCOM:Savings         <balance_value> ~ 0.00 CNY
0000-00-01 balance Assets:Bank:CN:BOC:Savings           <balance_value> ~ 0.00 CNY
0000-00-01 balance Liabilities:CreditCard:CN:ICBC       <balance_value> ~ 0.00 CNY
1111-11-19 balance Liabilities:CreditCard:CN:CMB        <balance_value> ~ 0.00 CNY
1111-11-20 balance Liabilities:CreditCard:CN:BOCOM      <balance_value> ~ 0.00 CNY

笔者的信用卡账单分别是每月 1 日和 19 日出账，故将信用卡断言的日期设为当月 1 日以及 19 日。

工商银行信用卡可以看到实时余额，而招行和交行的只能在出账当天才可获得余额。因此工行信用卡可以直接断言当日余额，而招行、交行银行卡需要断言出账日与余额。

一般 0000-00-01 为记账当日 T+1 ，而 1111-11 一般为记账当月的月份。
🌰：若记账时间为 2023-01-25 ，则 0000-00-01 应改为 2023-01-26 ，1111-11 应改为 2023-01 。

查找当月相关银行卡账单，手动记录在当月的 index.beancount 中。

总结

以月为粒度，微信、支付宝账单基本都能够正常转换，整个工作流下来需要花费的时间成本在二十分钟以内。

使用 double-entry-generator 能够基本实现个人记账期望，可以考虑固化该工作流，以长期使用。

相关链接

1. beancount/beancount
   https://github.com/beancount/beancount
2. beancount/fava
   https://github.com/beancount/fava
3. deb-sig/double-entry-generator
   https://github.com/deb-sig/double-entry-generator
4. 多种支付账户的账单导出及查看方法汇总
   https://blog.triplez.cn/posts/bills-export-methods/

微信支付

1. 打开“微信”，点击“我的”，点击“支付”，进入如下界面：

   

2. 点击“钱包”，点击右上角“账单”，点击右上角的“常见问题”。

   

3. 点击“下载账单”。

   

4. 选择“用于个人对账”。

   

5. 自行选择需要导出的日期范围，填写自己的邮箱即可。

支付宝

打开「支付宝」APP，在菜单栏中点击「我的」。

进入「账单」，点击右上角「…」。

选择「开具交易流水证明」。

在「选择申请用途」中选择「用于个人对账」。

选择需要的交易时间范围。

填写电子邮箱后，即可获取账单。

余额宝

打开余额宝网站，选择日期，点击“下载”即可。

银行

借记卡

中国工商银行

登录中国工商银行个人网上银行，在「我的卡包」中选择某个银行卡，点击「明细」按钮，进入「明细查询」。

macOS 需要使用 Safari 并安装工行插件才可正常登录。

选择需要的时间区间，在「下载明细格式」选择 「EXCEL 格式（.csv）」，点击「下载」后，提示“明细正在下载中，请稍后回到本交易页面查看下载结果”。稍等片刻，页面提示“您的历史明细下载已经处理成功，请您再次进入明细查询页面进行下载！”。此时重新点击「查询」，在「下载」按钮旁边会出现可下载结果的链接，点击即可下载真正的 csv 账单文件（不要忘记重新将下载格式改为 csv）。

交通银行

手机「交通银行 APP」->查找“交易明细”->最下面“是否需要开立交易明细证明？”点击「立即申请」->「交易明细清单」->「电子版」-> 选择日期->填写电子邮箱->「确认开立」->输入银行卡密码->开立成功

PDF 为加密格式，加密密码为身份证后六位。

如何开立 CSV 格式的账单？

中国银行

手机「中国银行 APP」->「首页」->「更多」->「助手」->「交易流水打印」->「立即申请」-> 选择日期 -> 选择发送邮箱 -> 填写电子邮箱 -> 点击「申请」-> 申请成功

PDF 为加密格式，加密密码在「交易流水打印」的「申请记录」中可以找到。

网上银行： 需要安装安全输入插件，用 Chrome 登录中国银行网上银行。

找不到登录账号了。

信用卡

招商银行

“电邮账单”获取方式：

掌上生活->金融->查账单->右上角…->账单服务->账单补寄->(寄送方式改为「电邮账单」)->申请补寄

– zsxsoft/my-beancount-scripts

如何获取 CSV 账单？

登录网银大众版或专业版后，点【信用卡→账户管理→未出账单查询/已出账单查询】查看/下载/打印一年内的账单，带有业务受理专用章。

已出账单：点击【账单明细→点击下载财务明细】打印/下载，格式为【PDF】。 未出账单：点击页面右侧的下载或打印，格式为【Excel】。

社保（深圳）

深圳五险缴费明细查询：

登录深圳社保服务网站，进入“查询服务”，选择“缴费信息查询”，点击“五险缴费明细查询”即可。

深圳医保、养老个人账户余额查询：

登录深圳社保服务网站，进入“查询服务”，选择“参保信息查询”，点击“基本医疗保险个人账户查询”即可。

公积金（深圳）

「i 深圳 APP」，在首页点击「公积金」，进入「深圳市公积金」页面，即可看到余额。点击「账户明细」即可看到缴费情况。

加密货币

火币 Global

登录火币 Global 网站，进入币币订单的成交明细页面，选择合适的时间区间后，点击成交明细右上角的导出按钮即可。