# QuickBooksからBeancountへの移行：カットオーバーガイド

カットオーバー日を決め、その前日のQuickBooks試算表をエクスポートし、貸借対照表の各勘定科目ごとに1つの`pad`と1つの`balance`でBeancount元帳を開きます。`bea check`が通り、Equityの残高がQuickBooksと一致すれば、帳簿の移行は完了です。カットオーバー以降のすべてはBeancountで記録します。

このガイドはQuickBooks OnlineとQuickBooks Desktopの両方で使えます。BeancountにはQuickBooksインポーターが同梱されていないため、特定のインポーターには依存しません。まず残高を移し、その後で履歴をどこまで持ち込むかを決めます。

まだ切り替えるかどうか迷っている場合は、先に[Beancount vs QuickBooks](/compare/beancount-vs-quickbooks)をお読みください。

## 1. カットオーバー日と引き継ぐものを決める

会計年度の初日、たとえば`2026-01-01`を選びます。年度の区切りで区切れば、1つの課税年度が1つのシステムに収まります。また、Beancountでの最初の損益計算書がゼロから始まることにもなります。

Beancountにどの程度の履歴を保持するかをここで決めます：

- **残高のみ。** カットオーバー時点で開き、それ以前の年はQuickBooksのレポートをアーカイブとして保持します。これが最速の方法で、このガイドの残りの部分はこれを前提としています。
- **年次サマリー。** 過去の各年の試算表から、1年につき1つのサマリーエントリを追加します。これで複数年にわたるレポートがBeancountでも機能します。
- **完全な取引履歴。** 総勘定元帳のエクスポートをスクリプトで変換します。これが最も手間がかかり、セクション5でその内容を説明します。

カットオーバー前日までのすべての銀行口座とカード口座の照合をQuickBooksで完了させてください。未照合の残高は、その誤差を新しい元帳に持ち込んでしまいます。

## 2. QuickBooksからエクスポートする

カットオーバー前日（このガイドでは`2025-12-31`）を末日とする3つのレポートが必要です：

| レポート | 得られるもの |
| --- | --- |
| 勘定科目一覧 | すべての勘定科目名と種類。ステップ3のマッピングに使用 |
| 試算表 | 各勘定科目の期末残高。開始残高になる |
| 総勘定元帳 | すべての取引。履歴とアーカイブ用 |

