用語集

プレーンテキスト会計は複式簿記から語彙を借用し、Beancount固有の単語をいくつか追加しています。この用語集では、このドキュメントや自分の台帳ファイルを読む際に出会う用語を、役立つ場合は短い例とともに定義します。各項目には個別のリンクがあり、チームメイトを定義に直接誘導できます。

Account（勘定科目）​

勘定科目とは、価値の流れを追跡する名前付きの入れ物であり、5つのルートタイプ（Assets、Liabilities、Equity、Income、Expenses）のいずれかの下にコロン区切りの階層として記述されます。この階層が帳簿全体の構成構造であり、Assets:US:BofA:Checking や Expenses:Food:Restaurant は自動的にソートおよび集約されます。すべての勘定科目は使用前に宣言されなければなりません。命名規則については Beancount 言語構文 を参照してください。

Accrual basis（発生主義）​

発生主義会計は、現金が実際に動いた時期に関係なく、収入を得た時点と費用が発生した時点で記録します。現金主義会計はこれとは逆で、金銭の受け渡しがあった時点でのみ両方を認識します。発生主義は期間の業績をより正確に示すため、3月に送付した請求書が5月に支払われても3月に属するのはそのためです。

Amortization（償却）​

償却は、単一の大きな支払いをそれが実際にカバーする期間に分散させるため、各月が公平なコストを負担します。1月に支払われた年間保険料は、1月だけでなく12ヶ月すべての費用です。Beancountでは、分割転記を手動で記述するか、プラグインで生成します — 償却 を参照してください。

Balance assertion（残高アサーション）​

残高アサーションは balance ディレクティブであり、特定の日付の開始時点での勘定科目の残高を指定します。これにより、銀行取引明細書が自動的に帳簿のチェックとして機能します。計算された残高が異なる場合、Beancountは期待値と実際の値を示してエラーを出力します。勘定科目ごと、取引明細書ごとに1つのアサーションを散りばめることは、台帳の信頼性を維持する最も簡単な方法です。

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancountはオープンソースの複式簿記システムであり、台帳は任意のテキストエディタで編集し、コマンドラインツールで検証するプレーンテキストファイルです。データベースや独自のファイル形式なしに、厳格で解析可能な構文、クエリ言語、およびWebインターフェースを提供します。台帳がテキストであるため、コードと共にGitで問題なく管理できます。まずは Beancount 入門 から始めてください。

Beancount Query Language（Beancountクエリ言語）​

Beancount Query Language（通常BQLと略される）は、台帳に質問するために使用するSQLに似た言語です。データベースではなく解析済みディレクティブに対して実行されるため、SELECT account, sum(position) WHERE year = 2026 は編集している同じファイルから即座に回答します。完全な文法については クエリ言語ガイド を読んでください。

Booking method（ブッキングメソッド）​

ブッキングメソッドとは、減少が既存のどのロットを引き落とすかを選択する必要がある場合にBeancountが適用するルールです。選択肢は STRICT（自分でロットを特定する必要がある）、FIFO、LIFO、AVERAGE、NONE で、勘定科目の open ディレクティブごとに設定します。選択した方法は実現キャピタルゲインを変えるため、自分の税務管轄が期待する方法を選び、それを安定して維持してください。

Chart of accounts（勘定科目一覧）​

勘定科目一覧とは、台帳が使用するすべての勘定科目の完全なリストであり、それらを整理する構造も含みます。Beancountには別個の科目一覧ファイルはなく、open ディレクティブの集合がそのまま勘定科目一覧となります。初期に適切に設計することで後での名称変更が大幅に減ります。出発点については 業種別設定 を参照してください。

Close directive（クローズディレクティブ）​

close ディレクティブは、勘定科目が使用できなくなる日付を指定します。これにより、銀行口座や完済したローンの履歴を削除せずに使えなくします。過去の取引は有効でレポート可能なままですが、新しい転記のみが拒否されます。未使用の勘定科目を閉じることで、台帳が古くなるにつれてレポートの可読性が保たれます。

2026-03-31 close Assets:US:OldBank:Checking

Commodity（商品）​

