Periodenertrag

Der Periodenertrag-Report bietet eine detaillierte Analyse der Performance eines Portfolios oder Mandanten über einen definierten Zeitraum. Der Report ermöglicht es, die Wertentwicklung tages-, wochen- oder monatsweise zu verfolgen und die verschiedenen Einflussfaktoren auf die Gesamtperformance zu identifizieren.

Aufruf des Reports

Der Periodenertrag-Report kann auf zwei Ebenen aufgerufen werden:

1. Auf Mandantenebene: Über das Hauptmenü → Depots und Konten → Portfolios → Periodenertrag

   • Analysiert die Performance aller Portfolios des Mandanten zusammen
   • Werte werden in der Mandantenwährung dargestellt

2. Auf Portfolioebene: Innerhalb eines einzelnen Portfolios → Periodenertrag

   • Analysiert nur das ausgewählte Portfolio
   • Werte werden in der Portfoliowährung dargestellt

Eingabeparameter

Vor der Berechnung des Reports müssen folgende Parameter festgelegt werden:

Datum von

Das Startdatum der Analyseperiode (inklusiv). Wichtig: Das Datum bezieht sich auf den Börsenschluss, d.h. der Ertrag des Starttages ist nicht in der Berechnung enthalten. Der Starttag dient somit als Vergleichsbasis, von der aus die Veränderung bis zum Enddatum gemessen wird.

Das Datum muss ein gültiger Handelstag sein, also weder ein Wochenende noch ein Feiertag oder ein Tag mit fehlenden Kursen. Zudem darf es nicht vor dem ältesten möglichen Datum liegen, das über dem Eingabeformular hinter dem Hinweis “Ältestes mögliche Datum:” angezeigt wird.

Dieses älteste mögliche Datum ist der letzte Handelstag vor dem ersten Wertpapierkauf. Diese Wahl ist bewusst so getroffen: An jenem Tag ist noch nichts investiert, weshalb eine Auswertung ab diesem Datum bei Gewinn, Wertpapieren, Saldo Kauf/Verkauf Wertpapiere, Dividenden, Gebühren und Kontozins bei null beginnt. Würde stattdessen der Tag des ersten Kaufs als Startdatum dienen, wäre dieser Kauf bereits in den Anfangswerten enthalten und sein Ergebnis ginge der Auswertung verloren, da der Ertrag des Starttages nicht mitgerechnet wird.

Das älteste mögliche Datum ist immer ein echter Handelstag. Fällt der Kalendertag vor dem ersten Wertpapierkauf auf ein Wochenende oder einen Feiertag, wird der davorliegende Handelstag angeboten, also beispielsweise der Freitag vor einem Kauf am Montag.

Datum bis

Das Enddatum der Analyseperiode (inklusiv). Das Datum bezieht sich auf den Börsenschluss.

Einschränkungen:

• Muss ein gültiger Handelstag sein
• Muss nach dem Startdatum liegen
• Darf nicht nach dem letzten verfügbaren Handelstag liegen

Periodenaufteilung

Bestimmt, wie die Daten im Report aggregiert werden:

• Woche: Zeigt die Performance nach Wochentagen (Montag-Freitag) an

  • Nur verfügbar, wenn der Zeitraum maximal die konfigurierte Anzahl von Wochen umfasst
  • Ideal für detaillierte kurzfristige Analysen

• Jahr/Monat: Zeigt die Performance nach Monaten an

  • Nur verfügbar, wenn der Zeitraum mindestens die konfigurierte Anzahl von Monaten umfasst
  • Ideal für längerfristige Übersichten

Die Verfügbarkeit der Optionen wird dynamisch basierend auf dem gewählten Zeitraum angepasst.

Berichtsinhalt

Der Periodenertrag-Report besteht aus mehreren Hauptbereichen:

1. Zusammenfassung (Periodenvergleich)

Dieser Bereich zeigt drei Spalten:

• Erster Tag: Alle Werte zum Startdatum der Periode
• Letzter Tag: Alle Werte zum Enddatum der Periode
• Differenz: Die Veränderung zwischen Start und Ende

Dargestellte Metriken:

Das Datum der jeweiligen Spalte steht in deren Titelzeile und ist keine eigene Zeile der Tabelle.

Wichtig: Alle Werte werden in der Hauptwährung dargestellt - entweder Mandanten- oder Portfoliowährung, je nach Aufrufkontext. Die Hauptwährung wird in der Bezeichnung der jeweiligen Zeile mit ausgegeben.