**QuickBooks Online。** **レポート**、次に**標準レポート**へ進み、各レポートを名前で開きます。**エクスポート/印刷**、次に**Excelへエクスポート**を選択します。勘定科目一覧は勘定科目表のレポートです。**設定**の**ツール**列にある**データのエクスポート**ツールは、レポートとリストのセットを1つのzipファイル内のExcelファイルとしてエクスポートします。Intuitは両方の手順を[Export your QuickBooks Online data](https://quickbooks.intuit.com/learn-support/en-us/help-article/list-management/export-reports-lists-data-quickbooks-online/L1xleDrLp_US_en_US)で説明しています。

これらのQuickBooks OnlineのエクスポートはExcelファイルです。スクリプトで読み込む場合は、各ファイルを表計算ソフトで開いてCSVコピーとして保存してください。

**添付ファイル**は別途エクスポートします。QuickBooks Onlineでは、**設定**、次に**添付ファイル**へ進み、ファイルを選択して**一括操作**、次に**エクスポート**を選びます。zipファイルはアーカイブと一緒に保管してください。

**QuickBooks Desktop。** Windowsでは、**レポート**、次に**レポートセンター**から各レポートを開きます。**Excel**、次に**新しいワークシートを作成**を選択します。次のウィンドウでは、[Export reports as Excel workbooks](https://quickbooks.intuit.com/learn-support/en-us/help-article/export-reports/export-reports-excel-workbooks-quickbooks-desktop/L4cLJEeXt_US_en_US)で説明されているように、ExcelワークブックまたはCSVファイルを直接保存できます。Desktopでは、勘定科目表を含むリストをIIFファイルとしてエクスポートすることもできます：**ファイル**、次に**ユーティリティ**、次に**エクスポート**、次に**IIFファイルへのリスト**です。IIFエクスポートが対象とするのはリストのみです。Intuitは、取引はインポートできるがエクスポートはできないと述べており、これは[Export, import, and edit IIF files](https://quickbooks.intuit.com/learn-support/en-us/help-article/import-export-data-files/export-import-edit-iif-files/L56LT9Z0Q_US_en_US)で説明されています。

元のエクスポートは変更せずに保管してください。後で数値について疑義が生じた場合の証拠となります。

## 3. 勘定科目をBeancountの階層にマッピングする

Beancountには5つのルート勘定科目があります。すべてのQuickBooks勘定科目タイプは、そのうちの1つの下に収まります：

| QuickBooks勘定科目タイプ | Beancount勘定科目 |
| --- | --- |
| 銀行 | `Assets:Bank:Checking`、`Assets:Bank:Savings` |
| 売掛金（A/R） | `Assets:AccountsReceivable` |
| その他の流動資産、固定資産 | `Assets:Prepaid:…`、`Assets:Equipment:…` |
| クレジットカード | `Liabilities:CreditCard:Visa` |
| 買掛金（A/P）、その他の流動負債 | `Liabilities:AccountsPayable`、`Liabilities:SalesTax` |
| 長期負債 | `Liabilities:Loans:…` |
| Equity、Retained Earnings、Opening Balance Equity | `Equity:Opening-Balances` |
| 収益、その他の収益 | `Income:Sales`、`Income:Interest` |
| 売上原価 | `Expenses:COGS:…` |
| 費用、その他の費用 | `Expenses:Rent`、`Expenses:Software` |

勘定科目名は大文字で始まり、スペースを含みません。そのため「Office Supplies」は`Expenses:Office-Supplies`になります。QuickBooksのサブ勘定科目は、`Expenses:Vehicle:Fuel`のように、より深いセグメントになります。

Retained EarningsとOpening Balance Equityは、1つの`Equity:Opening-Balances`勘定科目に統合されます。Beancountは収益と費用の勘定科目から当期純利益を計算するため、別個の繰越利益剰余金勘定科目を繰り越す必要はありません。

## 4. カットオーバー時に元帳を開く

このサンプル企業は`2025-12-31`時点で4行の試算表を持っています。収益と費用の行はすでにRetained Earningsに集約されています。QuickBooks Onlineも、新しい会計年度が始まるときに同じ処理を自ら行います。これは[View retained earnings account details](https://quickbooks.intuit.com/learn-support/en-us/help-article/financial-reports/view-retained-earnings-account-details/L7d6Ugx58_US_en_US)で説明されています。

| 勘定科目 | 借方 | 貸方 |
| --- | --- | --- |
| 当座預金 | 12,450.00 | |
| 売掛金（A/R） | 3,200.00 | |
| Visaクレジットカード | | 1,875.40 |
| Retained Earnings | | 13,774.60 |
| **合計** | **15,650.00** | **15,650.00** |

これを`main.bean`として保存します：

```beancount
option "operating_currency" "USD"

2025-12-31 open Assets:Bank:Checking USD
2025-12-31 open Assets:AccountsReceivable USD
2025-12-31 open Liabilities:CreditCard:Visa USD
2025-12-31 open Equity:Opening-Balances USD

; Opening balances from the QuickBooks Trial Balance as of 2025-12-31
2025-12-31 pad Assets:Bank:Checking Equity:Opening-Balances
2025-12-31 pad Assets:AccountsReceivable Equity:Opening-Balances
2025-12-31 pad Liabilities:CreditCard:Visa Equity:Opening-Balances

2026-01-01 balance Assets:Bank:Checking 12450.00 USD
2026-01-01 balance Assets:AccountsReceivable 3200.00 USD
2026-01-01 balance Liabilities:CreditCard:Visa -1875.40 USD
2026-01-01 balance Equity:Opening-Balances -13774.60 USD
```

各`pad`は、次の`balance`アサーションを真にするエントリをBeancountに挿入させるものです。各padの貸借を合わせる側は`Equity:Opening-Balances`に入ります。`balance`アサーションはその日付の開始時点でチェックされるため、padの日付はカットオーバーの前日となります。

借方（デビット）は正の数値になり、貸方（クレジット）は負の数値になります。これがVisaの残高が`-1875.40 USD`である理由です。

最後の行が照合チェックです。EquityはRetained Earningsの貸方である`-13774.60 USD`にならなければなりません。資産または負債の数値を打ち間違えると、padで調整されるEquityが変わり、そのアサーションが失敗します。

実際の企業では、試算表にある貸借対照表の各勘定科目ごとに、1つの`open`、1つの`pad`、1つの`balance`を追加します。未処理の請求書を名前で追跡している場合は、A/RとA/Pを顧客または仕入先ごとに1つのサブ勘定科目に分割します。

## 5. 履歴を持ち込む

カットオーバー後は、新しい活動をBeancountで記録します。銀行およびカードの明細が主な情報源です。銀行のCSVエクスポートはブラウザで[CSV to Beancount converter](/tools/csv-to-beancount)を使って変換するか、コマンドラインでは[bank import guide](https://beancount.io/ja/docs/Solutions/import-bank-exports-cli)を使用してください。

過去の年は任意です。QuickBooksの総勘定元帳エクスポートからのワンクリックインポートはありません。その履歴の移行は、スクリプトまたは手作業によるマッピングのステップです：

1. 総勘定元帳のエクスポートをCSVとして保存します。
2. その行を日付と取引番号で取引ごとにグループ化します。
3. 各勘定科目を、ステップ3のマッピングで名称変更します。
4. 各グループを、その転記がゼロに合計されるBeancount取引として記述します。

履歴を持ち込む場合は、カットオーバー時ではなくその履歴の開始時点で勘定科目を開きます。その後、`2026-01-01`の残高アサーションを保持してください。これにより、変換された履歴がQuickBooksの報告と同じ残高に到達することが証明されます。

## 6. QuickBooksと照合する

元帳をチェックし、次にすべての残高を一覧表示します：

```bash
bea --file main.bean check
bea --file main.bean query "SELECT account, sum(position) GROUP BY account ORDER BY account"
```

`bea check`はエラーを報告しません。クエリは4行を返します：`Assets:AccountsReceivable`が`3200.00 USD`、`Assets:Bank:Checking`が`12450.00 USD`、`Equity:Opening-Balances`が`-13774.60 USD`、`Liabilities:CreditCard:Visa`が`-1875.40 USD`です。各行をQuickBooksの試算表と、貸方を負の数値として、1行ずつ比較してください。

コマンドラインが初めての場合は、[CLI quick start](https://beancount.io/ja/docs/Basics/bea-cli)で`bea`をインストールしてください。

## 7. 引き継がれないもの

元帳の移行では、会計の残高と履歴が移ります。QuickBooksがその周辺で実行している業務までは移りません：

- **請求書と支払リンク。** 未処理の請求書はA/R残高として残ります。今後は別の請求書発行サービスを使用してください。
- **給与。** 給与支払、税務フォーム、従業員記録は給与プロバイダーに残ります。
- **売上税の申告。** Beancountは負債を記録します。申告は別の作業として残ります。
- **添付ファイル。** 領収書と書類は、レポートではなく独自のzipエクスポートで出てきます。
- **銀行フィードのルールと照合履歴。** 分類はインポートルールとして再構築します。

比較ページにはこう明記されています：いくつかのプラグインがQuickBooksの業務スイート全体を再現してくれるという前提でBeancountを選んではいけません。元帳そのものが長く使える記録のシステムとなる場合に選んでください。

Beancountで小さなビジネスを運営していますか？ホスト型元帳、Bank Sync、会計士とのコラボレーションについては、[Beancount.io for small business](/for-small-business)をご覧ください。