商品とは、台帳が追跡する任意の価値の単位です — USD のような通貨、AAPL のような株式ティッカー、BTC のような暗号資産、または VACATION-DAYS のような独自に作成したもの。Beancountは商品間の変換を内部的に行わないため、金額は常に数値とその建値の商品のペアです。オプションの commodity ディレクティブを使用すると、名称や資産クラスなどのメタデータを添付できます。

Cost basis（原価基準）​

原価基準とは、保有資産に対して実際に支払った金額であり、支払いに使用した通貨で記録され、保有している間は保有資産と共に保持されます。Beancountはこれを中括弧で記述します — 10 AAPL {150.00 USD} は、1株150ドルで取得した10株を意味します。原価はポジションと共に移動するため、売却時にキャピタルゲインが自動的に計算されます。在庫管理 を参照してください。

Directive（ディレクティブ）​

ディレクティブは、Beancountファイル内の日付付きの命令であり、台帳に含まれるのはこれだけです。日付で始まるすべての行がディレクティブです：open、close、balance、price、note、document、pad、event、commodity、そして取引そのもの。Beancountは処理前にディレクティブを日付順にソートするため、読みやすい順序で配置できます。

Double-entry bookkeeping（複式簿記）​

複式簿記とは、すべての経済的出来事を少なくとも2つの対応する記録として記録する慣行であり、金額が常に合計でゼロになるようにします。お金は作成も破棄もされず、勘定科目間を移動するだけであり、これが単一列のリストでは決して発見できないエラーを捉える理由です。Beancountはこの規則を厳密に適用します：転記のバランスが取れていない取引は警告ではなくエラーとなります。

Envelope budgeting（封筒予算）​

封筒予算は、支出する前にお金を目的別に確保するため、各カテゴリが1つのプールされた残高を競うのではなく、独自の制限を持ちます。この名前は、かつて人々が給料日に現金を入れた紙の封筒に由来します。プレーンテキストの台帳では、専用の勘定科目または予算ディレクティブを使用して封筒をモデル化します — 予算 を参照してください。

Fava​

FavaはBeancountのWebインターフェースです：グラフ、貸借対照表、損益計算書、クエリエディタ、入力フォームを台帳ファイルから提供します。主に読み取り専用でローカルで動作するため、記録方法を変えずに帳簿の 見え方 を変えます。beancount.ioは独自のツールと共に管理バージョンをホストしています。UI機能 ガイドでそこでできることをカバーしています。

Inventory（在庫）​

在庫とは、勘定科目が現在保有するポジションの集まりであり、それぞれに独自の商品、および関連する場合は独自の原価基準と取得日があります。同じ株式を3回購入した証券口座は、1つのブレンドされた数値ではなく、1つの在庫内に3つの個別のロットを保持します。ロットを区別することで、正確なキャピタルゲイン計算が可能になります。

Journal（仕訳帳）​

仕訳帳は、帳簿内で発生したすべての出来事の時系列リストです — 日付順の生の取引ストリームであり、グループ化や集約前のものです。「3月に実際に何をしたか？」という質問に答えるときに参照するビューです。Favaの仕訳帳ページは、通常、誤分類されたエントリを見つける最も速い場所です。

Ledger（台帳）​

台帳は、1つのエンティティに関する会計記録の完全なセットであり、Beancountではプレーンテキストファイル（およびそれがインクルードするものすべて）を意味します。この言葉は、勘定科目の全書とファイル自体の両方を指します。テキストであるため、台帳はソースコードのように差分比較、レビュー、ブランチ、マージが可能です。

Lot（ロット）​

ロットとは、商品の特定の取得を指し、その原価基準と取得日によって識別されます。同じETFを1月と6月に購入すると2つのロットが作成され、後で売却する場合はどのロットを売却するかを選択します。ロットこそが、Beancountがキャピタルゲインを正確に計算できる理由です。

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narration（説明）​

説明とは、取引の目的を自由形式のテキストで記述したものであり、取引行の2番目の引用符で囲まれた文字列として記述されます。人間のためのものです：「月額家賃」、「食料品と日用品」。Beancountはこれを解析しませんが、半年後にエントリが意味不明になった時に読むものです。

Open directive（オープンディレクティブ）​

