Hilfe & Orientierung

01Erste Schritte

ETFCockpit verbindet dein Transaktionsbuch mit Kursdaten und daraus abgeleiteten Auswertungen. Die Grundlage sind deine erfassten Käufe und Verkäufe: Daraus entstehen Bestände, Einstandswerte, Renditen und die Berechnungen für mögliche Entnahmen.

1. Depot auswählen oder anlegen

In der Kopfzeile wählst du das Depot, mit dem du arbeiten möchtest. Über „+ Neues Depot …“ legst du ein weiteres an. Verwende eindeutige Namen, wenn du mehrere Depots führst. Die gemeinsame Ansicht „Alle Depots“ erscheint bei mehreren eigenen Depots und dient der depotübergreifenden Übersicht.

Wenn du die Anwendung zuerst kennenlernen möchtest, wähle das Demo-Depot. Es enthält Beispieldaten und fließt nicht in die gemeinsame Ansicht deiner eigenen Depots ein.

2. ETFCockpit als App installieren (Chrome)

ETFCockpit läuft im Browser, lässt sich aber wie eine installierte App starten: eigenes Fenster ohne Adressleiste, Symbol im Startmenü oder auf dem Startbildschirm und ein Start auch ohne Netzverbindung – Kurse werden weiterhin online geladen.

1. Windows, macOS, Linux: https://planschkuh-bot.github.io/etfcockpit/ in Chrome öffnen. Rechts in der Adressleiste erscheint das Installationssymbol (Bildschirm mit Pfeil); alternativ Menü ⋮ → „App installieren“ oder „Verknüpfung erstellen …“ → „In neuem Fenster öffnen“. Danach liegt ETFCockpit im Startmenü, im Programme-Ordner oder im Dock.
2. Android: In Chrome öffnen, Menü ⋮ → „App installieren“ (bei älteren Versionen „Zum Startbildschirm hinzufügen“).
3. iPhone und iPad: In Safari öffnen, Teilen-Symbol antippen → „Zum Home-Bildschirm“.
4. Updates: Die installierte App lädt neue Versionen beim Start selbst. Fehlt eine Änderung, die Seite einmal neu laden.

Ein installiertes ETFCockpit nutzt den Speicher des jeweiligen Browsers und Geräts. Für einen Gerätewechsel oder als Absicherung brauchst du zusätzlich eine Depotbuch-Datei (Schritt 7).

3. Transaktionen übernehmen

Öffne „Import / Export“ und lade im Feld „Datei auswählen“ deine Transaktionen (CSV, TXT oder Excel). Für eine nachvollziehbare historische Auswertung benötigst du die tatsächlichen Transaktionen, nicht nur den heutigen Gesamtbestand.

4. Daten und Einstellungen prüfen

Vergleiche die erfassten Stückzahlen mit deinem Broker. Prüfe danach unter „Kurse & Einstellungen“ die ETF-Zuordnung, Kursdaten und Berechnungsparameter. Lade die Kurse über den Aktualisieren-Button in der Kopfzeile neu und beachte eventuelle Fehlermeldungen.

5. Das Ergebnis kontrollieren

Öffne das Cockpit. Stimmen die Positionen und Größenordnungen? Sind Kurse und historische Verläufe vorhanden? Erst wenn diese Grundlagen passen, sind auch die weiteren Auswertungen sinnvoll interpretierbar. Die i-Symbole erklären Details direkt an der jeweiligen Kennzahl.

6. Vorabpauschalen und Entnahmen ansehen

Unter „Vorabpauschale“ findest du die jahresbezogenen Berechnungen. Der Entnahmeplaner zeigt mögliche Verkäufe und die geschätzten Auswirkungen auf Steuern und Nettoerlös. Du kannst dort verschiedene Aufteilungen vergleichen, ohne sofort eine Buchung vorzunehmen.

7. Eine Sicherung erstellen

