Difference between revisions of "De/Aktienhandel"

From GnuCash
Jump to: navigation, search
(Symbol: Ergänzung + Hervorhebung)
(gnucash-help is gnucash-manual as of GnuCash 5.0)
 
(110 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Wie man ein Aktien- oder Wertpapier-Depot anlegt und online abfragt ...
+
Wie man ein Aktien- oder Wertpapier-Depot anlegt und zugehörige Kurse online abfragt ...
 +
{| class="wikitable"
 +
|-
 +
| [[De/GnuCash | Zurück zur Hauptseite]]
 +
| [[Online_Quotes | englische Version]]
 +
| [[Zh-hans/在线报价 | 简体中文]]
 +
|}
 +
;Offizielle Dokumentation:
 +
:;Manual:[{{URL:docs}}de/gnucash-manual/finance-quote.html Einrichten der Kursabfrage],
 +
::[{{URL:docs}}de/gnucash-manual/tool-security-edit.html#tool-commodity Wertpapier anlegen oder bearbeiten];
 +
:;Guide:[{{URL:docs}}de/gnucash-guide/invest-stockprice1.html#invest-stockprice-auto2 Automatische Kursabfragen konfigurieren].
  
 +
==Aktuelles==
 +
Leider hat '''Yahoo!''' nach einem Eigentümerwechsel am 1.11.2017 die von vielen genutzte CSV-Schnittstelle abgeschaltet. Dadurch stehen die Quellen ''Währung/currency'', ''yahoo*'' (mit Ausnahme von '''json'''), ''canada'', ''usa'', ''nyse'', ''nasdaq'', ''vanguard'' nicht mehr zur Verfügung. Die Finance::Quote-Entwickler haben hart daran gearbeitet, diese Funktionalität durch die neue Quelle '''Alphavantage''' zu ersetzen.
 +
Die Details, um Alphavantage zu nutzen, sind im [{{URL:docs}}de/gnucash-manual/fq-sources.html Anhang der Hilfe] beschrieben.
 +
;Drosselung: Beim kostenlosen Alphavantage-Schlüssel sind die Abfragen auf derzeit 5/min. gedrosselt. Wer bereits ein paar Währungen abfragt, sollte also für Wertpapiere andere Quellen, etwa <tt>Yahoo über JSON</tt> suchen.
  
[[De/GnuCash | Zurück zur Hauptseite]]
+
;Windows: Benutzer die schon lange dabei sind, müssen eventuell ihre Perl-Version aktualisiern. Dazu entfernt man alle vorhandenen Versionen sowohl in der Systemsteuerung, als auch im Explorer. Anschließend führt man <tt>Erweiterung um Wechselkurse mit GnuCash online abzurufen</tt> erneut aus, wodurch eine aktuelle Version von [http://strawberryperl.com/ Strawberry Perl] installiert wird.
 +
Weiterhin empfiehlt es sich, die Mailing-Liste [{{ListURL}}/pipermail/gnucash-user/ gnucash-user] zu beobachten, da dort neue Versionen von F::Q angekündigt werden.
  
 +
(Sobald sich die Lage stabilisiert hat, kann dieses Kapitel in den Rest der Seite eingearbeitet werden.)
  
 
== Einleitung ==
 
== Einleitung ==
 
 
Mit GnuCash kann man eine Vielzahl verschiedener Wertpapiere und auch Edelmetalle verwalten. Dazu gehören:
 
Mit GnuCash kann man eine Vielzahl verschiedener Wertpapiere und auch Edelmetalle verwalten. Dazu gehören:
 
* '''Edelmetalle''': XAU - Gold, XAG - Silber, ... als Untergruppe der
 
* '''Edelmetalle''': XAU - Gold, XAG - Silber, ... als Untergruppe der
Line 14: Line 29:
 
* '''Fonds''', also Papiere von Gesellschaften, die wieder in die zuvor genannten investieren.
 
* '''Fonds''', also Papiere von Gesellschaften, die wieder in die zuvor genannten investieren.
  
Für Kauf und Verkauf dieser Papiere ist natürlich immer maßgeblich, was man auf dem entsprechenden Beleg stehen hat. Will man sich aber zwischendurch einen Überblick über den aktuellen Wert seiner Investitionen machen, so kann man mithilfe des Moduls '''Finance::Quote''' Onlinekurse aus verschiedenen Quellen abrufen und zur weiteren Verwendung, etwa in Berichten, in der Kursdatenbank abspeichern.
+
Für ''Kauf und Verkauf'' dieser Papiere ist natürlich immer maßgeblich, was man auf dem entsprechenden Beleg stehen hat. Will man sich aber zwischendurch einen Überblick über den ''aktuellen'' Wert seiner Investitionen machen, so kann man mithilfe des Moduls '''Finance::Quote''' Onlinekurse aus verschiedenen Quellen abrufen und zur weiteren Verwendung, etwa in den Portefolio-Berichten, in der Kursdatenbank abspeichern.
 +
 
 +
Verschiedene '''Anbieter''' wie etwa ''Börsen'' und ''Fondgesellschaften,'' aber auch ''Dritte'' wie Yahoo, bieten auf ihren Webseiten kostenlose Kursinformationen an. Diese sind bisweilen etwas zeitverzögert, um kommerziellen Anbietern wie Reuters nicht das Wasser abzugraben, für den Privatgebrauch aber allemal gut.
  
=== Quellen in Finance::Quote ===
+
Diese Anbieter werden im Folgenden als '''Quelle'''n bezeichnet. Daneben ist noch das '''Symbol''' wichtig, unter dem das Wertpapier bei dem ''jeweiligen'' Anbieter gelistet wird..
  
Verschiedene Anbieter wie etwa Börsen und Fondgesellschaften, aber auch Dritte wie Yahoo, bieten auf ihren Webseiten kostenlose Kursinformationen an. Diese sind etwas zeitverzögert, um kommerziellen Anbietern wie Reuters nicht das Wasser abzugraben, für den Privatgebrauch aber allemal gut.
+
=== Voraussetzungen ===
 +
Um diese auszulesen und u.a. für GnuCash zur Verfügung zu stellen, gibt es das eigenständige Projekt [http://sourceforge.net/projects/finance-quote Finance::Quote] ('''F::Q'''). Dorthin sind also auch eventuelle [[De/Referenz#Wie_man_einen_Fehler_meldet_oder_einen_Verbesserungsvorschlag_einreicht | Fehlerberichte]] zu senden, falls etwa eine Seite ihr Format geändert hat. Die Installation wird in der [{{URL:docs}}de/gnucash-manual/finance-quote-install.html GnuCash-Hilfe] beschrieben.
  
Um diese auszulesen und u.a. für GnuCash zur Verfügung zu stellen, gibt es das eigenständige Projekt http://sourceforge.net/projects/finance-quote. Dorthin sind also auch eventuelle [[De/Referenz#Wie_man_einen_Fehler_meldet_oder_einen_Verbesserungsvorschlag_einreicht | Fehlerberichte]] zu senden, falls etwa eine Seite ihr Format geändert hat.
+
Weitere Möglichkeiten (gnc-fq-update und CPAN) sind in [[#Bei Formatänderung der Quelle: gnc-fq-update]] ff. erläutert.
  
 +
=== Quellen in Finance::Quote ===
 
Um zu erfahren, welche dieser Quellen dem Perl-Programm Finance::Quote zur Verfügung stehen, gibt man an der Konsole  
 
Um zu erfahren, welche dieser Quellen dem Perl-Programm Finance::Quote zur Verfügung stehen, gibt man an der Konsole  
gnc-fq-dump
+
<Syntaxhighlight lang="sh">
ein. Falls hier eine Fehlermeldung kommt, bitte das unten erwähnte ''gnc-fq-update'' durchführen.
+
gnc-fq-check
 +
</Syntaxhighlight>
 +
ein. Dabei sieht man auch gleich, welche FQ-Version man verwendet. Falls hier eine Fehlermeldung kommt, kann es auf Unix-artigen Systemen sinnvoll sein, das unten erwähnte [[#Bei Formatänderung der Quelle: gnc-fq-update|gnc-fq-update]] durchführen, um Finance::Quote zu aktualisieren.
  
Eine Übersicht der Kursquellen mit Erläuterungen gibt es auf [[De/Referenz#Liste_der_Kursquellen]].
+
Um die Dokumentation zu einer Quelle anzuzeigen, kann man
 +
<Syntaxhighlight lang="sh">
 +
man Finance::Quote::<Quelle>
 +
</Syntaxhighlight>
 +
oder
 +
<Syntaxhighlight lang="sh">
 +
perldoc Finance::Quote::<Quelle>
 +
</Syntaxhighlight>
 +
an der Konsole eingeben oder im Browser die Datei <code>/usr/share/man/man3/Finance::Quote::<Quelle>.3pm</code> öffnen - zumindest in Linux, Pfade für andere Systeme bitte ergänzen.
  
Wenn einem GnuCash meldet, daß es einen Kurs nicht aktualisieren kann, ist auch manchmal schneller, seine Angaben mit
+
Eine Übersicht der Kursquellen mit Erläuterungen gibt es in der [[De/Referenz#Liste_der_Kursquellen|Referenz]].
gnc-fq-dump [-v] <Quelle> <Kürzel1> [<Kürzel2> ...]
 
zu überprüfen als in GnuCash immer wieder eine Einstellung zu ändern und ''alle'' Kurse abzurufen. Weiterhin sieht man bei dieser Methode besser, wo der Fehler liegt. Da sie auch unvollständige Ergebnisse liefert, sieht man dann beispielsweise, ob Yahoo mal wieder das Format geändert hat oder das Symbol wirklich unbekannt ist.  
 
  
 
Um die ausführliche Dokumentation von Finance::Quote zu lesen, kann man an der Konsole
 
Um die ausführliche Dokumentation von Finance::Quote zu lesen, kann man an der Konsole
perldoc Finance::Quote
+
<Syntaxhighlight lang="sh">
eingeben.
+
man Finance::Quote
 +
</Syntaxhighlight>
 +
eingeben. Diese zielt aber mehr auf Perl-Programmierer als auf Anwender.
  
Schließlich kann man mit
+
==== Bei Formatänderung der Quelle: gnc-fq-update ====
sudo gnc-fq-update
+
Schließlich kann man, zumindest unter ''Linux'', mit
Finance::Quote mit allen erforderlichen Modulen und eventuellen Schnittstellen zu neuen Datenquellen auf den neuesten Stand bringen, ohne sich erst mit dem [http://cpan.org/ Comprehensive Perl Archive Network] (CPAN) auseinandersetzen zu müssen.
+
<Syntaxhighlight lang="sh">
 +
sudo gnc-fq-update
 +
</Syntaxhighlight>
 +
Finance::Quote mit allen erforderlichen Modulen und eventuellen Schnittstellen zu neuen Datenquellen auf den neuesten Stand bringen, ohne sich erst mit dem [http://cpan.org/ Comprehensive Perl Archive Network] (CPAN) auseinandersetzen zu müssen. Falls man das doch nutzt, hat die englische Seite [[CPAN]] noch ein paar Hinweise.
 +
 
 +
;Ubuntu und Derivate: Falls dieser Script auf Ihrem System nicht vorhanden ist, finden Sie es [https://github.com/Gnucash/gnucash/blob/maint/libgnucash/quotes/gnc-fq-update.in hier].  Ein Beispiel, wie es anzupassen wäre, befindet sich [{{ListURL}}/pipermail/gnucash-user/2012-September/045932.html hier].
 +
 
 +
Für die ''Quartz''-Version von ''OSX'' lauten die Befehle:
 +
<Syntaxhighlight lang="sh">
 +
sudo perl -MCPAN -e shell
 +
sudo /Applications/Gnucash.app/Contents/Resources/bin/gnc-fq-update
 +
</Syntaxhighlight>
 +
 
 +
Die Anleitung hierzu für ''Windows'' steht auf der  [[De/Installation#Online-Kursabfrage_Finance::Quote | Installationsseite]].
 +
 
 +
==== oder manuelles Ersetzen mit noch nicht veröffentlichten Modulen ====
 +
Neuere Versionen von Finance::Quote (ab 1.18, September 2012) holen erfolgreich die Währungskurse. Somit erübrigt sich die gepatchte Version [[{{BugURL}}/attachment.cgi?id=207969 Quote.pm]] von Mike Alexander.
 +
 
 +
Um Ihre aktuelle Finance::Quote-Installation zu überprüfen:
 +
<Syntaxhighlight lang="sh">
 +
cpan -D Finance::Quote
 +
</Syntaxhighlight>
 +
Die Ausgabe davon liefert einem
 +
* den Pfad, wo Quote.pm installiert ist
 +
* ob man auch die zuletzt veröffentlichte Version 1.18  hat und damit "up to date" ist.
 +
: Sollte das nicht der Fall sein, sollte man zunächst F::Q wie [[#Bei Formatänderung der Quelle: gnc-fq-update|oben]] beschrieben aktualisieren.
 +
 
 +
Falls erforderlich kann man die installierte Version mit einer noch nicht als stabil freigegebenen Version überschreiben, was allerdings Administratorrechte benötigt.
 +
Der offizielle, saubere Weg ist zwar ein anderer, siehe etwa [{{BugURL}}/show_bug.cgi?id=670383#c0], aber so geht es wohl für die meisten am einfachsten und schnellsten.
 +
 
 +
Weitere Details zur Verwendung von cpan finden sich auf der [[CPAN|englischen Seite]].
 +
 
 +
==== Die Qual der Wahl der Quelle ====
 +
Da das Symbol ein und desselben Papiers bei den verschiedenen Kursquellen recht verschieden sein kann, hier eine Faustregel:
 +
 
 +
* Wenn ich als '''Kleinanleger''' sowieso nur die Produkte der mit ''meinem'' Finanzinstituts X assoziierten Fondgesellschaft Y kaufe, reicht es, wenn ich mich mit der Symbol-Terminologie dieser Gesellschaft vertraut mache.
 +
* Bin ich aber eine '''global agierende Heuschrecke''', ist es wohl besser, sich mit der ''Yahoo''-Terminologie vertraut zu machen und, soweit möglich, alle Papiere über eines der Yahoo-Module oder über ''Alphavantage'' abzurufen.
  
 
=== Felder im Aktieneditor ===
 
=== Felder im Aktieneditor ===
 
+
Für F::Q wichtig sind das ''Symbol'' und die ''Quelle'', wobei eben das Symbol je nach Quelle verschieden sein kann.
Für F::Q wichtig sind das ''Symbol'' und die ''Quelle''.
 
  
 
==== Voller Name ====
 
==== Voller Name ====
 
 
Na, was wohl? Name und Symbol erscheinen später in der Spalte "Währung/Aktie" in der Kontenübersicht. Spätestens wenn man mehrere ähnliche Papiere hat, ist es sinnvoll '''signifikante Daten''' wie etwa ''Herausgeber'', ''Art'', ggf. ''Zinssatz'' und ''Endfälligkeit'' in den Namen einzubauen.
 
Na, was wohl? Name und Symbol erscheinen später in der Spalte "Währung/Aktie" in der Kontenübersicht. Spätestens wenn man mehrere ähnliche Papiere hat, ist es sinnvoll '''signifikante Daten''' wie etwa ''Herausgeber'', ''Art'', ggf. ''Zinssatz'' und ''Endfälligkeit'' in den Namen einzubauen.
  
 
==== Symbol ====
 
==== Symbol ====
 
 
Das Symbol, ist das Kürzel, unter dem das Papier bei dem entsprechenden Dienst aufgeführt ist. '''Vorsicht''', ein und dasselbe Papier kann bei verschiedenen Anbietern also unter ganz verschiedenen Symbolen geführt werden.  
 
Das Symbol, ist das Kürzel, unter dem das Papier bei dem entsprechenden Dienst aufgeführt ist. '''Vorsicht''', ein und dasselbe Papier kann bei verschiedenen Anbietern also unter ganz verschiedenen Symbolen geführt werden.  
  
* Bei Aktien oft das Tickersymbol an ''der jeweiligen'' Börse,
+
* Bei Aktien oft das '''Tickersymbol''' an ''der jeweiligen'' Börse,
* bei in Deutschland gehandelten Papieren gewöhnlich die '''WKN''',
+
* bei in Deutschland gehandelten Papieren gewöhnlich die [[De/Aktienhandel#Code|WKN]],
 
* bei Abfrage über eine Quelle, die mehrere Handelsplätze abruft und möglicherweise Notierungen in verschiedenene Währungen vorhält, wie ''Yahoo'', ergänzt durch
 
* bei Abfrage über eine Quelle, die mehrere Handelsplätze abruft und möglicherweise Notierungen in verschiedenene Währungen vorhält, wie ''Yahoo'', ergänzt durch
:* das Währungssymbol, meist '''EUR''' oder
+
:* das Währungssymbol, meist '''EUR''', oder, falls es an mehreren Plätzen zu leicht unterschiedlichen Kursen gehandelt wird,
 
:* hinter einem Punkt das Kürzel des Handelsplatzes, meist '''.F''' für Frankfurt.
 
:* hinter einem Punkt das Kürzel des Handelsplatzes, meist '''.F''' für Frankfurt.
  
Die [http://de.biz.yahoo.com/sd/index.html Yahoo-Liste der Handelsplätze] zeigt auch, wie verzögert die Kurse sind.
+
Die [http://help.yahoo.com/kb/index?page=content&y=PROD_FIN&locale=de_DE&id=SLN2310&impressions=false Yahoo-Liste der Handelsplätze] oder [http://help.yahoo.com/l/us/yahoo/finance/quotes/fitadelay.html auf englisch] zeigt auch, wie verzögert die Kurse sind.
 +
 
 +
Bisweilen wird auch ein Papier an ''verschiedenen Börsen'' zu leicht ''unterschiedlichen Kursen'' gehandelt.
 +
* Dann kann ein Kriterium für die Auswahl des relevanten Handelsplatzes das jeweilige '''Handelsvolumen''' sein - also als signifikant wählt man den Handelsplatz mit dem über mehrere Tage beobachteten höchsten Umsatz des jeweiligen Papiers.
 +
* Andererseits, wenn ich aus den Kaufbelegen ersehen kann, dass mein Kreditinstitut seine Geschäfte bevorzugt an der Börse X abwickelt - und für andere Börsen eventuell Fremdgebühren in Rechnung stellt - sollte ich diese '''Heimatbörse''' bei der Auswahl bevorzugen.
 +
 
 +
===== Eine Heuristik zur Symbolsuche =====
 +
Leider muß man bei diesen Symbolen ziemlich kreativ sein, um zum Erfolg zu kommen.
 +
 
 +
* Ist der Herausgeber eine der implementierten '''deutschen Fondgesellschaften''' ''Adig/ComInvest/ComDirekt'', ''Deka'', ''DWS'', ''Union''? Symbol ist hier meist die WKN.
 +
 
 +
* Wird das Papier bei einem implementierten '''deutschen Finanzdienstleister''' ''Finanzpartner'', ''VWD'' gelistet? [Wer damit Erfahrung hat, möge die Angaben bitte ergänzen]
 +
 
 +
* Ist es bei '''Yahoo''' gelistet? <pre>http://de.finance.yahoo.com/lookup?s=<ISIN></pre> Symbol von der Seite übernehmen. Möglichst yahoo.com (US) nehmen, da die yahoo.uk (Europe)-Schnittstelle sich nicht gerade durch Stabilität auszeichnet.
 +
 
 +
* Liefert eine '''Google-Suche''' nach der ISIN die Seite eines anderen durch ein FQ-Modul abfragbaren Anbieters? Auf der Webseite nachsehen, was als Symbol verlangt wird.
 +
 
 +
* Sonst: Pech gehabt. Angenommen, die Google-Suche hätte Dir die Seite genannt, deren Aufbau einer Seite ähnelt, für die es bereits ein Modul gibt, könntest Du das natürlich anpassen und, sofern die Juristen des Anbieters das erlauben, es zu [http://sourceforge.net/projects/finance-quote Finanz::Quote] hochladen, damit andere auch etwas davon haben ...
  
 
==== Typ ====
 
==== Typ ====
 +
Der Typ, welcher Programm-intern auch ''namespace'' - Namensraum - heißt, soll dem Benutzer lediglich helfen, seine Papiere zu gruppieren z.B. nach Art und Risken und '''wird nicht an F::Q übergeben'''. Die Vorgabe ist einan US-amerikanische Verhältnisse angepasster Vorschlag, den man größtenteils ignorieren kann:
 +
:* CURRENCY für [http://de.wikipedia.org/wiki/W%C3%A4hrung Währungen] und
 +
:* FUND für [http://de.wikipedia.org/wiki/Fonds Fonds] sind soweit in Ordnung.
 +
Statt des  Restes:
 +
:* [http://de.wikipedia.org/wiki/EUREX EUREX]: ''European Exchange'', ist eine der größten [http://de.wikipedia.org/wiki/Terminb%C3%B6rse Terminbörsen] für [http://de.wikipedia.org/wiki/Finanzderivat Finanzderivate] weltweit.
 +
:* [http://de.wikipedia.org/wiki/NYSE NYSE]: ''New York Stock Exchange'', "die Wallstreet".
 +
:* [http://de.wikipedia.org/wiki/NASDAQ NASDAQ]: ''National Association of Securities Dealers Automated Quotations'', wurde 1971 als vollelektronische Handelsplattform bekannt.
 +
:* '''AMEX''': [http://de.wikipedia.org/wiki/American_Stock_Exchange American Stock Exchange], vormals ''New York Curb Exchange'', eine Wertpapierbörse in New York .
 +
::Warum die letzten drei als Typen unterschieden werden, zumal an anderer Stelle noch der Handelsplatz ausgewählt wird, ist dem Autor nicht ganz klar, vielleicht ein historisches Relikt? Also laut [{{ListURL}}/logs/2008/08/2008-08-18.html#T13:50:00] wurden sie halt irgendwann als Namensräume vorgegeben.
 +
sollte kann sie also so gruppieren, wie es für einen selbst sinnvoll ist, etwa nach
 +
:* Renten (Festverzinslichen),
 +
:* Aktien,
 +
:* Fonds, sowie bei Bedarf:
 +
:* Derivaten und
 +
:* Optionen.
 +
Falls man sehr viele hat, kann man sie weiter gruppieren, indem man z.B. <tt>:<Währung></tt> anhängt:
 +
:* Aktien:EUR
 +
:* Aktien:GBP ...
 +
'''Tip:''' Die Vorgaben lassen sich übrigens mit beliebigen Texten überschreiben, die die ursprüngliche Liste dann ergänzen. Dadurch ist dann möglich, die eigenen Papiere z. B. nach der zuvor gemachten Auflistung zu gruppieren.
 +
 +
Vielleicht findet ja auch irgendwann mal jemand die Zeit, diese Zeichenketten übersetzbar zu machen, damit sie durch jeweils regional sinnvolle Gliederungen ersetzt werden können. ;-)
 +
 +
==== WKN, ISIN oder anderer Code ====
 +
Dies ist ein GnuCash-internes Feld, welches '''''nicht'' an Finance::Quote übergeben wird'''. Man könnte hier also alles mögliche reinschreiben. Gedacht ist es aber, um eine einheitliche Nummer wie
 +
* die [https://de.wikipedia.org/wiki/Internationale_Wertpapierkennnummer International Security Identification Number] '''ISIN''' oder
 +
* die gute alte deutsche [https://de.wikipedia.org/wiki/Wertpapierkennnummer Wertpapier-KennNummer] '''WKN''' zu notieren.
 +
 +
'''Tip:''' Bei deutschen Papieren erhält man aus der ISIN durch Weglassen von "DE", den darauf folgenden führenden Nullen und der letzte Prüfziffer die WKN.
 +
 +
So kann man sich etwa diejenige der beiden Nummern, welche nicht im Symbol vorkommt dort, für den Fall merken, daß die derzeit verwendete Quelle irgendwann unbrauchbar wird und eine andere Quelle mit der anderen Nummer arbeitet.
 +
 +
Insbesondere bei Verwendung der ''ISIN'' gibt einem die Übersicht dann schon einen Hinweis, welche Papiere zusätzlichen ''Wechselkursschwankungen'' unterliegen.
 +
 +
=== In Fremdwährung notierte Papiere ===
 +
Auch wenn es auf den ersten Blick nicht so aussieht - schließlich speichert GnuCash in dem Feld, in dem sonst die Währung gespeichert wird, das Symbol des Wertpapiers - ist es durchaus möglich, in Fremdwährung notierte Papiere anzulegen. Dazu gibt es sogar zwei mögliche Vorgehensweisen:
 +
 +
* '''Die erste Buchung ''in'' das Papier bestimmt die Währung.'''
 +
 +
Dazu startet man seine erste Buchung in das Papier von einem Konto welches in der Währung ist, in welcher das Papier notiert wird. Falls der Wechselkurs-Dialog - etwa bei älteren Versionen - nicht automatisch erscheint, muss man ihn von Hand aufrufen.
  
* CURRENCY für [http://de.wikipedia.org/wiki/W%C3%A4hrung Währungen] und
+
:Abhebung US-Bank xxx [USD]
* FUND für [http://de.wikipedia.org/wiki/Fonds Fonds] sollte klar sein,
+
:Kauf    IBM    y Stück a zz [USD] = xxx [USD]
* [http://de.wikipedia.org/wiki/EUREX EUREX]: ''European Exchange'', ist eine der größten [http://de.wikipedia.org/wiki/Terminb%C3%B6rse Terminbörsen] für [http://de.wikipedia.org/wiki/Finanzderivat Finanzderivate] weltweit.
 
* [http://de.wikipedia.org/wiki/NYSE NYSE]: ''New York Stock Exchange'', "die Wallstreet".
 
* [http://de.wikipedia.org/wiki/NASDAQ NASDAQ]: ''National Association of Securities Dealers Automated Quotations'', wurde 1971 als vollelektronische Handelsplattform bekannt.
 
* '''AMEX''': hier ist dem Autor nicht klar, ob
 
** [http://de.wikipedia.org/wiki/American_Stock_Exchange American Stock Exchange], vormals ''New York Curb Exchange'', eine Wertpapierbörse in New York oder
 
** [http://de.wikipedia.org/wiki/American_Express American Express Company], einen Finanz- und Reisedienstleister, bekannt durch Reiseschecks, gemeint ist.
 
  
Warum die letzten drei als Typen unterschieden werden, zumal an anderer Stelle noch der Handelsplatz ausgewählt wird, ist dem Autor nicht ganz klar, vielleicht ein historisches Relikt? Also laut [http://lists.gnucash.org/logs/2008/08/2008-08-18.html#T13:50:00] wurden sie halt irgendwann als Namensräume vorgegeben. Man kann sie also irgendwie zur Gruppierung, etwa nach Festverzinslichen, Aktien, sowie Derivaten und Optionen verwenden.
+
Um Verwirrung zu vermeiden, sollte man bei diesem Ansatz vermeiden, nachträglich eine Buchung in Drittwährung vor der Eröffnungsbuchung einzufügen.
  
==== Code ====
+
* '''Das übergeordnete Konto bestimmt die Währung, falls die erste Buchung ''aus'' dem Konto des Papiers erfolgt.'''
  
Hier empfiehlt es sich, eine einheitliche Nummer wie die ''International Security Identification Number'' '''ISIN''' oder die gute alte deutsche ''Wertpapier-KennNummer'' '''WKN''' zu notieren. Die Angabe ist aber optional. Bei deutschen Papieren erhält man aus der ISIN durch Weglassen von "DE", den darauf folgenden führenden Nullen und der letzte Prüfziffer die WKN.
+
Dieser Ansatz empfiehlt sich wohl auch deshalb, weil man anhand der Kontenübersicht sieht, welche Papiere in welchen Währungen notiert werden - und welche [http://de.wikipedia.org/wiki/Wechselkursunsicherheit Währungsrisiken] damit verbunden sind:
 +
:Renten
 +
::EUR
 +
:::Bundesschatzbrief XY
 +
::USD
 +
:::Fed. Res. something
 +
:Aktien
 +
::EUR
 +
:::Siemens
 +
::GBP
 +
:::some british shares
 +
::: :
  
 +
Hierbei muss man sich allerdings davor hüten, Wertpapierkonten nachträglich zu verschieben - sonst ist die Verwirrung komplett.
 +
==== Beispiel: Buchung in Fremdwährung notierte Papiere für EUR gekauft ====
 +
Um einen Kaufbeleg "IBM-Aktie in USD notiert, für EUR gekauft" nachzustellen, kann man folgende Struktur verwenden:
 +
:Hausbank (EUR)
 +
:Händler (EUR, Platzhalter)
 +
::EUR (Platzhalter)
 +
:::Abrechnung (Typ: Bank)
 +
:::SIE (Typ: Aktie) ...
 +
::USD (Platzhalter)
 +
:::Abrechnung (Typ: Bank)
 +
:::IBM (Typ: Aktie) ...
 +
Kaufbeleg erfassen:
 +
#x IBM @100 USD <- USD:Abrechnung
 +
#y EUR @1,5 USD <- EUR:Abrechnung
 +
#* ggf. fallen auf beiden Stufen noch noch Gebühren oder später Steuern an, daher die separaten Abrechnungs-Konten zum Aufsummieren.
 +
# Ausgleich Händler:EUR:Abrechnung <- Hausbank (EUR)
 +
:Ausschüttungen, Verkäufe etc. werden später in derselben Reihenfolge, aber mit umgekehrten Vorzeichen erfaßt.
 +
:Alle Stückzahlen (IBM, USD, EUR)sind natürlich dem Kaufbeleg zu entnehmen. Die Preise werden dannn berechnet.
  
 
=== Weitere Maßnahmen ===
 
=== Weitere Maßnahmen ===
 +
Es ist fast geschafft, die folgenden kleineren Maßnahmen können einem das Leben künftig aber noch etwas erleichtern. Weitergehende Informationen gibt es in den zugehörigen [[De/Buchungsbeispiele#Aktien_und_andere_Wertpapiere|Buchungsbeispiele]]n.
  
 +
==== Zugehörige Erfolgskonten ====
 
Damit man später auch eine brauchbare Auswertung seiner Investitionen erhält, empfiehlt es sich, zu '''jedem Anlagekonto''' auch
 
Damit man später auch eine brauchbare Auswertung seiner Investitionen erhält, empfiehlt es sich, zu '''jedem Anlagekonto''' auch
 
* je ein zugehöriges ''Aufwandskonto'', etwa für Makler- und Depotgebühren, als auch  
 
* je ein zugehöriges ''Aufwandskonto'', etwa für Makler- und Depotgebühren, als auch  
 
* mindestens ein ''Ertragskonto'' für Zinsen, Dividenden usw. anzulegen.
 
* mindestens ein ''Ertragskonto'' für Zinsen, Dividenden usw. anzulegen.
 +
Hierbei ist es meist sinnvoll, die Ertragsarten gleich soweit aufzugliedern, dass man hinterher die Zahlen für die leidige Steuererklärung auf einen Blick parat hat.
 +
Die Verbuchung der Dividendenerträge und Kommissionsaufwendungen erfolgt über eine zusätzliche leere Buchung gegen das entsprechende Anlagekonto (mehrteilige Buchung).
 +
 +
==== Anzeige des Wertes in der Kontenübersicht ====
 +
Hat man sein erstes Wertpapier eingebucht, steht in der Kontenübersicht bei "Betrag" etwa 100 DBXD.MU, also Anzahl und Symbol. Spannender wäre aber 100 Stück * aktueller Kurs = aktueller Gesamtwert.
 +
 +
Rechts oben in der Kontenübersicht ist ein Pfeil nach unten. Wenn man darauf
 +
klickt, erscheint eine Liste mit den Spalten, die in der Kontenübersicht
 +
angezeigt werden. Da "Gesamt (EUR)" auswählen und es erscheint die Spalte
 +
mit den Summen in Berichtswährung.
 +
 +
==== Kontrolle im Bericht ''Erweitertes Portefolio'' ====
 +
Erfahrungsgemäß kann es nicht schaden, während der erste Gehversuche auf diesem Gebiet, in einem Register-Tab den Bericht ''Erweitertes Portefolio'' zu öffnen und nach jeder eingegebenen oder geänderten Buchung zu aktualisieren. Da fallen einem dann schnell so unangenehme Dinge wie ein fehlender Wechselkurs auf, der einem ansonsten die ganze schöne Auswertung verhagelt.
 +
 +
==== Ausschüttungstermine und Endfälligkeit als ''terminierte Buchung'' ====
 +
Grundsätzlich kann man ja beliebige ergänzende Angaben in den Feldern des Kontos speichern, allerdings kann es sinnvoller sei, Eigenschaften wie beispielsweise bei einer Anleihe die Endfälligkeit und den Zinstermin als Terminierte Buchungen zu hinterlegen. Am einfachsten geht das vielleicht, wenn man den Buchungssatz des Kaufes auf das Datum der Endfälligkeit kopiert, Buchungsteile vom Typ Aufwendungen des Erwerbs (Provisionen etc.) löscht, und den Rest umdreht - also die Beträge zwischen Haben- und Sollspalte verschiebt. Aber bitte darauf achten, dass die Auszahlung bei Endfälligkeit üblicherweise zum Nennwert erfolgt. Wenn alles so aussieht, wie es voraussichtlich sein wird, verwendet man diese Buchung als Vorlage für eine terminierte Buchung und löscht sie anschließend wieder.
 +
 +
Analog verfährt man mit den regelmäßigen Ausschüttungen z.B. Zinszahlungen. Allerdings handelt es sich hierbei dann um eine, etwa jährlich, ''wiederkehrende'' Buchung, die mit dem Datum der Endfälligkeit ebenfalls endet.
 +
 +
Auf diese Weise erhält man bei einem nach Datum sortierten Fenster ''terminierte Buchungen'' einen Überblick, wann man welche Zahlungszuflüsse zu erwarten hat.
  
 
== Kursabruf am Beispiel der Volkswagen-Aktie ==
 
== Kursabruf am Beispiel der Volkswagen-Aktie ==
Line 91: Line 254:
 
# Unter "Kontobezeichnung" einen verständlichen Namen angebenm wie z.b. "Volkswagen"
 
# Unter "Kontobezeichnung" einen verständlichen Namen angebenm wie z.b. "Volkswagen"
 
# Kontoart "Aktienkonto"
 
# Kontoart "Aktienkonto"
# Bei Aktie/Währung aus "Auswählen" gehen.
+
# Bei Aktie/Währung (engl. Security/currency) auf "Auswählen" gehen.
 
# Dann z.B. als Typ "EUREX" wählen.
 
# Dann z.B. als Typ "EUREX" wählen.
 
# '''Neu'''
 
# '''Neu'''
Line 106: Line 269:
 
# Auf "Kurse abrufen" klicken. Wenn keien Fehlermeldung kommt ist das gut. Dreieck aufklappen mit Links-Klick bei "EUREX", dann "VOW.DE". Man sieht zwei Einträge - einen für EURO, einen für USD. (''bitte hier weitere Erläuterungen ergänzen'')
 
# Auf "Kurse abrufen" klicken. Wenn keien Fehlermeldung kommt ist das gut. Dreieck aufklappen mit Links-Klick bei "EUREX", dann "VOW.DE". Man sieht zwei Einträge - einen für EURO, einen für USD. (''bitte hier weitere Erläuterungen ergänzen'')
  
 +
== Automatisierter Kursabruf mittels cron ==
  
== Automatisierter Kursabruf mittels cron ==
+
Wie sich der Abruf von Kursdaten automatisieren lässt können Sie in der [{{URL:docs}}de/gnucash-manual/finance-quote-scheduler.html GnuCash-Hilfe] nachlesen.
 +
 
 +
Weitere technische Details, zu dem unter Linux verendetem cron-Daemon, finden Sie bei [http://de.wikipedia.org/wiki/Cron wikipedia] oder [http://linuxwiki.de/cron linuxwiki]).
 +
 
 +
Der Zeitpunkt, den Sie für den Kursabruf einstellen, sollte an den Börsenschluss + max(Verzögerung der gewählten Quellen) angepasst sein. Wird nicht berücksichtigt, dass insbesondere Fondskurse relativ spät festgestellt werden, erhält man stattdessen den Schlusskurs des Vortags. Da bei '''Fonds''' üblicherweise das Nettoanlagevermögen ([[De/Glossar#N|NAV]]) nachbörslich ermittelt wird, kann das schon ein paar Stunden, also etwa bis 20 Uhr, dauern.
 +
 
 +
== Weitere Tips für Devisenbuchungen ==
 +
 
 +
=== Grundsätzliches ===
 +
 
 +
Grundsätzlich verarbeitet GnuCash eine Buchung in der Währung des Kontos, in dem man die Buchung beginnt. Falls man direkt im Journal bucht, was nicht empfohlen wird, ist das die eingestellte Standardwährung.
 +
 
 +
=== Rundungsfehler minimieren ===
 +
 
 +
Zur Zeit (2.4.x) werden Buchungen in der Währung des Kontos, aus dem heraus die Buchung begonnen wurde, berechnet. Das hat den unschönen Effekt, dass diese auch die kleinste Einheit vorgibt. Beginnt man etwa eine Transaktion in EUR, deren weitere Buchungsteile auf IDR lauten, dann ist die kleinste Einheit bei einem angenommenen Kurs von 1 EUR = 15 000 IDR ein Euro-Cent = 150 IDR.
 +
 
 +
Es werden also alle IDR-Beträge zu Vielfachen von 150 gerundet, der Rundungsfehler von einem halben Cent summiert sich schlimmstenfalls noch zu einem erklecklichen Betrag und auf dem IDR-Konto stehen Zahlen, die mit den ursprünglich eingegeben Werten wenig zu tun haben. Beginnt man die Buchung aber im IDR-Konto, kann man seine Rechnungen seit ungefähr Version 2.2.7 auf 1/100 IDR genau erfassen.
 +
 
 +
Daher empfiehlt es sich, Devisenbuchungen immer im Konto mit dem niedrigeren Wert der kleinsten Währungseinheit - "Pfennige" - zu beginnen.
 +
 
 +
=== Zwei Standardwährungs-Konten in einer Drittwährung bebuchen ===
 +
 
 +
[{{BugURL}}/show_bug.cgi?id=534618 Bug 482186] erwähnt einen schönen Trick: Der Berichterstatter startet seine Buchung aus einem Dummykonto in Drittwährung heraus, welches er aber schließlich mit 0 CHF bebucht.
 +
 
 +
== Vorsicht beim Verkauf ==
 +
 
 +
Wenn man ein Handelsgut verkauft, geschieht das in den seltensten Fällen zum gleichen Kurs wie der Kauf getätigt wurde, ergo realisiert man einen Kursgewinn oder -verlust.
 +
 
 +
'''Beispiel:'''
 +
Wir haben einen Anfangsbestand von 10.000 € in bar:
 +
Bargeld ./. Anfangsbestand (Eigenkapital): 10.000,00 €
 +
Wir kaufen 100 Anteile X zum aktuellen Kurs von 100 €:
 +
Wertpapiere:X: 100 X x 100,00 €/X ./. Bargeld: 10.000,00 €
 +
Nach einiger Zeit verkaufen wir zum Kurs von 110 €:
 +
Bargeld: 11.000,00 € ./. Wertpapiere:X: 100 x 110,00 €/X
 +
Zunächst freuen wir uns über den Gewinn, aber wenn wir einen Blick auf die Kontenübersicht werfen, erfaßt uns das Entsetzen, da etwas geschehen ist, das nie geschehen darf:
 +
Aktiva: 11.000,00 € <> Eigenkapital 10.000,00 €
 +
Unsere Bilanz ist nicht mehr ausbalanciert.
 +
 
 +
Nun, wir haben vergessen, den Gewinn ordnungsgemäß als solchen zu verbuchen.
 +
Korrekt wäre also statt obiger Buchung:
 +
Wertpapiere:X: 100 x 100,00 €/X Einstandspreis = 10.000,00 € ./. Bargeld 11.000,00 €
 +
Erträge: Kursgewinne: 100 x 10,00 € Kursgewinn =  1.000,00 €
 +
Das Ergebnis lautet dann
 +
Aktiva: 11.000,00 € = Eigenkapital 10.000,00 €
 +
                    + Erträge      1.000,00 €
 +
 
 +
=== Posten- oder Los-Verwaltung ===
 +
 
 +
Wenn man nun aber mehrere Positionen eines Papiers zu unterschiedlichen Kursen erworben hat, beispielsweise werden
 +
* monatlich 50 € zum aktuellen Kurs angelegt,
 +
* Ausschüttungen thesauriert und
 +
* die Depotbank zur Deckung der Verwaltungsgebühren am Jahresende noch Anteile aus unserem Bestand zum jeweiligen Kurs verkauft,
 +
wird die Sache schnell unübersichtlich.
 +
 
 +
In diesem Fall kann man einfach den Verkauf mit aktuellen Kursen buchen und korrigierende Ertragsbuchungen von GnuCash über ''Aktionen->Posten anzeigen->Konto überprüfen'' oder ''Aktionen->Überprüfen->...'' einfügen lassen. Gegebenenfalls werden dabei einzelne Buchungsteile in mehrere ''Posten'' oder ''Lose'' aufgeteilt.
 +
 
 +
In den ''Realisierter Gewinn/Verlust''-Buchungen ist dann nur noch das zugehörige Ertragskonto auszuwählen. Das läßt sich am einfachsten realisieren, indem man das Konto ''[Erträge:]Unverknüpfte Gewinne-<Währung>'' löscht und dabei die Buchungen in das gewünschte Ertragskonto verschiebt.
 +
 
 +
Es bleibt allerdings noch die Frage offen, inwieweit die '''Zuordnungsstrategie''' den Erfordernissen deutschen Rechts entspricht. Unter anderem existieren folgende [http://de.wikipedia.org/wiki/Verbrauchsfolgeverfahren Verbrauchsfolgeverfahren]:
 +
* Zuordnung nach Zeitpunkt des Erwerbs:
 +
** '''FiFo''': ''First In - First Out'', die logisch und technisch einfachste Variante, welche seit 2000irgendwas dem deutschen Privatanleger vorgeschrieben ist.
 +
** '''LiFo''': ''Last In - First Out'', bei Handelsgütern auf volatilen Märkten sinnvoll
 +
* Zuordnung nach Wert
 +
** '''HiFo''': ''Highest In - First Out''; in Deuschland wegen des [[http://de.wikipedia.org/wiki/Niederstwertprinzip Niederstwertprinzips]] ursprünglich die Regel,
 +
** '''LoFo''': ''LOwest in - First Out''.
 +
 
 +
Für seit 2009 erworbene Papiere ist steuerlich für Kursgewinne das in GnuCash implementierte FIFO vorgesehen. Im Zweifelsfall sollte man die Thematik mit seinem Steuerberater besprechen und die Buchungen entsprechend anpassen.
 +
 
 +
=== Handelskonten ===
 +
 
 +
Ab Version 2.3.x können auch die '''Handelskonten''', zu aktivieren über ''Datei->Eigenschaften->Konten->Devisenhandels-Konten benutzen'' verwendet werden. Das Vorgehen dabei müßte noch mal jemand - ja genau, '''''Du'''''! - hier einfügen.
 +
 
 +
== Sonstige Informationen, Speicherorte usw. ==
 +
 
 +
=== Online-Kursabfrage für ein Papier beenden ===
 +
 
 +
Wenn ein Papier seine Endfälligkeit erreicht oder es einen, da man es nicht mehr hält, nicht mehr weiter interessiert, sollte man die Online-Kursabfrage dafür abschalten.
 +
 
 +
Solange Papiere noch bei "Börsenkurse online abrufen" ein Häkchen haben, wird die Datenbank des Preiseditors (zu finden unter "Werkzeuge") mit jedem Klick auf "Kurse abrufen" im Preiseditor diese auch abrufen und in der Datenbank halten. Um das zu vermeiden, muss man die das Häkchen bei "Börsenkurse online abrufen" im Wertpapier-Editor wegmachen (auch unter "Werkzeuge" zu finden) oder
 +
# darauf basierende Konten in der Kontenübersicht und
 +
# die commodities im Aktieneditor und
 +
# die Kurse im Preiseditor löschen.
 +
 
 +
=== Speicherorte ===
 +
 
 +
In der unkomprimierten Gnucash-Datei (in Bearbeiten, Einstellungen, Allgemein das Häkchen bei "Datei komprimieren" entfernen) findet man
 +
 
 +
* die ''Definitionen von Wertpapieren'' und Währungen jeweils zwischen '''<gnc:commodity version="2.0.0">''' und '''</gnc:commodity>'''
 +
 
 +
* die ''Kurse'' jeweils zwischen '''<gnc:pricedb version="1">''' und '''</gnc:pricedb>'''
 +
 
 +
* die Posten oder ''Lose'', welche lokal zum jeweiligen Konto sind, also in
 +
:'''<gnc:account version="2.0.0">''' ... '''</gnc:account>'''
 +
:zwischen '''<act:lots>''' und '''</act:lots>'''.
 +
 
 +
== Fehlersuche im Zusammenhang mit Finance::Quote ==
 +
Wenn GnuCash meldet, dass es einen Kurs nicht aktualisieren kann, führt man am Besten die folgenden Schritte aus.
 +
 
 +
=== Stufe 1: gnc-fq-check ===
 +
Zunächst sollte überprüft werden, ob FQ einwandfrei installiert ist.
 +
:;Beispiel mit fehlerhafter Abhängigkeit: {{FQ Check broken}} Der erste Teil weist auf das fehlende Perl-Modul <tt>Mozilla/CA.pm</tt> hin, während der Ausdruck in Klammern die FQ-Version und die verfügbaren Quellen ausgibt.
 +
:Nach unserem Kenntnisstand wäre Finance::Quote {{FQ Version}} aktuell.
 +
:Falls so eine Fehlermeldung kommt oder die installierte Version veraltet ist, siehe [[#Bei Formatänderung der Quelle: gnc-fq-update]].
 +
 
 +
=== Stufe 2: gnc-fq-dump ===
 +
 
 +
Gerade, wenn man sich bezüglich eines Symbols nicht sicher ist, ist es schneller, seine Angaben mit
 +
<Syntaxhighlight lang="sh">
 +
gnc-fq-dump [-v] <Quelle> <Kürzel1> [<Kürzel2> ...]
 +
</Syntaxhighlight>
 +
zu überprüfen als in GnuCash immer wieder eine Einstellung zu ändern und ''alle'' Kurse abzurufen. Weiterhin sieht man bei dieser Methode besser, wo der Fehler liegt. Da sie auch unvollständige Ergebnisse liefert, sieht man dann beispielsweise, ob Yahoo mal wieder das Format geändert hat oder das Symbol wirklich unbekannt ist.
 +
 
 +
=== Stufe 3: gnc-fq-helper ===
 +
 
 +
Leider gibt es auch Fehler, die sich bei der Verwendung von ''gnc-fq-dump'' vor den Augen des Benutzers verstecken, wie etwa ein angehängtes Leerzeichen. Falls also das Ergebnis von ''gnc-fq-dump'' sauber aussieht, GnuCash es aber "partout nicht fressen will", sollte man den für den Laien etwas gewöhnungsbedürftigen '''gnc-fq-helper''' verwenden. Am Beispiel der berühmten Unilever-Anleihe, die im September 2008 die Mailingliste unsicher machte, sieht der Aufruf und das Ergebnis dann so aus:
 +
<Syntaxhighlight lang="console">
 +
user@host:~$ echo '(yahoo_europe "A0GFY7.SG")' | gnc-fq-helper
 +
(("A0GFY7.SG" (symbol . "A0GFY7.SG") (gnc:time-no-zone . "2008-09-26 16:58:00") (last . 89.50) (currency . "EUR ")))
 +
</Syntaxhighlight>
 +
 
 +
Wer sieht den Fehler? [{{BugURL}}/show_bug.cgi?id=553902#c4 Lösung]
 +
 
 +
== An Finance::Quote basteln ==
  
Mithilfe des Befehls
+
Wer nun neugierig geworden ist, wie Finance::Quote im einzelnen funktioniert, kann sich gerne die Module anschauen. Schließlich ist Perl eine Skript-Sprache, die man mit einem normalen Editor bearbeiten kann und nicht compilieren muss.
gnucash --add-price-quotes $HOME/<GnuCash-Dateiname>
 
können die Kurse aktualisiert werden, ohne das GUI zu laden.
 
  
Das läßt sich auch automatisieren, indem man (unter Linux) dem cron-Daemon die Arbeit überläßt (siehe cron in [http://de.wikipedia.org/wiki/Cron wikipedia] oder [http://linuxwiki.de/cron linuxwiki]). Wollte man also jeden Freitag um 16:00 seine Kursdatenbank aktualisieren, so wäre die Zeile
+
Bei opensuse liegen sie unter  
 +
/usr/lib/perl5/
 +
. Die nächste Verzeichnisebene unterscheidet zwischen der mitgelieferten Version ''vendor_perl'' und einer eventuell mit gnc-fq-update oder cpan heruntergeladenen Version ''site_perl''. Die nächste Ebene bezeichnet die ''Perl-Version'', bevor man endlich in das Verzeichnis ''Finance'' kommt.
  
0 16 * * 5 gnucash --add-price-quotes $HOME/<GnuCash-Dateiname> > /dev/null 2>&1
+
Bevor man sich die Mühe macht, Änderungen vorzunehmen und an das Projekt einzuschicken, ist es vielleicht sinnvoll, ein wenig auf den Projektseiten bei
in die persönliche crontab einzufügen.
+
:[https://github.com/finance-quote GitHub],
 +
:[https://metacpan.org/release/Finance-Quote CPAN] (beide aktuell) und
 +
:[https://sourceforge.net/projects/finance-quote/ sourceforge]
 +
zu stöbern, um zu sehen, ob dort bereits ein entsprechender Patch herumliegt und welche Arten von Änderungen nicht akzeptiert werden, weil sie etwa einen falschen Ansatz verfolgen.
  
Die 16:00 sollte man natürlich an Börsenschluß + max(Verzögerung der gewählten Quellen) anpassen. Falls man nicht beachtet, daß insbesondere Fondkurse relativ spät festgestellt werden, erhält man stattdessen den Schlußkurs des Vortags.
+
Ebenso kann es sinnvoll sein, den Autor des Moduls, an dem man Änderungen vornehmen möchte, zu kontaktieren, um sich doppelte Arbeit zu ersparen. Selbiger steht meist irgendwo in den Kommentaren des jeweiligen Moduls.
  
+
----
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[De/GnuCash | Zurück zur Hauptseite]]
 +
 +
[[Category:De|Aktienhandel]]

Latest revision as of 17:47, 6 April 2023

Wie man ein Aktien- oder Wertpapier-Depot anlegt und zugehörige Kurse online abfragt ...

Zurück zur Hauptseite englische Version 简体中文
Offizielle Dokumentation
Manual
Einrichten der Kursabfrage,
Wertpapier anlegen oder bearbeiten;
Guide
Automatische Kursabfragen konfigurieren.

Aktuelles

Leider hat Yahoo! nach einem Eigentümerwechsel am 1.11.2017 die von vielen genutzte CSV-Schnittstelle abgeschaltet. Dadurch stehen die Quellen Währung/currency, yahoo* (mit Ausnahme von json), canada, usa, nyse, nasdaq, vanguard nicht mehr zur Verfügung. Die Finance::Quote-Entwickler haben hart daran gearbeitet, diese Funktionalität durch die neue Quelle Alphavantage zu ersetzen. Die Details, um Alphavantage zu nutzen, sind im Anhang der Hilfe beschrieben.

Drosselung
Beim kostenlosen Alphavantage-Schlüssel sind die Abfragen auf derzeit 5/min. gedrosselt. Wer bereits ein paar Währungen abfragt, sollte also für Wertpapiere andere Quellen, etwa Yahoo über JSON suchen.
Windows
Benutzer die schon lange dabei sind, müssen eventuell ihre Perl-Version aktualisiern. Dazu entfernt man alle vorhandenen Versionen sowohl in der Systemsteuerung, als auch im Explorer. Anschließend führt man Erweiterung um Wechselkurse mit GnuCash online abzurufen erneut aus, wodurch eine aktuelle Version von Strawberry Perl installiert wird.

Weiterhin empfiehlt es sich, die Mailing-Liste gnucash-user zu beobachten, da dort neue Versionen von F::Q angekündigt werden.

(Sobald sich die Lage stabilisiert hat, kann dieses Kapitel in den Rest der Seite eingearbeitet werden.)

Einleitung

Mit GnuCash kann man eine Vielzahl verschiedener Wertpapiere und auch Edelmetalle verwalten. Dazu gehören:

  • Edelmetalle: XAU - Gold, XAG - Silber, ... als Untergruppe der
  • Währungen: EUR, GBP, USD ...
  • Anleihen, Renten und andere handelbare festverzinsliche Papiere
  • Aktien, also an Börsen gehandelte Unternehmensanteile
  • Fonds, also Papiere von Gesellschaften, die wieder in die zuvor genannten investieren.

Für Kauf und Verkauf dieser Papiere ist natürlich immer maßgeblich, was man auf dem entsprechenden Beleg stehen hat. Will man sich aber zwischendurch einen Überblick über den aktuellen Wert seiner Investitionen machen, so kann man mithilfe des Moduls Finance::Quote Onlinekurse aus verschiedenen Quellen abrufen und zur weiteren Verwendung, etwa in den Portefolio-Berichten, in der Kursdatenbank abspeichern.

Verschiedene Anbieter wie etwa Börsen und Fondgesellschaften, aber auch Dritte wie Yahoo, bieten auf ihren Webseiten kostenlose Kursinformationen an. Diese sind bisweilen etwas zeitverzögert, um kommerziellen Anbietern wie Reuters nicht das Wasser abzugraben, für den Privatgebrauch aber allemal gut.

Diese Anbieter werden im Folgenden als Quellen bezeichnet. Daneben ist noch das Symbol wichtig, unter dem das Wertpapier bei dem jeweiligen Anbieter gelistet wird..

Voraussetzungen

Um diese auszulesen und u.a. für GnuCash zur Verfügung zu stellen, gibt es das eigenständige Projekt Finance::Quote (F::Q). Dorthin sind also auch eventuelle Fehlerberichte zu senden, falls etwa eine Seite ihr Format geändert hat. Die Installation wird in der GnuCash-Hilfe beschrieben.

Weitere Möglichkeiten (gnc-fq-update und CPAN) sind in #Bei Formatänderung der Quelle: gnc-fq-update ff. erläutert.

Quellen in Finance::Quote

Um zu erfahren, welche dieser Quellen dem Perl-Programm Finance::Quote zur Verfügung stehen, gibt man an der Konsole

gnc-fq-check

ein. Dabei sieht man auch gleich, welche FQ-Version man verwendet. Falls hier eine Fehlermeldung kommt, kann es auf Unix-artigen Systemen sinnvoll sein, das unten erwähnte gnc-fq-update durchführen, um Finance::Quote zu aktualisieren.

Um die Dokumentation zu einer Quelle anzuzeigen, kann man

man Finance::Quote::<Quelle>

oder

perldoc Finance::Quote::<Quelle>

an der Konsole eingeben oder im Browser die Datei /usr/share/man/man3/Finance::Quote::<Quelle>.3pm öffnen - zumindest in Linux, Pfade für andere Systeme bitte ergänzen.

Eine Übersicht der Kursquellen mit Erläuterungen gibt es in der Referenz.

Um die ausführliche Dokumentation von Finance::Quote zu lesen, kann man an der Konsole

man Finance::Quote

eingeben. Diese zielt aber mehr auf Perl-Programmierer als auf Anwender.

Bei Formatänderung der Quelle: gnc-fq-update

Schließlich kann man, zumindest unter Linux, mit

sudo gnc-fq-update

Finance::Quote mit allen erforderlichen Modulen und eventuellen Schnittstellen zu neuen Datenquellen auf den neuesten Stand bringen, ohne sich erst mit dem Comprehensive Perl Archive Network (CPAN) auseinandersetzen zu müssen. Falls man das doch nutzt, hat die englische Seite CPAN noch ein paar Hinweise.

Ubuntu und Derivate
Falls dieser Script auf Ihrem System nicht vorhanden ist, finden Sie es hier. Ein Beispiel, wie es anzupassen wäre, befindet sich hier.

Für die Quartz-Version von OSX lauten die Befehle:

sudo perl -MCPAN -e shell
sudo /Applications/Gnucash.app/Contents/Resources/bin/gnc-fq-update

Die Anleitung hierzu für Windows steht auf der Installationsseite.

oder manuelles Ersetzen mit noch nicht veröffentlichten Modulen

Neuere Versionen von Finance::Quote (ab 1.18, September 2012) holen erfolgreich die Währungskurse. Somit erübrigt sich die gepatchte Version [Quote.pm] von Mike Alexander.

Um Ihre aktuelle Finance::Quote-Installation zu überprüfen:

cpan -D Finance::Quote

Die Ausgabe davon liefert einem

  • den Pfad, wo Quote.pm installiert ist
  • ob man auch die zuletzt veröffentlichte Version 1.18 hat und damit "up to date" ist.
Sollte das nicht der Fall sein, sollte man zunächst F::Q wie oben beschrieben aktualisieren.

Falls erforderlich kann man die installierte Version mit einer noch nicht als stabil freigegebenen Version überschreiben, was allerdings Administratorrechte benötigt. Der offizielle, saubere Weg ist zwar ein anderer, siehe etwa [1], aber so geht es wohl für die meisten am einfachsten und schnellsten.

Weitere Details zur Verwendung von cpan finden sich auf der englischen Seite.

Die Qual der Wahl der Quelle

Da das Symbol ein und desselben Papiers bei den verschiedenen Kursquellen recht verschieden sein kann, hier eine Faustregel:

  • Wenn ich als Kleinanleger sowieso nur die Produkte der mit meinem Finanzinstituts X assoziierten Fondgesellschaft Y kaufe, reicht es, wenn ich mich mit der Symbol-Terminologie dieser Gesellschaft vertraut mache.
  • Bin ich aber eine global agierende Heuschrecke, ist es wohl besser, sich mit der Yahoo-Terminologie vertraut zu machen und, soweit möglich, alle Papiere über eines der Yahoo-Module oder über Alphavantage abzurufen.

Felder im Aktieneditor

Für F::Q wichtig sind das Symbol und die Quelle, wobei eben das Symbol je nach Quelle verschieden sein kann.

Voller Name

Na, was wohl? Name und Symbol erscheinen später in der Spalte "Währung/Aktie" in der Kontenübersicht. Spätestens wenn man mehrere ähnliche Papiere hat, ist es sinnvoll signifikante Daten wie etwa Herausgeber, Art, ggf. Zinssatz und Endfälligkeit in den Namen einzubauen.

Symbol

Das Symbol, ist das Kürzel, unter dem das Papier bei dem entsprechenden Dienst aufgeführt ist. Vorsicht, ein und dasselbe Papier kann bei verschiedenen Anbietern also unter ganz verschiedenen Symbolen geführt werden.

  • Bei Aktien oft das Tickersymbol an der jeweiligen Börse,
  • bei in Deutschland gehandelten Papieren gewöhnlich die WKN,
  • bei Abfrage über eine Quelle, die mehrere Handelsplätze abruft und möglicherweise Notierungen in verschiedenene Währungen vorhält, wie Yahoo, ergänzt durch
  • das Währungssymbol, meist EUR, oder, falls es an mehreren Plätzen zu leicht unterschiedlichen Kursen gehandelt wird,
  • hinter einem Punkt das Kürzel des Handelsplatzes, meist .F für Frankfurt.

Die Yahoo-Liste der Handelsplätze oder auf englisch zeigt auch, wie verzögert die Kurse sind.

Bisweilen wird auch ein Papier an verschiedenen Börsen zu leicht unterschiedlichen Kursen gehandelt.

  • Dann kann ein Kriterium für die Auswahl des relevanten Handelsplatzes das jeweilige Handelsvolumen sein - also als signifikant wählt man den Handelsplatz mit dem über mehrere Tage beobachteten höchsten Umsatz des jeweiligen Papiers.
  • Andererseits, wenn ich aus den Kaufbelegen ersehen kann, dass mein Kreditinstitut seine Geschäfte bevorzugt an der Börse X abwickelt - und für andere Börsen eventuell Fremdgebühren in Rechnung stellt - sollte ich diese Heimatbörse bei der Auswahl bevorzugen.
Eine Heuristik zur Symbolsuche

Leider muß man bei diesen Symbolen ziemlich kreativ sein, um zum Erfolg zu kommen.

  • Ist der Herausgeber eine der implementierten deutschen Fondgesellschaften Adig/ComInvest/ComDirekt, Deka, DWS, Union? Symbol ist hier meist die WKN.
  • Wird das Papier bei einem implementierten deutschen Finanzdienstleister Finanzpartner, VWD gelistet? [Wer damit Erfahrung hat, möge die Angaben bitte ergänzen]
  • Ist es bei Yahoo gelistet?
    http://de.finance.yahoo.com/lookup?s=<ISIN>
    Symbol von der Seite übernehmen. Möglichst yahoo.com (US) nehmen, da die yahoo.uk (Europe)-Schnittstelle sich nicht gerade durch Stabilität auszeichnet.
  • Liefert eine Google-Suche nach der ISIN die Seite eines anderen durch ein FQ-Modul abfragbaren Anbieters? Auf der Webseite nachsehen, was als Symbol verlangt wird.
  • Sonst: Pech gehabt. Angenommen, die Google-Suche hätte Dir die Seite genannt, deren Aufbau einer Seite ähnelt, für die es bereits ein Modul gibt, könntest Du das natürlich anpassen und, sofern die Juristen des Anbieters das erlauben, es zu Finanz::Quote hochladen, damit andere auch etwas davon haben ...

Typ

Der Typ, welcher Programm-intern auch namespace - Namensraum - heißt, soll dem Benutzer lediglich helfen, seine Papiere zu gruppieren z.B. nach Art und Risken und wird nicht an F::Q übergeben. Die Vorgabe ist einan US-amerikanische Verhältnisse angepasster Vorschlag, den man größtenteils ignorieren kann:

Statt des Restes:

  • EUREX: European Exchange, ist eine der größten Terminbörsen für Finanzderivate weltweit.
  • NYSE: New York Stock Exchange, "die Wallstreet".
  • NASDAQ: National Association of Securities Dealers Automated Quotations, wurde 1971 als vollelektronische Handelsplattform bekannt.
  • AMEX: American Stock Exchange, vormals New York Curb Exchange, eine Wertpapierbörse in New York .
Warum die letzten drei als Typen unterschieden werden, zumal an anderer Stelle noch der Handelsplatz ausgewählt wird, ist dem Autor nicht ganz klar, vielleicht ein historisches Relikt? Also laut [2] wurden sie halt irgendwann als Namensräume vorgegeben.

sollte kann sie also so gruppieren, wie es für einen selbst sinnvoll ist, etwa nach

  • Renten (Festverzinslichen),
  • Aktien,
  • Fonds, sowie bei Bedarf:
  • Derivaten und
  • Optionen.

Falls man sehr viele hat, kann man sie weiter gruppieren, indem man z.B. :<Währung> anhängt:

  • Aktien:EUR
  • Aktien:GBP ...

Tip: Die Vorgaben lassen sich übrigens mit beliebigen Texten überschreiben, die die ursprüngliche Liste dann ergänzen. Dadurch ist dann möglich, die eigenen Papiere z. B. nach der zuvor gemachten Auflistung zu gruppieren.

Vielleicht findet ja auch irgendwann mal jemand die Zeit, diese Zeichenketten übersetzbar zu machen, damit sie durch jeweils regional sinnvolle Gliederungen ersetzt werden können. ;-)

WKN, ISIN oder anderer Code

Dies ist ein GnuCash-internes Feld, welches nicht an Finance::Quote übergeben wird. Man könnte hier also alles mögliche reinschreiben. Gedacht ist es aber, um eine einheitliche Nummer wie

Tip: Bei deutschen Papieren erhält man aus der ISIN durch Weglassen von "DE", den darauf folgenden führenden Nullen und der letzte Prüfziffer die WKN.

So kann man sich etwa diejenige der beiden Nummern, welche nicht im Symbol vorkommt dort, für den Fall merken, daß die derzeit verwendete Quelle irgendwann unbrauchbar wird und eine andere Quelle mit der anderen Nummer arbeitet.

Insbesondere bei Verwendung der ISIN gibt einem die Übersicht dann schon einen Hinweis, welche Papiere zusätzlichen Wechselkursschwankungen unterliegen.

In Fremdwährung notierte Papiere

Auch wenn es auf den ersten Blick nicht so aussieht - schließlich speichert GnuCash in dem Feld, in dem sonst die Währung gespeichert wird, das Symbol des Wertpapiers - ist es durchaus möglich, in Fremdwährung notierte Papiere anzulegen. Dazu gibt es sogar zwei mögliche Vorgehensweisen:

  • Die erste Buchung in das Papier bestimmt die Währung.

Dazu startet man seine erste Buchung in das Papier von einem Konto welches in der Währung ist, in welcher das Papier notiert wird. Falls der Wechselkurs-Dialog - etwa bei älteren Versionen - nicht automatisch erscheint, muss man ihn von Hand aufrufen.

Abhebung US-Bank xxx [USD]
Kauf IBM y Stück a zz [USD] = xxx [USD]

Um Verwirrung zu vermeiden, sollte man bei diesem Ansatz vermeiden, nachträglich eine Buchung in Drittwährung vor der Eröffnungsbuchung einzufügen.

  • Das übergeordnete Konto bestimmt die Währung, falls die erste Buchung aus dem Konto des Papiers erfolgt.

Dieser Ansatz empfiehlt sich wohl auch deshalb, weil man anhand der Kontenübersicht sieht, welche Papiere in welchen Währungen notiert werden - und welche Währungsrisiken damit verbunden sind:

Renten
EUR
Bundesschatzbrief XY
USD
Fed. Res. something
Aktien
EUR
Siemens
GBP
some british shares
 :

Hierbei muss man sich allerdings davor hüten, Wertpapierkonten nachträglich zu verschieben - sonst ist die Verwirrung komplett.

Beispiel: Buchung in Fremdwährung notierte Papiere für EUR gekauft

Um einen Kaufbeleg "IBM-Aktie in USD notiert, für EUR gekauft" nachzustellen, kann man folgende Struktur verwenden:

Hausbank (EUR)
Händler (EUR, Platzhalter)
EUR (Platzhalter)
Abrechnung (Typ: Bank)
SIE (Typ: Aktie) ...
USD (Platzhalter)
Abrechnung (Typ: Bank)
IBM (Typ: Aktie) ...

Kaufbeleg erfassen:

  1. x IBM @100 USD <- USD:Abrechnung
  2. y EUR @1,5 USD <- EUR:Abrechnung
    • ggf. fallen auf beiden Stufen noch noch Gebühren oder später Steuern an, daher die separaten Abrechnungs-Konten zum Aufsummieren.
  3. Ausgleich Händler:EUR:Abrechnung <- Hausbank (EUR)
Ausschüttungen, Verkäufe etc. werden später in derselben Reihenfolge, aber mit umgekehrten Vorzeichen erfaßt.
Alle Stückzahlen (IBM, USD, EUR)sind natürlich dem Kaufbeleg zu entnehmen. Die Preise werden dannn berechnet.

Weitere Maßnahmen

Es ist fast geschafft, die folgenden kleineren Maßnahmen können einem das Leben künftig aber noch etwas erleichtern. Weitergehende Informationen gibt es in den zugehörigen Buchungsbeispielen.

Zugehörige Erfolgskonten

Damit man später auch eine brauchbare Auswertung seiner Investitionen erhält, empfiehlt es sich, zu jedem Anlagekonto auch

  • je ein zugehöriges Aufwandskonto, etwa für Makler- und Depotgebühren, als auch
  • mindestens ein Ertragskonto für Zinsen, Dividenden usw. anzulegen.

Hierbei ist es meist sinnvoll, die Ertragsarten gleich soweit aufzugliedern, dass man hinterher die Zahlen für die leidige Steuererklärung auf einen Blick parat hat. Die Verbuchung der Dividendenerträge und Kommissionsaufwendungen erfolgt über eine zusätzliche leere Buchung gegen das entsprechende Anlagekonto (mehrteilige Buchung).

Anzeige des Wertes in der Kontenübersicht

Hat man sein erstes Wertpapier eingebucht, steht in der Kontenübersicht bei "Betrag" etwa 100 DBXD.MU, also Anzahl und Symbol. Spannender wäre aber 100 Stück * aktueller Kurs = aktueller Gesamtwert.

Rechts oben in der Kontenübersicht ist ein Pfeil nach unten. Wenn man darauf klickt, erscheint eine Liste mit den Spalten, die in der Kontenübersicht angezeigt werden. Da "Gesamt (EUR)" auswählen und es erscheint die Spalte mit den Summen in Berichtswährung.

Kontrolle im Bericht Erweitertes Portefolio

Erfahrungsgemäß kann es nicht schaden, während der erste Gehversuche auf diesem Gebiet, in einem Register-Tab den Bericht Erweitertes Portefolio zu öffnen und nach jeder eingegebenen oder geänderten Buchung zu aktualisieren. Da fallen einem dann schnell so unangenehme Dinge wie ein fehlender Wechselkurs auf, der einem ansonsten die ganze schöne Auswertung verhagelt.

Ausschüttungstermine und Endfälligkeit als terminierte Buchung

Grundsätzlich kann man ja beliebige ergänzende Angaben in den Feldern des Kontos speichern, allerdings kann es sinnvoller sei, Eigenschaften wie beispielsweise bei einer Anleihe die Endfälligkeit und den Zinstermin als Terminierte Buchungen zu hinterlegen. Am einfachsten geht das vielleicht, wenn man den Buchungssatz des Kaufes auf das Datum der Endfälligkeit kopiert, Buchungsteile vom Typ Aufwendungen des Erwerbs (Provisionen etc.) löscht, und den Rest umdreht - also die Beträge zwischen Haben- und Sollspalte verschiebt. Aber bitte darauf achten, dass die Auszahlung bei Endfälligkeit üblicherweise zum Nennwert erfolgt. Wenn alles so aussieht, wie es voraussichtlich sein wird, verwendet man diese Buchung als Vorlage für eine terminierte Buchung und löscht sie anschließend wieder.

Analog verfährt man mit den regelmäßigen Ausschüttungen z.B. Zinszahlungen. Allerdings handelt es sich hierbei dann um eine, etwa jährlich, wiederkehrende Buchung, die mit dem Datum der Endfälligkeit ebenfalls endet.

Auf diese Weise erhält man bei einem nach Datum sortierten Fenster terminierte Buchungen einen Überblick, wann man welche Zahlungszuflüsse zu erwarten hat.

Kursabruf am Beispiel der Volkswagen-Aktie

  1. Neue Datei erstellen, wähle den "Aktienhandel"-Kontenrahmen.
  2. Unter Aktiva>Aktiendepot findest Du z.B. das Überkonto "Aktie"
  3. Eine neue Aktie anlegen mit rechter Taste auf "Aktie" und "Neues Konto..."
  4. Unter "Kontobezeichnung" einen verständlichen Namen angebenm wie z.b. "Volkswagen"
  5. Kontoart "Aktienkonto"
  6. Bei Aktie/Währung (engl. Security/currency) auf "Auswählen" gehen.
  7. Dann z.B. als Typ "EUREX" wählen.
  8. Neu
    1. Voller Name, am besten so wie bei Kontobezeichnung oder länger.
    2. Symbol/Abkürzung - Hier z.B. zu

gehen und Aktie suchen. (In unserem konkreten Fall wäre das "VOW.DE")

    1. "Börsenkurse online abrufen" auswählen
    2. Hier z.B. "Yahoo" wählen. dann drei mal die Dialoge bestätigen mit OK
  1. Bei Werkzeuge auf "Preis-Editor" gehen
    1. "Hinzufügen" - und Auswählen was wir vorhin eingegeben haben. Bestätigen.
  2. Auf "Kurse abrufen" klicken. Wenn keien Fehlermeldung kommt ist das gut. Dreieck aufklappen mit Links-Klick bei "EUREX", dann "VOW.DE". Man sieht zwei Einträge - einen für EURO, einen für USD. (bitte hier weitere Erläuterungen ergänzen)

Automatisierter Kursabruf mittels cron

Wie sich der Abruf von Kursdaten automatisieren lässt können Sie in der GnuCash-Hilfe nachlesen.

Weitere technische Details, zu dem unter Linux verendetem cron-Daemon, finden Sie bei wikipedia oder linuxwiki).

Der Zeitpunkt, den Sie für den Kursabruf einstellen, sollte an den Börsenschluss + max(Verzögerung der gewählten Quellen) angepasst sein. Wird nicht berücksichtigt, dass insbesondere Fondskurse relativ spät festgestellt werden, erhält man stattdessen den Schlusskurs des Vortags. Da bei Fonds üblicherweise das Nettoanlagevermögen (NAV) nachbörslich ermittelt wird, kann das schon ein paar Stunden, also etwa bis 20 Uhr, dauern.

Weitere Tips für Devisenbuchungen

Grundsätzliches

Grundsätzlich verarbeitet GnuCash eine Buchung in der Währung des Kontos, in dem man die Buchung beginnt. Falls man direkt im Journal bucht, was nicht empfohlen wird, ist das die eingestellte Standardwährung.

Rundungsfehler minimieren

Zur Zeit (2.4.x) werden Buchungen in der Währung des Kontos, aus dem heraus die Buchung begonnen wurde, berechnet. Das hat den unschönen Effekt, dass diese auch die kleinste Einheit vorgibt. Beginnt man etwa eine Transaktion in EUR, deren weitere Buchungsteile auf IDR lauten, dann ist die kleinste Einheit bei einem angenommenen Kurs von 1 EUR = 15 000 IDR ein Euro-Cent = 150 IDR.

Es werden also alle IDR-Beträge zu Vielfachen von 150 gerundet, der Rundungsfehler von einem halben Cent summiert sich schlimmstenfalls noch zu einem erklecklichen Betrag und auf dem IDR-Konto stehen Zahlen, die mit den ursprünglich eingegeben Werten wenig zu tun haben. Beginnt man die Buchung aber im IDR-Konto, kann man seine Rechnungen seit ungefähr Version 2.2.7 auf 1/100 IDR genau erfassen.

Daher empfiehlt es sich, Devisenbuchungen immer im Konto mit dem niedrigeren Wert der kleinsten Währungseinheit - "Pfennige" - zu beginnen.

Zwei Standardwährungs-Konten in einer Drittwährung bebuchen

Bug 482186 erwähnt einen schönen Trick: Der Berichterstatter startet seine Buchung aus einem Dummykonto in Drittwährung heraus, welches er aber schließlich mit 0 CHF bebucht.

Vorsicht beim Verkauf

Wenn man ein Handelsgut verkauft, geschieht das in den seltensten Fällen zum gleichen Kurs wie der Kauf getätigt wurde, ergo realisiert man einen Kursgewinn oder -verlust.

Beispiel: Wir haben einen Anfangsbestand von 10.000 € in bar:

Bargeld ./. Anfangsbestand (Eigenkapital): 10.000,00 €

Wir kaufen 100 Anteile X zum aktuellen Kurs von 100 €:

Wertpapiere:X: 100 X x 100,00 €/X ./. Bargeld: 10.000,00 €

Nach einiger Zeit verkaufen wir zum Kurs von 110 €:

Bargeld: 11.000,00 € ./. Wertpapiere:X: 100 x 110,00 €/X

Zunächst freuen wir uns über den Gewinn, aber wenn wir einen Blick auf die Kontenübersicht werfen, erfaßt uns das Entsetzen, da etwas geschehen ist, das nie geschehen darf:

Aktiva: 11.000,00 € <> Eigenkapital 10.000,00 €

Unsere Bilanz ist nicht mehr ausbalanciert.

Nun, wir haben vergessen, den Gewinn ordnungsgemäß als solchen zu verbuchen. Korrekt wäre also statt obiger Buchung:

Wertpapiere:X: 100 x 100,00 €/X Einstandspreis = 10.000,00 € ./. Bargeld 11.000,00 €
Erträge: Kursgewinne: 100 x 10,00 € Kursgewinn =  1.000,00 €

Das Ergebnis lautet dann

Aktiva: 11.000,00 € = Eigenkapital 10.000,00 €
                    + Erträge       1.000,00 €

Posten- oder Los-Verwaltung

Wenn man nun aber mehrere Positionen eines Papiers zu unterschiedlichen Kursen erworben hat, beispielsweise werden

  • monatlich 50 € zum aktuellen Kurs angelegt,
  • Ausschüttungen thesauriert und
  • die Depotbank zur Deckung der Verwaltungsgebühren am Jahresende noch Anteile aus unserem Bestand zum jeweiligen Kurs verkauft,

wird die Sache schnell unübersichtlich.

In diesem Fall kann man einfach den Verkauf mit aktuellen Kursen buchen und korrigierende Ertragsbuchungen von GnuCash über Aktionen->Posten anzeigen->Konto überprüfen oder Aktionen->Überprüfen->... einfügen lassen. Gegebenenfalls werden dabei einzelne Buchungsteile in mehrere Posten oder Lose aufgeteilt.

In den Realisierter Gewinn/Verlust-Buchungen ist dann nur noch das zugehörige Ertragskonto auszuwählen. Das läßt sich am einfachsten realisieren, indem man das Konto [Erträge:]Unverknüpfte Gewinne-<Währung> löscht und dabei die Buchungen in das gewünschte Ertragskonto verschiebt.

Es bleibt allerdings noch die Frage offen, inwieweit die Zuordnungsstrategie den Erfordernissen deutschen Rechts entspricht. Unter anderem existieren folgende Verbrauchsfolgeverfahren:

  • Zuordnung nach Zeitpunkt des Erwerbs:
    • FiFo: First In - First Out, die logisch und technisch einfachste Variante, welche seit 2000irgendwas dem deutschen Privatanleger vorgeschrieben ist.
    • LiFo: Last In - First Out, bei Handelsgütern auf volatilen Märkten sinnvoll
  • Zuordnung nach Wert
    • HiFo: Highest In - First Out; in Deuschland wegen des [Niederstwertprinzips] ursprünglich die Regel,
    • LoFo: LOwest in - First Out.

Für seit 2009 erworbene Papiere ist steuerlich für Kursgewinne das in GnuCash implementierte FIFO vorgesehen. Im Zweifelsfall sollte man die Thematik mit seinem Steuerberater besprechen und die Buchungen entsprechend anpassen.

Handelskonten

Ab Version 2.3.x können auch die Handelskonten, zu aktivieren über Datei->Eigenschaften->Konten->Devisenhandels-Konten benutzen verwendet werden. Das Vorgehen dabei müßte noch mal jemand - ja genau, Du! - hier einfügen.

Sonstige Informationen, Speicherorte usw.

Online-Kursabfrage für ein Papier beenden

Wenn ein Papier seine Endfälligkeit erreicht oder es einen, da man es nicht mehr hält, nicht mehr weiter interessiert, sollte man die Online-Kursabfrage dafür abschalten.

Solange Papiere noch bei "Börsenkurse online abrufen" ein Häkchen haben, wird die Datenbank des Preiseditors (zu finden unter "Werkzeuge") mit jedem Klick auf "Kurse abrufen" im Preiseditor diese auch abrufen und in der Datenbank halten. Um das zu vermeiden, muss man die das Häkchen bei "Börsenkurse online abrufen" im Wertpapier-Editor wegmachen (auch unter "Werkzeuge" zu finden) oder

  1. darauf basierende Konten in der Kontenübersicht und
  2. die commodities im Aktieneditor und
  3. die Kurse im Preiseditor löschen.

Speicherorte

In der unkomprimierten Gnucash-Datei (in Bearbeiten, Einstellungen, Allgemein das Häkchen bei "Datei komprimieren" entfernen) findet man

  • die Definitionen von Wertpapieren und Währungen jeweils zwischen <gnc:commodity version="2.0.0"> und </gnc:commodity>
  • die Kurse jeweils zwischen <gnc:pricedb version="1"> und </gnc:pricedb>
  • die Posten oder Lose, welche lokal zum jeweiligen Konto sind, also in
<gnc:account version="2.0.0"> ... </gnc:account>
zwischen <act:lots> und </act:lots>.

Fehlersuche im Zusammenhang mit Finance::Quote

Wenn GnuCash meldet, dass es einen Kurs nicht aktualisieren kann, führt man am Besten die folgenden Schritte aus.

Stufe 1: gnc-fq-check

Zunächst sollte überprüft werden, ob FQ einwandfrei installiert ist.

Beispiel mit fehlerhafter Abhängigkeit
$ gnc-fq-check 
Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module) (@INC contains: /usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/site_perl/5.30.1 /usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl/5.30.1 /usr/lib/perl5/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl) at /usr/lib/perl5/vendor_perl/5.30.1/Finance/Quote/Tiaacref.pm line 33.
Compilation failed in require at (eval 303) line 1.
BEGIN failed--compilation aborted at (eval 303) line 1.
 at /usr/local/bin/gnc-fq-check line 91.
("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx" "australia" "bamosz" "bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada" "canadamutual" "citywire" "cominvest" "cse" "deka" "dutch" "dwsfunds" "europe" "fetch_live_currencies" "fidelity" "fidelity_direct" "fidelityfixed" "financecanada" "finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios" "ftportfolios_direct" "fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock" "indiamutual" "known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq" "nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares" "stockhousecanada_fund" "tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice" "troweprice_direct" "trustnet" "tsp" "tsx" "uk_unit_trusts" "ukfunds" "unionfunds" "usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia" "yahoo_australia" "yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
Der erste Teil weist auf das fehlende Perl-Modul Mozilla/CA.pm hin, während der Ausdruck in Klammern die FQ-Version und die verfügbaren Quellen ausgibt.
Nach unserem Kenntnisstand wäre Finance::Quote 1.63 aktuell.
Falls so eine Fehlermeldung kommt oder die installierte Version veraltet ist, siehe #Bei Formatänderung der Quelle: gnc-fq-update.

Stufe 2: gnc-fq-dump

Gerade, wenn man sich bezüglich eines Symbols nicht sicher ist, ist es schneller, seine Angaben mit

gnc-fq-dump [-v] <Quelle> <Kürzel1> [<Kürzel2> ...]

zu überprüfen als in GnuCash immer wieder eine Einstellung zu ändern und alle Kurse abzurufen. Weiterhin sieht man bei dieser Methode besser, wo der Fehler liegt. Da sie auch unvollständige Ergebnisse liefert, sieht man dann beispielsweise, ob Yahoo mal wieder das Format geändert hat oder das Symbol wirklich unbekannt ist.

Stufe 3: gnc-fq-helper

Leider gibt es auch Fehler, die sich bei der Verwendung von gnc-fq-dump vor den Augen des Benutzers verstecken, wie etwa ein angehängtes Leerzeichen. Falls also das Ergebnis von gnc-fq-dump sauber aussieht, GnuCash es aber "partout nicht fressen will", sollte man den für den Laien etwas gewöhnungsbedürftigen gnc-fq-helper verwenden. Am Beispiel der berühmten Unilever-Anleihe, die im September 2008 die Mailingliste unsicher machte, sieht der Aufruf und das Ergebnis dann so aus:

user@host:~$ echo '(yahoo_europe "A0GFY7.SG")' | gnc-fq-helper
(("A0GFY7.SG" (symbol . "A0GFY7.SG") (gnc:time-no-zone . "2008-09-26 16:58:00") (last . 89.50) (currency . "EUR ")))

Wer sieht den Fehler? Lösung

An Finance::Quote basteln

Wer nun neugierig geworden ist, wie Finance::Quote im einzelnen funktioniert, kann sich gerne die Module anschauen. Schließlich ist Perl eine Skript-Sprache, die man mit einem normalen Editor bearbeiten kann und nicht compilieren muss.

Bei opensuse liegen sie unter

/usr/lib/perl5/

. Die nächste Verzeichnisebene unterscheidet zwischen der mitgelieferten Version vendor_perl und einer eventuell mit gnc-fq-update oder cpan heruntergeladenen Version site_perl. Die nächste Ebene bezeichnet die Perl-Version, bevor man endlich in das Verzeichnis Finance kommt.

Bevor man sich die Mühe macht, Änderungen vorzunehmen und an das Projekt einzuschicken, ist es vielleicht sinnvoll, ein wenig auf den Projektseiten bei

GitHub,
CPAN (beide aktuell) und
sourceforge

zu stöbern, um zu sehen, ob dort bereits ein entsprechender Patch herumliegt und welche Arten von Änderungen nicht akzeptiert werden, weil sie etwa einen falschen Ansatz verfolgen.

Ebenso kann es sinnvoll sein, den Autor des Moduls, an dem man Änderungen vornehmen möchte, zu kontaktieren, um sich doppelte Arbeit zu ersparen. Selbiger steht meist irgendwo in den Kommentaren des jeweiligen Moduls.


Zurück zur Hauptseite