14 篇博文 含有标签「纯文本记账」

在今天的博客文章中，我们将深入剖析一个专为企业设计的 Beancount 账本，帮助您理解这种纯文本复式记账系统的复杂细节。

我们先从代码开始：

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
  Expenses:COGS:Contabo                               17.49 USD
  Assets:Bank:Mercury                                -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
  Expenses:COGS:AmazonWebServices                  14490.33 USD
  Assets:Bank:Mercury                             -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
  Income:Stripe                                   -21230.75 USD
  Assets:Bank:Mercury                              21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
  Assets:Crypto                                         -19 ETH {1,856.20 USD}
  Income:Crypto:ETH                                      19 ETH @@ 35267.8 USD

理解代码​

1. 开立账户：代码首先在 1970-01-01 开立了一系列账户。其中包括资产账户（Assets:Bank:Mercury 和 Assets:Crypto）、权益账户（Equity:Bank:Chase）、收入账户（Income:Stripe 和 Income:Crypto:ETH）以及费用账户（Expenses:COGS、Expenses:COGS:AmazonWebServices、Expenses:BusinessExpenses 和 Expenses:BusinessExpenses:ChatGPT）。

2. 交易记录：接着，代码记录了 2023-03-01 至 2023-05-18 期间的一系列交易。

   • 2023-05-14 的交易表示从 Mercury Checking ••1234 向 CONTABO.COM 支付了 17.49 美元。这笔交易被记录为一项费用（Expenses:COGS:Contabo），并相应地从 Assets:Bank:Mercury 账户中扣除。

   • 同样，2023-05-11 的交易表示从同一银行账户向 Amazon Web Services 支付了 14490.33 美元。这笔交易记录在 Expenses:COGS:AmazonWebServices 下。

   • 2023-03-01 的交易显示来自 STRIPE 的收入存入 Mercury Checking ••1234，总计 21230.75 美元。这笔交易被记录为收入（Income:Stripe），并增加到银行账户（Assets:Bank:Mercury）中。

   • 2023-05-18 的最后一笔交易代表一笔涉及客户 19 ETH 的加密货币交易。这笔交易记录在 Assets:Crypto 和 Income:Crypto:ETH 下。{1,856.20 USD} 显示了交易时 ETH 的价格，而 @@ 35267.8 USD 则指明了这笔 19 ETH 交易的总价值。

在所有交易中，都遵循了复式记账原则，确保 资产 = 负债 + 权益 的等式始终成立。

总结​

这个 Beancount 账本提供了一个直接而强大的财务交易追踪系统。正如最后一笔交易所示，Beancount 足够灵活，可以核算加密货币等非传统资产，这证明了它在我们日益数字化的金融环境中的实用性。

我们希望这次剖析能帮助您更好地理解 Beancount 的结构和功能，无论您是经验丰富的会计师还是尝试管理个人财务的初学者。敬请关注我们的下一篇博客文章，届时我们将深入探讨 Beancount 的高级操作。

账户名称示例​

Assets:US:BofA:Checking

账户类型​

Assets          +
Liabilities     -
Income          -
Expenses        +
Equity          -

商品/货币​

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

指令​

通用语法

YYYY-MM-DD <Directive> <Parameters...>

开立与关闭账户​

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking     USD,EUR  ; 货币限制

2015-04-23 close Assets:Checking

声明商品/货币 (可选)​

1998-07-22 commodity AAPL
  name: "苹果电脑公司"

价格​

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL   130.28 CNY

备注​

2013-03-20 note Assets:Checking "致电询问回扣事宜"

文档​

2013-03-20 document Assets:Checking "path/to/statement.pdf"

交易​

2015-05-30 * "关于此交易的描述"
  Liabilities:CreditCard   -101.23 CNY
  Expenses:Restaurant       101.23 CNY

2015-05-30 ! "有线电视公司" "电话账单" #tag ˆlink
  id: "TW378743437"               ; 元数据
  Expenses:Home:Phone  87.45 CNY
  Assets:Checking                 ; 您可以省略其中一个金额