Speichere über „Import / Export“ eine Depotbuch-Datei. Wiederhole das nach größeren Änderungen. Der lokal gespeicherte Browserstand und eine separat abgelegte Sicherungsdatei erfüllen unterschiedliche Aufgaben: Erst die Datei ermöglicht die bewusste Wiederherstellung oder Übertragung eines gesicherten Standes.

02Import / Export

In diesem Bereich verwaltest du die Transaktionen und sicherst den Datenstand. Prüfe vor jeder Änderung die Depotauswahl in der Kopfzeile, damit die Buchungen dem richtigen Depot zugeordnet werden.

Dateiimport Schritt für Schritt

1. Exportiere deine Transaktionen aus der bisherigen Anwendung oder von deiner Bank als CSV- oder Excel-Datei.
2. Klicke in der Karte „Daten importieren“ auf „Datei auswählen“ oder ziehe die Datei in das Feld. CSVs, Textdateien und .xlsx werden direkt gelesen.
3. Prüfe die vorgeschlagene Spaltenzuordnung. Unterschiedliche Überschriften und Reihenfolgen sind möglich; zusätzliche Spalten können ignoriert werden.
4. Ordne Kennung, Datum und Transaktionsart zu. Als Kennung kommen WKN, ISIN oder Ticker infrage. Außerdem benötigt die App zwei der drei Angaben Stückzahl, Preis je Anteil und Gesamtbetrag.
5. Kontrolliere die Vorschau, insbesondere die erkannten Datumswerte, Zahlen und die Unterscheidung zwischen Kauf und Verkauf.
6. Übernimm den Import und vergleiche danach die Bestände mit deiner Vorlage.

Welche Angaben bedeuten was?

Kennung

Identifiziert das Wertpapier. Achte darauf, dass Käufe und Verkäufe desselben ETFs konsistent zugeordnet werden.

Datum

Das Transaktionsdatum bestimmt die zeitliche Einordnung der Buchung und die Reihenfolge der Kaufpositionen.

Art

Unterscheidet einen Kauf von einem Verkauf. Eine falsche Zuordnung verändert den Bestand in die falsche Richtung.

Stückzahl

Die gekaufte oder verkaufte Anzahl von Anteilen, einschließlich möglicher Bruchstücke.

Preis je Anteil

Der Kurs eines einzelnen Anteils, nicht der Gesamtwert der Transaktion.

Gesamtbetrag

Der Betrag für die gesamte Transaktion. Bei passender Zuordnung kann die App daraus zusammen mit Stückzahl oder Anteilspreis die fehlende Größe ableiten.

Einzelne Transaktionen manuell ergänzen

Wähle Kauf oder Verkauf, trage Datum und Symbol / ISIN ein und ergänze Stückzahl und Kurs je Stück. Für einen neuen ETF ist auch ein Name erforderlich. „Transaktion hinzufügen“ schreibt die Buchung in das ausgewählte Depot. Prüfe vorher, ob sie bereits in deinen importierten Daten enthalten ist.

CSV und Depotbuch-Sicherung sind nicht dasselbe

Eine Transaktions-CSV dient zur Übernahme von Buchungen. Die Depotbuch-Datei sichert dagegen den App-Datenstand einschließlich Transaktionen, Ticker, Einstellungen und Kursen. Verwende die vollständige Sicherung, wenn du deinen bisherigen Arbeitsstand wiederherstellen oder auf ein anderes Gerät übertragen möchtest.

Speichern und Laden

Über „Speichern ▾“ stehen abhängig vom Browser ein frei wählbarer Speicherort, Teilen / Sichern in einer anderen App oder der normale Download zur Verfügung. Über „Laden“ wählst du eine zuvor gespeicherte Depotbuch-Datei aus. Lies die Rückfrage genau: Das Wiederherstellen ersetzt nach Bestätigung die bisherigen App-Daten auf diesem Gerät.

Typische Fehler vermeiden