2. Detaillierte Periodenfenster (Tabellenansicht)

Dieser Bereich zeigt die täglichen Veränderungen strukturiert nach Perioden (Wochen oder Monate):

Bei wöchentlicher Aufteilung steht jede Zeile für eine Woche, die Spalten zeigen die Tage Montag bis Freitag. Bei monatlicher Aufteilung steht jede Zeile für ein Jahr und die Spalten zeigen die zwölf Monate. In beiden Fällen folgt am Ende die Spalte Total mit der Summe der Periode, und die Fusszeile Gesamtsumme fasst jede Spalte über alle Perioden zusammen.

Jede Periode lässt sich aufklappen und zeigt dann bis zu vier Zeilen, deren Bezeichnung in der ersten Spalte steht:

Ein Tooltip auf einer Zelle zeigt zusätzlich deren vollständigen Wert an.

Farbcodierung in der Tabelle:

• 🟩 Grün: Regulärer Handelstag mit Daten
• 🟨 Gelb: Feiertag (keine Handelsaktivität)
• 🟥 Rot: Handelstag mit fehlenden historischen Kursdaten
• ⬜ Grau: Wochenende oder nicht relevanter Tag

3. Spaltensummen

Am Ende jeder Spalte (Wochentag oder Monat) wird die Summe der Gewinne für alle entsprechenden Tage/Monate angezeigt. Dies ermöglicht es, Muster zu erkennen (z.B. “Ist Montag ein schlechter Tag für mein Portfolio?”).

4. Grafische Darstellung

Der Report bietet die Möglichkeit, die Performance als Chart anzuzeigen:

Aufruf: Button “Grafik anzeigen” im Menü

Dargestellte Linien:

• Externe Übertragung Diff: Kumulierte Ein-/Auszahlungen
• Gewinn Diff: Kumulierte Gewinne/Verluste
• Kassabestand Diff: Veränderung des Kassenbestands
• Wertpapiere Diff: Veränderung des Wertpapierwerts
• Gesamtbilanz: Gesamtvermögensentwicklung

Der Chart verwendet Plotly und bietet interaktive Funktionen wie Zoom, Hover-Details und Range-Selektor.

Fehlende Tagesendkurse

Ein wichtiger Aspekt des Periodenertrag-Reports ist die Behandlung fehlender Kursdaten. Fehlende Kursdaten entstehen, wenn an einem Handelstag keine historischen Kurse für gehaltene Wertpapiere verfügbar sind. Dies kann verschiedene Ursachen haben: Der Kursanbieter hat keine Daten geliefert, es sind technische Probleme beim Datenabruf aufgetreten, oder das Wertpapier wurde an diesem Tag tatsächlich nicht gehandelt.

Die Auswirkungen auf den Report sind erheblich. Fehlende Tage werden im Periodenkalender rot markiert, und die Performance kann an diesen Tagen nicht berechnet werden. Das System zählt die aufeinanderfolgenden fehlenden Tage und zeigt diese im Feld “Fehlende Tage” an. Bei der Datumsauswahl werden Tage mit fehlenden Kursen automatisch als ungültige Handelstage markiert, sodass diese nicht als Start- oder Enddatum gewählt werden können.

Übersicht und Interaktion mit fehlenden Kursen

Der Report bietet eine separate Ansicht zur Analyse und Behebung fehlender Kursdaten. Diese kann über das Menü unter “Fehlende Tagesendkurse” aufgerufen werden und zeigt zwei miteinander verbundene Bereiche: Einen Jahreskalender im oberen Bereich und eine Wertpapier-Tabelle im unteren Bereich.

Der Jahreskalender zeigt alle Handelstage des ausgewählten Jahres in einer übersichtlichen Darstellung. Die Farbcodierung macht sofort ersichtlich, wo Probleme vorliegen: Grün markierte Tage signalisieren, dass alle Kurse verfügbar sind. Rot markierte Tage zeigen an, dass mindestens ein Wertpapier fehlende Kurse aufweist. Gelb markierte Tage sind Tage mit fehlenden Kursen, die vom Benutzer selektiert wurden. Wenn Sie auf einen rot markierten Tag klicken, reagiert die Wertpapier-Tabelle sofort und zeigt nur noch die Wertpapiere an, die an diesem spezifischen Tag fehlende Kurse aufweisen.