分录​

  ...    123.45 USD                             简单
  ...        10 GOOG {502.12 USD}               带单位成本
  ...        10 GOOG {{5021.20 USD}}            带总成本
  ...        10 GOOG {502.12 # 9.95 USD}        带两种成本
  ...   1000.00 USD   @ 1.10 CAD                带单位价格
  ...        10 GOOG {502.12 USD} @ 1.10 CAD    带成本与价格
  ...        10 GOOG {502.12 USD, 2014-05-12}   带日期
  ! ...   123.45 USD ...                        带标记

余额断言与填充​

; 仅断言指定货币的金额：
2015-06-01 balance Liabilities:CreditCard  -634.30 CNY

; 自动插入交易以满足以下断言：
2015-06-01pad Assets:Checking Equity:Opening-Balances

事件​

2015-06-01 event "location" "美国纽约"
2015-06-30 event "address" "梅街123号"

选项​

option "title" "我的个人账本"

其他​

pushtag #trip-to-peru
...
poptag  #trip-to-peru
; 注释以分号开头

探索 Beancount 纯文本记账的魔力

引言​

欢迎来到一个记账不再是艰巨任务的世界。今天，我们向您介绍 Beancount，一个强大、灵活且直观的纯文本记账工具。Beancount 通过提供透明、直接的资金管理方法，让您能够掌控自己的财务。

在这份全面的指南中，我们将深入探讨 Beancount 的基础知识，解释其核心概念，并引导您了解其简单而强大的功能。阅读完这篇博客，您将对 Beancount 有扎实的理解，并准备好开始使用它来整理和分析您的财务生活。

什么是 Beancount？​

Beancount 是由 Martin Blais 创建的一个开源纯文本记账系统。受 John Wiegley 的 Ledger 系统启发，Beancount 旨在提供一种强大可靠的方法，使用纯文本文件管理个人和小型企业的财务。通过 Beancount，您可以轻松追踪您的收入、支出、投资等等。

为什么选择 Beancount？​

纯文本记账相比传统的基于电子表格或软件的记账系统具有多项优势：

• 透明度：Beancount 文件是人类可读的，这使得理解和审计您的财务数据变得容易。
• 灵活性：Beancount 可以轻松定制以满足您的特定需求，您可以使用您喜欢的文本编辑器和版本控制系统来管理您的财务数据。
• 便携性：您的财务数据可以在任何设备上访问，并且易于在系统之间传输或与他人共享。
• 面向未来：纯文本文件具有通用兼容性，确保您的财务数据即使随着技术发展也能保持可访问性。

Beancount 的核心概念​

要有效使用 Beancount，理解其核心概念至关重要：

• 交易：财务事件，例如收入、支出或账户之间的转账，都记录为交易。
• 账户：交易涉及一个或多个账户，例如资产、负债、收入或支出。
• 复式记账：Beancount 强制执行复式记账，确保每笔交易都有平衡的借方和贷方。
• 指令：Beancount 使用一组指令来定义交易、账户开立和其他财务事件。

Beancount 入门​

要开始使用 Beancount，请遵循以下简单步骤：

• 安装 Beancount：根据您操作系统的安装说明，在您的系统上安装 Beancount。
• 创建您的 Beancount 文件：创建一个新的纯文本文件，扩展名为 .beancount（例如，my_finances.beancount）。
• 定义您的账户：使用 "open" 指令定义您将在交易中使用的账户。
• 记录交易：使用 "txn" 指令记录您的财务交易。

或者直接在 https://beancount.io 注册。以下是一些纯文本记账示例 -

示例 1：基本交易

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
  Assets:Checking         -50.00 USD
  Expenses:Groceries       50.00 USD

在此示例中，我们开立了两个账户：Assets:Checking（资产:活期账户）和 Expenses:Groceries（支出:食品杂货）。2023 年 4 月 10 日，我们记录了一笔价值 50 美元的购买食品杂货的交易。该交易使 Assets:Checking 的余额减少 50 美元（借方），并使 Expenses:Groceries 的余额增加 50 美元（贷方）。

示例 2：收入和支出交易

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
  Assets:Checking       2000.00 USD
  Income:Salary        -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
  Assets:Checking       -1000.00 USD
  Expenses:Rent          1000.00 USD

在此示例中，我们开立了三个账户：Assets:Checking（资产:活期账户）、Income:Salary（收入:工资）和 Expenses:Rent（支出:租金）。2023 年 4 月 5 日，我们记录了一笔 2000 美元的工资支付交易。该交易使 Assets:Checking 的余额增加 2000 美元（贷方），并使 Income:Salary 的余额减少 2000 美元（借方）。2023 年 4 月 6 日，我们记录了一笔 1000 美元的月租支付交易。该交易使 Assets:Checking 的余额减少 1000 美元（借方），并使 Expenses:Rent 的余额增加 1000 美元（贷方）。

示例 3：账户间转账

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
  Assets:Checking       -500.00 USD
  Assets:Savings         500.00 USD

在此示例中，我们开立了两个账户：Assets:Checking（资产:活期账户）和 Assets:Savings（资产:储蓄账户）。2023 年 4 月 15 日，我们记录了一笔从活期账户向储蓄账户转账 500 美元的交易。该交易使 Assets:Checking 的余额减少 500 美元（借方），并使 Assets:Savings 的余额增加 500 美元（贷方）。

这些示例说明了 Beancount 复式记账系统的基本概念。通过正确记录交易，用户可以维护其财务活动的准确记录，并生成报告以深入了解其财务状况。

生成报告和分析数据​

Beancount 附带了一套强大的工具，用于生成财务报告，包括资产负债表、利润表等。您还可以使用 Fava（一个基于 Web 的 Beancount 用户界面）来可视化和交互您的财务数据。https://beancount.io 是基于 MIT 许可证的 Fava 构建的。

结论​

拥抱 Beancount 纯文本记账的强大和简洁。通过理解其核心概念并遵循本指南中概述的步骤，您将能够轻松精确地管理您的个人或小型企业财务。随着您对 Beancount 越来越熟悉，您可以探索高级功能和自定义设置，以根据您的独特需求调整系统。

无论您是想追踪支出、规划未来，还是深入了解您的财务习惯，Beancount 都提供了实现目标所需的灵活性和透明度。凭借其用户友好的方法，Beancount 有潜力彻底改变您管理财务的方式，并赋能您掌控自己的财务未来。

现在您已经对 Beancount 有了坚实的基础，是时候开始您的纯文本记账之旅了。告别繁琐的电子表格和复杂的软件，欢迎来到 Beancount 的世界。祝您记账愉快！

现代簿记为何重要​

您还在用电子表格管理投资吗？虽然电子表格功能多样，但随着投资组合的增长，它们可能会变得笨重且容易出错。Beancount.io 应运而生——一个专为管理股票和加密货币投资组合而设计，既复杂又用户友好的投资追踪平台。Beancount.io 专为工程师和财务极简主义者打造，将强大的功能与直观的界面相结合，以简化您的投资追踪体验。

复式记账：准确性的基石​

Beancount.io 建立在复式记账的原则之上——这是一种全球金融机构都在使用的久经考验的方法。该系统通过一个简单而强大的概念确保数学准确性：每笔财务交易都必须完美平衡。

在复式记账中，每笔交易至少需要两个分录——一个借方 (+) 和一个贷方 (-)——涉及不同的账户。这种内置的验证系统使得记录不平衡的交易几乎不可能，从而确保您的财务记录保持准确和可靠。

1970-01-01 open Income:BeancountCorp
1970-01-01 open Assets:Cash
1970-01-01 open Expenses:Food
1970-01-01 open Assets:Receivables:Alice
1970-01-01 open Assets:Receivables:Bob
1970-01-01 open Assets:Receivables:Charlie
1970-01-01 open Liabilities:CreditCard

2019-05-31 * "BeancountCorp" "Salary of May 15th to May 31st"
  Income:BeancountCorp               -888 USD
  Assets:Cash                         888 USD

2019-07-12 * "Popeyes chicken sandwiches" "dinner with Alice, Bob, and Charlie"
  Expenses:Food 20 USD
  Assets:Receivables:Alice 20 USD
  Assets:Receivables:Bob 20 USD
  Assets:Receivables:Charlie 20 USD
  Liabilities:CreditCard -80 USD

如您在上面两个示例中所见，每笔交易都必须满足会计等式。

资产 = 负债 + 权益（即净资产）

我们使用 Martin Blais 的 Beancount 语法和 Jakob Schnitzer 的 Fava 网络项目来构建本网站。如果任何交易的分录总和不为零，它将向您发出警报。

现在您了解了我们如何强制执行账本的正确性。但您可能会问，这些“账户”是什么？

理解账户：水桶类比​

将您的财务账户想象成一个相互连接的水桶系统，金钱像水一样在其中流动。这个类比使得复式记账变得直观：当您将资金从一个账户转移到另一个账户时，就像将水从一个水桶倒入另一个水桶一样——系统中水的总量（金钱）保持不变。

Beancount.io 引入了五种账户。

1. 收入 — 其金额始终为负或在借方。这是因为您正在赚钱，然后资金从“收入”账户借记并贷记到您的“资产”账户。
2. 支出 — 其金额始终为正或在贷方。这是因为您正在花钱，资金从“资产”或“负债”流向“支出”账户。
3. 负债 — 其金额为正或为零。您的信用卡负债就是一个很好的例子，它会周期性地增减。
4. 资产 — 其金额为正或为零。您的现金或房屋总是具有一定的价值。
5. 权益 — 您的净资产。系统将自动为您计算。权益 = 资产 - 负债，它反映了您的财富状况。

现在您可以使用上述关键词打开您的自定义账户：

1970-01-01 open Assets:Cash
1970-01-01 open Assets:Stock:Robinhood
1970-01-01 open Assets:Crypto:Coinbase
1970-01-01 open Expenses:Transportation:Taxi
1970-01-01 open Equity:OpeningBalance

使用商品进行高级投资追踪​

Beancount.io 擅长追踪多样化的投资，从股票到加密货币。让我们探讨它如何处理复杂的投资场景。例如，以下是您在 2014 年以每枚 100 美元的价格购买 10 枚比特币的记录方式：

2014-08-08 * "Buy 10 Bitcoin"
  Assets:Trade:Cash -1000.00 USD
  Assets:Trade:Positions  10 BTC {100.00 USD}

三年后，您以每枚 10,000 美元的价格出售它们（原始成本为每枚 100 美元，用 {100.00 USD} 标注），价格用 @ 10,000.00 USD 标注。

2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @ 10,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD

或者相同的交易使用 @@ 20,000.00 USD，表示总价为 20,000 美元。

2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @@ 20,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD

交易所有分录的总和，包括 -2 BTC {100.00 USD}，仍然和往常一样为零。

成本标签 {100.00 USD} 很重要，因为您可能以不同的成本购买了相同的商品。

100 BTC {10.00 USD, 2012-08-08}
10 BTC {100.00 USD, 2014-08-08}

如果您想简化流程，可以在开始时将账户设置为 FIFO 或 LIFO。FIFO 代表先进先出，而 LIFO 代表后进先出。在美国，美国国税局 (IRS) 使用 FIFO 来计算您的损益和相应税款。

1970-01-01 open Assets:Trade:Positions "FIFO"

然后当您以 -2 BTC {} 这样的简写形式出售时，Beancount 将自动应用 FIFO 策略并出售最旧的商品。

开始使用 Beancount.io​

Beancount.io 是一个现代化的云端财务管理平台，它将您的文本交易记录转换为全面的财务报表，包括利润表、资产负债表和试算平衡表。通过将纯文本文件的可靠性与强大的可视化工具相结合，Beancount.io 帮助您精确控制财务生活，同时获得有关投资绩效的宝贵见解。

立即开始您的 Beancount.io 财务之旅——促销期间免费！