• Vor einem größeren Import oder einer Wiederherstellung den bisherigen Stand sichern.
• Bei unplausiblen Beträgen zuerst Spaltenzuordnung, Dezimaldarstellung und Preis je Stück prüfen.
• Bei unpassenden Beständen Kauf-/Verkaufsart, Kennung und Vollständigkeit der Transaktionen kontrollieren.
• In „Alle Depots“ keine Buchungen erfassen; dafür ein einzelnes Depot auswählen.

03Kurse & Einstellungen

Dieser Bereich enthält die Zuordnung der Wertpapiere und wichtige Eingaben für die Auswertungen. Vollständige Buchungen allein reichen für eine Bewertung nicht aus: Die App benötigt auch passende Kurse und stimmige ETF-Einstellungen.

Wertpapierkennung und Kurszuordnung

Prüfe, ob der erkannte ETF tatsächlich deinem Wertpapier entspricht. Die Kennung aus deinen Transaktionen und das für die Kursabfrage verwendete Symbol müssen zusammenpassen. Achte insbesondere auf unterschiedliche Anteilsklassen, etwa ausschüttende und thesaurierende Varianten.

Kurse aktualisieren

1. Prüfe die Zuordnung der ETFs.
2. Klicke oben rechts in der Kopfzeile auf das Kurs-Symbol („Kurse neu laden“).
3. Kontrolliere anschließend den angezeigten Kursstand und die Statushinweise je ETF. Auf schmalen Displays steht der Status rechts in der Zeile.
4. Untersuche Positionen mit Fehler- oder Prüfhinweis gesondert, bevor du deren Auswertungen verwendest.

Aktuelle Kurse bestimmen die heutige Bewertung. Historische Kurse werden für die Entwicklung über die Zeit benötigt. Ein vorhandener aktueller Kurs bedeutet deshalb nicht automatisch, dass auch alle historischen Diagramme vollständig berechnet werden können.

ETF-Einstellungen verstehen

TER

Die jährliche Gesamtkostenquote des Fonds. Die App nutzt den hinterlegten Prozentsatz für die Kostenübersicht und den wertgewichteten Durchschnitt. Eine fehlende TER kann die ausgewiesene Übersicht unvollständig machen.

Ausschüttungsart

Unterscheidet ausschüttende und thesaurierende ETFs. Prüfe die Zuordnung zur tatsächlich gehaltenen Anteilsklasse. Die automatische Erkennung lässt sich je ETF anpassen.

Teilfreistellung

Der hinterlegte Prozentsatz reduziert in den App-Berechnungen den steuerpflichtigen Anteil der betreffenden Erträge. Ein falscher Wert verändert die Steuer-Schätzungen, nicht den Marktwert deiner Anteile.

Kirchensteuer

Die ausgewählte Einstellung wird in die Steuerberechnung einbezogen. Prüfe sie vor dem Vergleich von Brutto- und Nettoerlösen.

Basiszins

Eine jahresbezogene Eingabe für die Berechnung der Vorabpauschale. Die Oberfläche zeigt dazu den abgeleiteten Basisertrag. Prüfe immer das richtige Jahr und verändere die Werte nicht bloß, um eine gewünschte Steuerzahl zu erhalten.

Warum Einstellungen mehrere Ansichten beeinflussen

Kursdaten wirken auf Marktwerte, Diagramme und die Zahl der rechnerisch zu verkaufenden Anteile. Steuerliche Einstellungen wirken auf Vorabpauschalen und Entnahmesteuern. Die TER fließt in die Kostenübersicht ein. Prüfe daher die Grundlagen zuerst, bevor du Unterschiede zwischen mehreren Ansichten als Fehler interpretierst.

04Cockpit

Das Cockpit fasst dein Depot in Kennzahlen, Diagrammen und einer Positionstabelle zusammen. Beachte dabei immer drei Fragen: Welches Depot ist gewählt, welcher Zeitraum ist eingestellt und sind alle ETFs oder nur ausgewählte Positionen einbezogen?

Bestand und Bewertung

Marktwert / Wert

Die gehaltene Stückzahl, bewertet mit dem verfügbaren aktuellen Kurs. Fehlt ein Kurs, ist die betreffende Bewertung nicht vollständig.