Die Wertpapier-Tabelle listet alle Wertpapiere auf, die im gewählten Zeitraum fehlende Kurse haben. Neben dem Namen des Wertpapiers wird auch die Anzahl der fehlenden Tage angezeigt. Auch hier funktioniert die Interaktion bidirektional: Wenn Sie in der Tabelle auf ein Wertpapier klicken, werden im Kalender automatisch alle Tage gelb markiert, an denen dieses spezifische Wertpapier fehlende Kurse hat. Diese bidirektionale Interaktion ermöglicht es, systematische Datenlücken schnell zu identifizieren und gezielt zu beheben.

Lösung des Problems fehlender Kursdaten

Für die Behebung fehlender historischer Kursdaten stehen mehrere Möglichkeiten zur Verfügung. Die einfachste Methode ist das manuelle Nachladen der Kursdaten. Über die Wertpapier-Verwaltung können historische Kurse erneut vom Datenanbieter abgerufen werden. Wählen Sie das betroffene Wertpapier aus und triggern Sie eine Aktualisierung der historischen Daten.

Eine besonders elegante Lösung für einzelne fehlende Tage zwischen vorhandenen Kursen ist das lineare Befüllen fehlender Kursdaten. Das System kann Kurslücken durch lineare Interpolation füllen, wobei der fehlende Kurs aus den benachbarten vorhandenen Kursen berechnet wird. Diese Methode eignet sich besonders für einzelne fehlende Tage in ansonsten vollständigen Kursreihen, beispielsweise wenn der Datenanbieter an einem einzelnen Tag einen Ausfall hatte.

Wenn ein Datenanbieter systematisch Lücken aufweist, kann es sinnvoll sein, zu einem alternativen Datenanbieter zu wechseln. GT unterstützt verschiedene Datenanbieter, und oft bietet ein anderer Anbieter eine bessere Abdeckung für bestimmte Märkte oder Wertpapiere. Die Umstellung des Datenanbieters erfolgt in den Einstellungen des jeweiligen Wertpapiers.

Für wenige fehlende Tage, insbesondere bei exotischen Wertpapieren mit schlechter Datenabdeckung, besteht auch die Möglichkeit der manuellen Kurseingabe. Diese Option ist zwar zeitaufwändig, kann aber in Einzelfällen die einzige Möglichkeit sein, eine vollständige Kurshistorie zu erreichen.

Technische Details

Handelstage und Feiertage

Das System berücksichtigt automatisch:

• Globale Feiertage: Weltweit gültige Nicht-Handelstage
• Börsenspezifische Feiertage: Feiertage der Börsen, an denen die gehaltenen Wertpapiere gehandelt werden
• Wochenenden: Samstag und Sonntag sind immer ausgeschlossen

Währungskonvertierung

• Alle Wertpapiere und Konten werden automatisch in die Hauptwährung konvertiert
• Die Konvertierung verwendet historische Wechselkurse zum jeweiligen Datum
• Bei Mandantenauswertung: Konvertierung in Mandantenwährung
• Bei Portfolioauswertung: Konvertierung in Portfoliowährung

Performance-Optimierung

• Das System verwendet einen Cache mit 2-minütiger Gültigkeit für Handelstag-Metadaten
• Datenabfragen werden parallel ausgeführt (CompletableFuture)
• Ergebnisse werden für wiederholte Anfragen innerhalb der Cache-Periode wiederverwendet

Typische Anwendungsfälle

1. Performance-Analyse: Wie hat sich mein Portfolio über das letzte Quartal entwickelt?
2. Einflussanalyse: Welche Faktoren (Gewinne, Einzahlungen, Kursentwicklung) haben die Performance beeinflusst?
3. Muster-Erkennung: Gibt es bestimmte Wochentage oder Monate mit besonders guter/schlechter Performance?
4. Datenqualität: Gibt es systematische Lücken in meinen historischen Kursdaten?
5. Vergleich: Wie unterscheidet sich die Performance verschiedener Portfolios?

Einschränkungen und Hinweise

• Der Report erfordert mindestens einen Wertpapierbestand. Wurden bisher nur Konten geführt und nie ein Wertpapier gehalten, bleibt das Eingabeformular gesperrt.
• Für eine aussagekräftige Analyse sollte der Zeitraum mindestens einige Handelstage umfassen
• Fehlende Kursdaten können die Genauigkeit der Berechnungen beeinträchtigen
• Die Auswahl der Periodenaufteilung wird automatisch basierend auf dem Zeitraum eingeschränkt
• Bei sehr grossen Zeiträumen (mehrere Jahre) kann die Berechnung einige Sekunden dauern