Beancount 导入脚本使用教程

1. 项目介绍

Beancount 导入脚本是一个开源项目，旨在帮助中国用户将各种支付平台和银行账户的交易记录导入到 Beancount 财务管理软件中。它支持的数据源包括微信支付、支付宝、中国银行、招商银行、建设银行、民生银行、工商银行、清华大学校园卡以及汇丰银行（香港）等。

2. 项目快速启动

首先，确保您已经安装了 Python 环境和 Beancount。

安装导入脚本

使用 pip 安装：

pip3 install china-bean-importers

或者克隆本仓库或作为 submodule：

git clone https://github.com/jiegec/china_bean_importers.git
# 或者
git submodule add [e-mail]:jiegec/china_bean_importers.git

然后安装 importer 和依赖：

cd china_bean_importers
pip install --editable .

配置文件

复制配置模板，编辑 config.py：

cp config.example.py config.py

在 config.py 中填入你的配置，放置在你的项目目录中。

使用导入脚本

在你的 Beancount 使用的导入脚本中按需加入：

from china_bean_importers import wechat, alipay_web, alipay_mobile, boc_credit_card, boc_debit_card, cmb_debit_card

from china_bean_importer_config import config

CONFIG = [
    wechat.Importer(config),
    alipay_web.Importer(config),
    alipay_mobile.Importer(config),
    boc_credit_card.Importer(config),
    boc_debit_card.Importer(config),
    cmb_debit_card.Importer(config),
]

3. 应用案例和最佳实践

以下是一些使用导入脚本的常见场景：

导入微信支付账单

1. 从微信支付中下载账单 CSV 文件。
2. 使用微信支付的 Importer 读取 CSV 文件并导入到 Beancount。

导入支付宝账单

1. 从支付宝中下载账单 TXT 或 CSV 文件。
2. 使用支付宝的 Importer 读取文件并导入到 Beancount。

处理银行账单

1. 下载并解密银行的 PDF 账单文件。
2. 使用相应银行的 Importer 读取 PDF 文件并导入到 Beancount。

4. 典型生态项目

目前，Beancount 导入脚本支持多种银行和支付平台，以下是其中的一些典型生态项目：

• 微信支付导入器：支持导入微信支付账单。
• 支付宝导入器：支持导入支付宝网页端和手机端的账单。
• 中国银行导入器：支持导入中国银行信用卡和借记卡的账单。
• 招商银行导入器：支持导入招商银行借记卡的账单。
• 清华大学校园卡导入器：支持导入清华大学校园卡的交易记录。

通过使用这些导入器，您可以方便地将财务数据整合到 Beancount 中，实现更加高效的财务管理。