Einstand

Die den noch gehaltenen Anteilen zugeordneten Anschaffungskosten. Nach Verkäufen ist das nicht einfach die Summe sämtlicher früheren Käufe.

Unrealisierter Gewinn

Der Unterschied zwischen aktuellem Wert und Einstand der gehaltenen Positionen. Er ist von bereits durch Verkäufe realisierten Ergebnissen zu unterscheiden.

Gewicht

Der Anteil einer Position am bewerteten Depot. Eine große Gewichtung zeigt eine stärkere Konzentration auf diesen ETF.

Monatsübersicht und Jahresrendite

Die Karte „Depotentwicklung je Monat“ zeigt je Monat Käufe, Verkäufe, kumulierte Einzahlungen, Depotwert und Rendite. Ein Klick auf einen Monat öffnet die zugehörigen Transaktionen mit aktuellem Wert, Gewinn und Rendite. Bei der Jahresrendite wechselst du zwischen Balken und einer Heatmap, die zusätzlich die Rendite je Monat farbig zeigt.

ETFs und Zeitraum auswählen

Über die ETF-Auswahl in der Wertaufteilung oder den entsprechenden Zeilen grenzt du die Cockpit-Auswertung auf Positionen ein. Beachte die Hervorhebung ausgewählter beziehungsweise abgedimmter ETFs. Der eingestellte Zeitraum bestimmt den Ausschnitt der zeitbezogenen Auswertungen; eine Bestandskennzahl und eine Zeitraumkennzahl beschreiben daher nicht immer dieselbe Perspektive.

Depotentwicklung und Einzahlungen

Die Depotentwicklung nutzt historische Tagesschlusskurse und die jeweils gehaltenen Stückzahlen. Die Vergleichslinie der kumulierten Netto-Einzahlungen zeigt Käufe abzüglich Verkäufe. Eine zusätzliche Einzahlung kann den Depotwert erhöhen, ohne dass dies eine positive Wertentwicklung der vorhandenen Anlagen bedeutet.

Renditeansichten unterscheiden

• TWROR zeigt die zeitgewichtete Rendite und trennt die Entwicklung von den Auswirkungen der Ein- und Auszahlungen. In dieser Ansicht lässt sich der Verlauf mit einem einzelnen ETF vergleichen; die Vergleichsreihen berücksichtigen Ausschüttungen.
• Die Jahresrendite verwendet in dieser App Modified Dietz: Der Wertzuwachs einschließlich Ausschüttungen wird auf das zeitlich gewichtete eingesetzte Kapital bezogen.
• Die Rendite p. a. je ETF verwendet XIRR und berücksichtigt die zeitliche Lage der Zahlungsströme. „p. a.“ bezeichnet eine annualisierte Rate, nicht einfach den gesamten Gewinn geteilt durch die Zahl der Jahre.

Diese Kennzahlen beantworten unterschiedliche Fragen und müssen deshalb nicht denselben Prozentwert ergeben.

Erträge, Kosten und Steuern

• Ausschüttungen zeigen die aus den erfassten Daten abgeleiteten Erträge für den jeweiligen Bezug, etwa den ausgewählten Zeitraum oder die letzten zwölf Monate.
• Die durchschnittliche TER ist wertgewichtet. Fehlende ETF-Angaben können die Kostenübersicht unvollständig machen.
• Die in Euro dargestellte jährliche TER-Kostengröße wird aus Depotwert und hinterlegter TER abgeleitet; sie ist keine zusätzliche Buchung im Transaktionsformular.
• Vorabpauschalen werden getrennt vor und nach Teilfreistellung dargestellt. Die laufende Prognose ist als solche zu lesen.
• „Latente Steuer“ ist die geschätzte Steuer bei einem vollständigen Verkauf zum heutigen Kurs unter den App-Annahmen.

Diagramme sinnvoll lesen

