Von QuickBooks zu Beancount migrieren: ein Leitfaden zur Umstellung

Legen Sie ein Umstellungsdatum fest, exportieren Sie die QuickBooks-Probebilanz für den Tag davor und eröffnen Sie Ihr Beancount-Journal mit einem pad und einem balance pro Bilanzkonto. Wenn bea check durchläuft und der Eigenkapitalsaldo mit QuickBooks übereinstimmt, ist Ihre Buchhaltung umgezogen. Alles nach dem Umstellungsdatum wird in Beancount erfasst.

Dieser Leitfaden gilt für QuickBooks Online und QuickBooks Desktop. Er hängt nicht von einem QuickBooks-Importer ab, denn Beancount bringt keinen mit. Sie übertragen zuerst die Salden und entscheiden dann, wie viel Historie Sie mitnehmen.

Wenn Sie noch überlegen, ob Sie wechseln sollen, lesen Sie zuerst Beancount vs QuickBooks.

1. Umstellungsdatum festlegen und entscheiden, was Sie übernehmen​

Wählen Sie den ersten Tag eines Geschäftsjahres, etwa 2026-01-01. Eine Jahresgrenze hält ein Steuerjahr in einem System. Außerdem bedeutet sie, dass Ihre erste Beancount-Gewinn-und-Verlust-Rechnung bei null beginnt.

Entscheiden Sie jetzt, wie viel Historie Beancount enthalten soll:

• Nur Salden. Eröffnen Sie zum Umstellungsdatum und behalten Sie die QuickBooks-Berichte als Archiv für frühere Jahre. Das ist der schnellste Weg, und der Rest dieses Leitfadens geht davon aus.
• Jahreszusammenfassungen. Fügen Sie pro vergangenem Jahr einen Sammelbuchungssatz aus der jeweiligen Jahres-Probebilanz hinzu. Dann funktionieren Ihre Mehrjahresberichte in Beancount.
• Vollständige Buchungshistorie. Konvertieren Sie den Hauptbuch-Export mit einem Skript. Das ist der größte Aufwand, und Abschnitt 5 erläutert, was dazugehört.

Schließen Sie in QuickBooks die Abstimmung jedes Bank- und Kreditkartenkontos bis zum Tag vor dem Umstellungsdatum ab. Ein nicht abgestimmter Saldo trägt seinen Fehler in Ihr neues Journal.

2. Aus QuickBooks exportieren​

Sie brauchen drei Berichte, alle mit Enddatum am Tag vor dem Umstellungsdatum (in diesem Leitfaden 2025-12-31):

QuickBooks Online. Gehen Sie zu Berichte, dann Standardberichte, und öffnen Sie jeden Bericht über seinen Namen. Wählen Sie Exportieren/Drucken, dann Nach Excel exportieren. Die Kontenliste ist der Bericht zum Kontenplan. Das Werkzeug Daten exportieren unter Einstellungen in der Spalte Tools exportiert eine Reihe von Berichten und Listen als Excel-Dateien in einer ZIP-Datei. Intuit dokumentiert beide Wege in Export your QuickBooks Online data.

Diese QuickBooks-Online-Exporte sind Excel-Dateien. Öffnen Sie jede in einer Tabellenkalkulation und speichern Sie eine CSV-Kopie, wenn ein Skript sie einlesen soll.

Anhänge werden separat exportiert. Gehen Sie in QuickBooks Online zu Einstellungen, dann Anhänge, wählen Sie die Dateien aus und wählen Sie Batch-Aktionen, dann Exportieren. Bewahren Sie die ZIP-Datei in Ihrem Archiv auf.

QuickBooks Desktop. Öffnen Sie unter Windows jeden Bericht über Berichte, dann Berichtscenter. Wählen Sie Excel, dann Neues Arbeitsblatt erstellen. Das nächste Fenster kann direkt eine Excel-Arbeitsmappe oder eine CSV-Datei speichern, wie in Export reports as Excel workbooks beschrieben. Desktop kann Listen, einschließlich des Kontenplans, auch als IIF-Datei exportieren: Datei, dann Dienstprogramme, dann Exportieren, dann Listen in IIF-Dateien. Der IIF-Export umfasst nur Listen. Intuit gibt an, dass Sie Buchungen importieren, aber nicht exportieren können, wie in Export, import, and edit IIF files erläutert.

Bewahren Sie die Original-Exporte unverändert auf. Sie sind Ihr Beleg, falls später eine Zahl angezweifelt wird.

3. Konten einer Beancount-Hierarchie zuordnen​

Beancount hat fünf Wurzelkonten. Jeder QuickBooks-Kontotyp landet unter einem davon:

Kontonamen beginnen mit einem Großbuchstaben und enthalten keine Leerzeichen, daher wird aus „Office Supplies“ Expenses:Office-Supplies. QuickBooks-Unterkonten werden zu tieferen Segmenten, etwa Expenses:Vehicle:Fuel.

Gewinnrücklagen und Eröffnungssaldo-Eigenkapital fallen in einem einzigen Konto Equity:Opening-Balances zusammen. Beancount berechnet das Ergebnis des laufenden Jahres aus Ihren Ertrags- und Aufwandskonten, daher muss kein separates Gewinnrücklagen-Konto vorgetragen werden.