open ディレクティブは、勘定科目、使用開始日、およびオプションで保有を許可する商品と使用するブッキングメソッドを宣言します。Beancountは、最初の転記の前にすべての勘定科目を開くことを要求します。これにより、タイプミスが新しい勘定科目を静かに作成するのを防ぎます。許可された商品を制限することで、別のクラスのミス全体をエラーに変えます。

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad（パッド）​

pad ディレクティブは、勘定科目の次の残高アサーションを成功させるために必要な金額を挿入し、その差額を別の勘定科目に計上するようBeancountに指示します。これは正確に1つのジョブのために存在します：何年もの履歴を再構築せずに、台帳を途中から開くことです。その初期設定を超えたパディングは、通常、実際のエラーが隠されていることを意味します。

Payee（支払先）​

支払先とは、取引を行った相手であり、取引行の最初の引用符で囲まれた文字列として記述されます。支払先を一貫して保つこと（常に "Whole Foods"、決して "WholeFoods" としない）が、支払先ベースのレポートと自動インポーターを機能させる鍵です。Beancountは支払先をオプションとして扱います。取引は説明のみを持つこともあります。

Plain-text accounting（プレーンテキスト会計）​

プレーンテキスト会計とは、バージョン管理下にある人間が読めるテキストファイルで帳簿を管理し、オープンソースのコマンドラインツールで処理する慣行です。ポイントアンドクリックインターフェースを、耐久性、監査可能性、自動化と交換します：データはベンダーよりも長持ちし、すべての変更はレビュー可能な差分であり、任意のスクリプトが読み取れます。Beancount、Ledger、hledgerが最もよく知られた実装です。

Plugin（プラグイン）​

プラグインは、Beancountがファイルを処理中にロードするPythonモジュールであり、レポートが構築される前にディレクティブの追加、変換、検証を可能にします。プラグインは、予測、償却スケジュール、カスタムチェックをコア言語を変更せずに実装する方法です。台帳の先頭に plugin 行を追加して有効にします — 予測プラグイン ガイドで実際の例を説明しています。

Posting（転記）​

転記とは、取引の1つの足（レッグ）です：勘定科目、金額、およびオプションで原価または価格。取引には少なくとも2つの転記が必要であり、その金額は合計でゼロになる必要があります。最大1つの転記は金額を空白にでき、その場合Beancountがバランスを取る数値を計算します。

Price directive（価格ディレクティブ）​

price ディレクティブは、ある日付における2つの商品間の為替レートを記録します。これにより、Beancountは保有資産をレポート内の市場価値に換算します。価格は純粋な参照データであり、資金を移動させることはなく、取引に表示されることもありません。これらがない場合、ポートフォリオは原価でバランスは取れますが、市場価値で評価することはできません。

2026-06-30 price VTI   271.40 USD

Reconciliation（照合）​

照合とは、帳簿が銀行や証券会社の取引明細書などの外部記録と一致することを証明する行為です。プレーンテキスト会計では、これはほぼ機械的です：各取引明細書の日付に残高アサーションを追加し、ツールに数値が一致するかどうかを判断させます。毎月きれいに照合される台帳は、税金申告を安心して行えるものです。

Tags and links（タグとリンク）​

タグとリンクは、勘定科目階層の外で取引をグループ化するために取引に付ける2つのラベルです：# 付きのタグは #trip-japan のようなテーマを示し、^ 付きのリンクは ^invoice-2026-014 のような関連エントリを結びつけます。タグは「このカテゴリのすべてを表示」に答え、リンクは「このイベントに属するエントリを表示」に答えます。どちらもFavaでフィルタリング可能で、BQLでクエリ可能です — フィルタリングと検索 を参照してください。

Transaction（取引）​

取引とは、日付付きの経済的出来事とそれを記録する転記であり、最も頻繁に記述するディレクティブです。フラグ（* は確認済み、! は確認要）、オプションの支払先、説明、および金額が合計でゼロになる2つ以上の転記を持ちます。Beancountファイル内の他のすべては、取引を宣言、チェック、または注釈するために存在します。

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

まだ単語で行き詰まっていますか？ ヘルプセンター にはこのサイトのすべてのガイドがインデックスされており、チートシート は各ディレクティブの構文を並べて表示しています。