Die Wertaufteilung zeigt die Zusammensetzung, die Depotentwicklung den zeitlichen Verlauf und die Netto-Einzahlungen je Jahr deine Käufe abzüglich Verkäufe. Die ETF-Renditeübersicht ergänzt diese Betrachtung um Positionsergebnisse. Nutze die i-Symbole für die genaue Definition, insbesondere wenn Werte unterschiedliche Zeiträume oder Berechnungsarten betreffen.

05Vorabpauschale

Dieser Bereich macht die in der App berechneten Vorabpauschalen nach Jahr und ETF nachvollziehbar. Er verbindet jahresbezogene Kurs- und Ausschüttungsdaten mit den Beständen und den hinterlegten Berechnungseinstellungen.

Was du hier voneinander unterscheiden solltest

Vorabpauschale

Der von der App ermittelte Betrag vor Anwendung der Teilfreistellung. Dieser Betrag ist nicht mit der darauf berechneten Steuer gleichzusetzen.

Nach Teilfreistellung

Der nach dem hinterlegten Freistellungsprozentsatz verbleibende Betrag, den die App für die weitere Steuer-Schätzung verwendet.

Steuer darauf

Die daraus mit den App-Einstellungen abgeleitete Steuergröße. Sie ist eine Schätzung, keine tatsächliche Brokerabbuchung.

Prognose

Eine vorläufige Berechnung für das laufende Jahr, bei der der heutige Bestand und der letzte verfügbare Kurs als Grundlage dienen.

So gehst du vor

1. Kontrolliere das ausgewählte Depot sowie die ETF- und Steuereinstellungen.
2. Wähle im Jahresfilter die gewünschten Jahre und bestätige die Auswahl mit „Übernehmen“.
3. Grenze die Tabelle bei Bedarf über den ETF-Filter auf ein Wertpapier ein.
4. Prüfe die zugrunde liegenden Jahreskurse und Ausschüttungen. Fehlende Kurse sind ein Datenhinweis und kein belastbares Nullergebnis.
5. Vergleiche die Summen und den Verlauf der ausgewählten Jahre. Beachte die Kennzeichnung der laufenden Prognose.

Welche Daten die Berechnung beeinflussen

Wichtig sind insbesondere die relevanten Jahreskurse, die Ausschüttungen, der Basiszins des jeweiligen Jahres und die hinterlegte Teilfreistellung. Die App berücksichtigt auch die zeitliche Einordnung der Käufe. Wenn eine Zahl nicht plausibel ist, prüfe deshalb sowohl die Jahresdaten als auch die Transaktionen.

Warum die Prognose schwankt

Der letzte Kurs und die heute gehaltenen Stückzahlen können sich ändern. Deshalb kann auch die Prognose steigen oder fallen. Die Oberfläche erläutert, dass der letzte Rücknahmepreis des Jahres für den endgültigen Jahresbezug maßgeblich ist. Eine aktuelle Zwischenrechnung darf daher nicht wie eine fertige Abrechnung gelesen werden.

Verbindung zum Entnahmeplaner

Für die rechnerisch verkauften Kaufpositionen berücksichtigt der Entnahmeplaner die in der App zugeordneten bisherigen Vorabpauschalen. Fehlerhafte Jahresdaten können deshalb nicht nur diese Ansicht, sondern auch die geschätzten Veräußerungsgewinne beeinflussen.

06Entnahmeplaner

Der Entnahmeplaner simuliert den Verkauf vorhandener ETF-Anteile. Du legst einen Brutto-Verkaufsbetrag und dessen Verteilung fest. Die App berechnet daraus Stückzahlen, zugeordnete Anschaffungskosten, geschätzte Steuern und den verbleibenden Nettoerlös.

1. Brutto-Verkaufsbetrag festlegen

Gib den Betrag im Feld „Brutto“ ein oder den gewünschten Anteil im Feld „Anteil“. Die Plus-/Minus-Buttons ändern den Betrag in Schritten von 500 € und den Anteil in Schritten von 0,1 %. Beide Felder beschreiben denselben Verkaufsbetrag und werden wechselseitig aktualisiert. Wichtig: Brutto ist der Verkaufserlös vor der berechneten Steuer, nicht die gewünschte Auszahlung nach Steuern.

