メインコンテンツへスキップ

Beancountチュートリアル：インストールと最初の台帳

Beancountをインストールし、最初の台帳ファイルを作成し、勘定科目とオプションを設定して検証する — 初めての成功体験を導くチュートリアル。

財務管理を掌握する準備はできましたか？このガイドでは、数分でBeancountを使い始めることができます。最初の元帳の作成、必須勘定科目の設定、最初の取引の記録方法を学べます。

beancount.ioジャーナルビュー（ディレクティブタイプフィルタ付きのプレーンテキスト複式取引を一覧表示）

ライブ元帳を探索する →

初期設定​

最初の元帳を作成する​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

必須の設定​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

ファイル構成​

推奨される構造​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

セクションの構成​

  1. 恒久勘定科目

    2024-01-01 open Liabilities:Payables    USD
2024-01-01 open Assets:Receivables      USD

  2. 銀行口座

    2024-01-01 open Assets:Bank:Checking     USD
2024-01-01 open Assets:Bank:Savings      USD
2024-01-01 open Income:Bank:Interest     USD

  3. 投資口座

    2024-01-01 open Assets:Investment:Cash    USD
2024-01-01 open Assets:Investment:Stocks  VTSAX
2024-01-01 open Income:Investment:Dividend USD

検証とレポート​

基本的な検証​

# Check for errors (exits 0 when clean)
bea --file ledger.beancount check
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bea checkはバリデータです。元帳がクリーンな場合は終了コード0で終了し、エラーがある場合はすべてのエラーをリストして非ゼロの終了コードで終了します。CLIクイックスタートでインストールしてください。FavaはWebインターフェースです。これを実行し、表示されるhttp://localhost:5000アドレスを開いて、貸借対照表、損益計算書、口座ジャーナルを確認してください。

一般的なレポート​

Beancount 3は、FavaのWebインターフェース、ワンコマンドのbea report、またはBeancountクエリ言語を実行するbea queryによるアドホッククエリを通じてレポートを生成します。Beancount 3は古いレポートおよびWebコマンドを削除しました。bea reportとFavaがそれらを置き換えます。

# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
 
# Income statement, in one command
bea --file ledger.beancount report income-statement
 
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

初期残高の管理​

パディングの例​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

balanceアサーションは、その日付の開始時点の口座をチェックするため、含めるべきpad（または任意の取引）より後に日付を設定する必要があります。padとbalanceを同じ日に設定すると、パッドは未使用のままとなり、アサーションは不足します。BeancountはUnused Pad entryおよびBalance failedを報告します。Equity:Opening-Balances勘定科目は、パディングされる前に開設されている必要があります。

口座の閉鎖​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

取引の重複排除​

振替の処理​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

残高アサーション​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

ベストプラクティス​

  1. ファイル構成

    • 最初はメインファイルを1つに保つ
    • 明確なセクションヘッダーを使用する
    • 関連する勘定科目をまとめる

  2. 勘定科目名

    • 一貫した命名規則を使用する
    • 国/機関のプレフィックスを含める
    • 論理的な階層を維持する

  3. 残高の検証

    • 定期的な残高アサーション
    • 口座を適切にパディングする
    • 口座の閉鎖を追跡する

  4. 通貨の処理

    • 運用通貨を宣言する
    • 一貫した商品コードを使用する
    • 通貨の制約を指定する

次のステップ​

基本的な元帳を設定できたので、次に進みましょう：

  1. 定期的な取引を記録する: 毎日の支出と収入から始めましょう
  2. 銀行口座のインポートを設定する: CSVインポートまたはバンクコネクションを使用してデータ入力を自動化します。取引明細のエクスポートをCSVからBeancountへの変換ツールに貼り付けると、ブラウザでバランスの取れたエントリを取得できます。または、OFX & QIFからBeancountへを使用して、.ofx、.qfx、.qifのダウンロードを処理します。
  3. 実証済みのレイアウトをコピーする: 動作する元帳の例の家庭、封筒予算、またはフリーランスのセクションから実行可能なスターターファイルをダウンロードし、同じギャラリーの資産および投資パターンを適合させます
  4. 高度な構文を学ぶ: 構文リファレンスでより複雑なシナリオを探索します
  5. 最初のレポートを生成する: UI機能を使用して財務レポートを作成し、支出を分析します
  6. ターミナルで作業する: CLIクイックスタートでbeaコマンドラインをインストールし、beaでの最初の月で月次決算を最初から最後まで完了させます

クイックリファレンス​

一般的な勘定科目タイプ:

  • Assets:Bank:Checking - 当座預金口座
  • Expenses:Food:Groceries - 食料品の支出
  • Income:Salary:Company - 雇用収入
  • Liabilities:CreditCard:Visa - クレジットカードの負債

必須コマンド:

  • bea --file ledger.beancount check - 元帳を検証します（エラーがある場合は非ゼロで終了）
  • bea --file ledger.beancount report balance-sheet - 貸借対照表を出力します
  • bea --file ledger.beancount query "SELECT ..." - 残高と取引を照会します
  • fava ledger.beancount - レポートとチャート用のWebインターフェースを起動します

これらのガイドラインは、Beancountで個人財務を管理するための確固たる基盤を確立します。最初の取引を追加する準備はできましたか？UI取引ガイドをご覧ください。

Beancountチュートリアル：インストールと最初の台帳

出典: https://beancount.io/ja/docs/Basics/getting-started