4. Das Journal zum Umstellungsdatum eröffnen​

Dieses Beispielunternehmen hat eine Probebilanz mit vier Zeilen zum 2025-12-31. Ertrags- und Aufwandszeilen sind bereits in die Gewinnrücklagen eingerechnet. QuickBooks Online macht das selbst, wenn ein neues Geschäftsjahr beginnt, wie in View retained earnings account details beschrieben.

Speichern Sie dies als main.bean:

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

Jedes pad fordert Beancount auf, den Eintrag einzufügen, der die nächste balance-Zusicherung wahr macht. Die Gegenseite jedes Pads geht auf Equity:Opening-Balances. Eine balance-Zusicherung wird zum Beginn ihres Datums geprüft, daher sind die Pads auf den Tag vor dem Umstellungsdatum datiert.

Sollbuchungen werden zu positiven Zahlen, Habenbuchungen zu negativen. Deshalb lautet der Visa-Saldo -1875.40 USD.

Die letzte Zeile ist der Abgleich. Das Eigenkapital muss auf -13774.60 USD kommen, den Haben-Betrag der Gewinnrücklagen. Eine falsch erfasste Aktiv- oder Passivzahl verändert das über die Pads ermittelte Eigenkapital, und diese Zusicherung schlägt fehl.

Fügen Sie für ein echtes Unternehmen für jedes Bilanzkonto der Probebilanz ein open, ein pad und ein balance hinzu. Teilen Sie Forderungen und Verbindlichkeiten in je ein Unterkonto pro Kunde oder Lieferant auf, wenn Sie offene Rechnungen namentlich verfolgen.

5. Historie übernehmen​

Erfassen Sie nach dem Umstellungsdatum neue Vorgänge in Beancount. Bank- und Kreditkartenauszüge sind die wichtigste Quelle. Konvertieren Sie einen Bank-CSV-Export im Browser mit dem CSV to Beancount converter oder nutzen Sie den bank import guide für die Kommandozeile.

Vergangene Jahre sind optional. Es gibt keinen Ein-Klick-Import aus einem QuickBooks-Hauptbuch-Export. Diese Historie zu übertragen ist ein skriptgesteuerter oder manueller Zuordnungsschritt:

1. Speichern Sie den Hauptbuch-Export als CSV.
2. Gruppieren Sie seine Zeilen nach Datum und Buchungsnummer zu Buchungen.
3. Benennen Sie jedes Konto mit Ihrer Zuordnung aus Schritt 3 um.
4. Schreiben Sie jede Gruppe als Beancount-Buchung, deren Posten sich zu null summieren.

Wenn Sie Historie übernehmen, eröffnen Sie die Konten am Beginn dieser Historie statt zum Umstellungsdatum. Behalten Sie dann die balance-Zusicherungen zum 2026-01-01. Sie belegen, dass die konvertierte Historie bei denselben Salden ankommt, die QuickBooks gemeldet hat.

6. Gegen QuickBooks abgleichen​

Prüfen Sie das Journal und listen Sie dann jeden Saldo auf:

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

bea check meldet keine Fehler. Die Abfrage liefert vier Zeilen: Assets:AccountsReceivable mit 3200.00 USD, Assets:Bank:Checking mit 12450.00 USD, Equity:Opening-Balances mit -13774.60 USD und Liabilities:CreditCard:Visa mit -1875.40 USD. Vergleichen Sie jede Zeile Zeile für Zeile mit der QuickBooks-Probebilanz, wobei Habenbeträge negativ sind.

Neu auf der Kommandozeile? Installieren Sie bea mit dem CLI quick start.

7. Was nicht mitkommt​

Eine Journal-Migration überträgt Buchhaltungssalden und Historie. Sie überträgt nicht die Vorgänge, die QuickBooks darum herum abwickelt:

• Rechnungen und Zahlungslinks. Offene Rechnungen bleiben als Forderungssalden bestehen. Nutzen Sie ab jetzt einen separaten Rechnungsdienst.
• Lohnabrechnung. Lohnläufe, Steuerformulare und Mitarbeiterdaten bleiben bei Ihrem Lohnanbieter.
• Umsatzsteuererklärungen. Beancount erfasst die Verbindlichkeit. Die Erklärung bleibt eine separate Aufgabe.
• Anhänge. Belege und Dokumente kommen in einem eigenen ZIP-Export, nicht in den Berichten.
• Bank-Feed-Regeln und Abstimmungshistorie. Bauen Sie die Kategorisierung als Importregeln neu auf.

Die Vergleichsseite sagt es deutlich: Wählen Sie Beancount nicht in der Annahme, dass ein paar Plugins die gesamte QuickBooks-Betriebssuite nachbilden. Wählen Sie es, wenn das Journal selbst Ihr langlebiges führendes System ist.

Führen Sie ein Kleinunternehmen mit Beancount? Siehe Beancount.io for small business für gehostete Journale, Bank Sync und Zusammenarbeit mit dem Steuerberater.