2. Aufteilung wählen

Nach Portfolio

Verteilt den Verkaufsbetrag proportional zu den Depotwerten der einbezogenen Positionen.

Steuerminimal

Sucht innerhalb der App-Berechnung eine Aufteilung mit möglichst kleinem steuerpflichtigem Gewinn. Die Berechnung arbeitet mit einer schrittweisen Aufteilung und ist keine umfassende persönliche Steuerplanung.

Steuermaximal

Sucht entsprechend eine Aufteilung mit möglichst großem steuerpflichtigem Gewinn. Das ist eine Vergleichsoption, keine Empfehlung zum Verkauf.

Eigene Aufteilung

Über Prozentfelder und Plus-/Minus-Buttons passt du die Anteile an. Mit den Kontrollkästchen kannst du ETFs aus der Planung ausschließen. Prüfe die Summe und die Bestandsgrenzen.

3. Ergebnistabelle verstehen

4. FIFO und Lots nachvollziehen

Ein „Lot“ ist eine einzelne Kaufposition mit Datum, Stückzahl und Anschaffungskurs. FIFO bedeutet, dass die ältesten gekauften Anteile zuerst für den simulierten Verkauf herangezogen werden. Die aufklappbaren Details der verbrauchten Lots zeigen, welche Käufe einbezogen sind.

5. Brutto und Netto vergleichen

Ein Bruttoverkauf von beispielsweise 10.000 € führt bei einer hypothetisch berechneten Steuer von 500 € zu 9.500 € Nettoerlös. Wenn du einen bestimmten Nettobetrag erreichen möchtest, passe den Bruttobetrag an und kontrolliere das neue Ergebnis. Die Beispielsteuer ist keine pauschale Vorgabe für deinen Verkauf.

6. Warnungen und Grenzen beachten

• „Kurs fehlt“: Ohne Kurs ist für diesen ETF keine verlässliche Verkaufsbewertung möglich.
• „Bestand reicht nicht“: Der zugeordnete Betrag übersteigt den bewerteten verfügbaren Bestand. Betrag oder Aufteilung anpassen.
• Eine Anteilssumme ungleich 100 % wird gesondert angezeigt. Kontrolliere die gewünschte Verteilung.
• Verluste einer Position können in der Planerrechnung die Gesamtsteuer anderer Positionen mindern; ein negativer Steueranteil ist dabei keine eigenständige Auszahlung.
• Eine vollständige Verlustverrechnung mit anderen Steuertöpfen oder Vorjahren bildet die App nicht ab.

7. Simulation von Buchung unterscheiden

Das Ändern von Betrag und Aufteilung verändert den Bestand noch nicht. Erst „Verkauf buchen“ erfasst nach deiner Bestätigung die berechneten Verkaufstransaktionen im lokalen Depotbuch. Prüfe davor Depot, Datum, Stückzahlen und Kursannahmen. Unter „Gebuchte Verkäufe“ kannst du diese Buchung nach Bestätigung rückgängig machen.

8. Weiterrechnen und simulieren

Über „Im Steuerrechner öffnen“ übergibst du Bestand, Verkaufsbetrag, Gewinnanteil und Teilfreistellung an den Steuer- und Abgabenrechner. Der Link „Im Entnahme-Simulator öffnen“ startet die Langfrist-Simulation mit deinem Depotwert, der Aufteilung nach Aktien-, Gold- und Anleihe-ETFs, der gewichteten Kostenquote und dem eingestellten Verkaufsanteil als Startrate. Beide Ziele öffnen sich in einem neuen Fenster; deine Daten werden über die Adresse übergeben.

07FAQ

Hier findest du Antworten auf typische Fragen zur Bedienung, zu Daten und zu den Berechnungen. Klicke auf eine Frage, um die Antwort aufzuklappen.