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

Beancount チートシート:構文とディレクティブ

1ページでわかる Beancount 構文リファレンス:勘定タイプと符号、コモディティ、取引とポスティング、残高、メタデータ、イベント、タグ、オプション。

勘定科目構造​

勘定科目タイプと符号​

タイプ        符号    例
------------------------------------------------
Assets        (+)     Assets:US:BofA:Checking
Liabilities   (-)     Liabilities:Credit:Amex
Income        (-)     Income:Salary:Gross
Expenses      (+)     Expenses:Food:Restaurant
Equity        (-)     Equity:Opening-Balances

通貨形式​

コモディティは大文字のシンボルです — 通貨、ティッカー、およびカスタム単位。以下は命名例であり、ディレクティブではありません:

通貨:             USD, EUR, CAD, AUD
投資:             GOOG, AAPL, VTI
暗号通貨:         BTC, ETH
カスタム単位:     HOURS, AIRMILES, HOME_MAYST

ディレクティブ構文​

勘定科目管理​

; 勘定科目の開設
2024-01-01 open Assets:Checking             ; シンプル
2024-01-01 open Assets:Investing USD,GOOG   ; 制約付き
 
; 勘定科目の閉鎖
2024-12-31 close Assets:Old:Account

コモディティ宣言​

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

取引記録​

; 基本的な取引
2024-01-15 * "Grocery Store" "Weekly shopping"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries
 
; メタデータとタグ付き (#work はタグ、^invoice-123 はリンク)
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

ポスティング仕様​

これらはポスティング行です — それぞれが取引内にあり、日付行の下にインデントされます:

; 基本的な金額
Assets:Cash              100.00 USD
 
; 取得原価の追跡
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        ; 1単位あたりの原価
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     ; 総原価
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} ; 1単位あたりの原価 + 総手数料
 
; 価格の指定
Assets:Forex            1000.00 USD @ 0.85 EUR        ; 1単位あたり
Assets:Forex            1000.00 USD @@ 850.00 EUR     ; 総額
 
; 日付付きロット
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

残高検証​

; 残高のパディング: Assets:Checking を Equity:Opening-Balances まで埋める
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; 残高アサーション: その日付の開始時にチェックされるため、pad の後の日付にする
2024-02-01 balance Assets:Checking  1000.00 USD

メタデータ追跡​

; ノートの添付
2024-01-15 note Assets:Checking "Called bank about fee"
 
; ドキュメントのリンク
2024-01-15 document Assets:Checking "path/to/statement.pdf"
 
; 価格の記録
2024-01-15 price VTSAX  100.00 USD

ホスト型の台帳では、Live Prices が日付付きの評価価格を自動的に提供できます。ピッカーでサポートされている資産ペアを選択し、インクルードを台帳にコピーしてください。取引価格と取得原価は明示的に保ちましょう。

イベント記録​

; 場所の追跡
2024-01-15 event "location" "New York, USA"
 
; プロパティの変更
2024-01-15 event "address" "123 Main Street"

タグ管理​

; タグスコープの制御: #vacation は pushtag と poptag の間のすべての取引に適用される
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

設定オプション​

; 基本設定
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"
 
; 勘定科目の命名
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
 
; ドキュメントの処理
option "documents" "/path/to/docs"

コメントと整理​

; 1行コメント
 
* セクションヘッダー
** サブセクション
; 取引ブロックが続く...
 
; 勘定科目のグループ化
; Assets
2024-01-15 ...
 
; Expenses
2024-01-16 ...

このリファレンスは、Beancount の構文要素の完全な概要を実用例とともに提供します。

出典: https://beancount.io/ja/docs/Basics/cheatsheet