De/Referenz

From GnuCash
Revision as of 04:57, 10 September 2010 by Fell (talk | contribs) (→‎Vorlagen: Berichte, Kontenrahmen etc.: replace redundance by link)
Jump to: navigation, search

Zurück zur Hauptseite

Contents

Glossar


Support

Siehe linkliste hier.


Konten-Typen

für den Schnelleinsteiger

In GnuCash gibt es wie auch in der Buchhaltung 5 Haupt-Konto-Typen unter denen alle anderen Konto-Typen angelegt werden. Was man in anderen Finanzprogrammen als Kategorie versteht, heisst in GnuCash "Konto".

Die 5 wichtigsten Konten-Typen sind:

  • Aktiva: Aktivkonten dienen zur Erfassung von Gegenständen oder anderem Vermögen, das einen Wert hat.
  • Passiva: Passivkonten bezeichnen Schulden oder Verbindlichkeiten.
  • Aufwand: Aufwendungen jeder Art, zum Beispiel Lebensmittel, Kleidung, Steuern usw. Wird in Quicken als Kategorie bezeichnet.
  • Ertrag: Erträge jeder Art, die Sie z.B. durch Gehaltseinkünfte, Zinsen, Dividenden usw. haben. Wird in Quicken als Kategorie bezeichnet.
  • Eigenkapital: Eigenkapitalkonten werden verwendet, um die Eröffnungsbestände beim ersten Start von GnuCash oder zu Beginn einer neuen Buchungsperiode zu erfassen.


Für den Privatanwender ist das erst einmal verwirrend, deshalb gibt es hier eine Tabelle wie man die Kontoarten den Konten (Kategorien) zuordnet. Man sollte darauf achten, dass die Konten der ersten Ebene den fünf o.g. entsprechen.


Typen 1. Ebene Typen 2. Ebene
Aktiva
Bargeld
Aktienkonto
Bank
Investmentfonds
Forderung
Passiva
Verbindlichkeit
Kreditkarte
Aufwand
Ertrag
Eigenkapital


Herleitung

In diesem Abschnitt sollen einige grundlegende Begriffe des Rechnungswesens und die Zusammenhänge dazwischen kurz dargelegt werden. Er soll nur ein grober Abriss sein und kann keine vollständige Einführung ersetzen. In der wikipedia finden sich wesentlich genauere Definitionen und auch jede Menge Literaturhinweise. Weiterhin wird jegliche Haftung für die Anwendung hier erwähnter Konzepte ausgeschlossen.

Das T-Konto

To really obtain an isolated negative quantity, it would be necessary to cut off an effective quantity from zero, to remove something of nothing: impossible operation. How thus to conceive an isolated negative quantity? --Lazare Carnot, French mathematician and member of the Academy of Science, 1803.

Wenn man einen solchen Satz liest, aus einer Zeit, in der Napoleon mit dem Code Civil die Grundlagen des Bürgerlichen Gesetzbuchs in den deutschen Landen einführte, ist es schon erstaunlich, dass die europäischen Kaufleute seit Jahrhunderten einen Trick hatten, mit dem sich diese Unvorstellbarkeit trotzdem bewerkstelligen ließ: das T-Konto - kein Warenzeichen eines gewissen Telekommunikationskonzerns.

T-Konto
Soll Haben

In der obersten Zeile steht die Kontobezeichnung, welcher üblicherweise die Kontonummer vorangestellt wird. Darunter werden die Zugänge auf der einen, die Abgänge auf der anderen Seite aufgezeichnet. Welches wofür die richtige Seite ist, hängt davon ab, um welche Art Konto es sich handelt [s.u.]. Vor Einführung der "EDV" wurden derartige Konten üblicherweise auf T-förmig unterteilten Karteikarten geführt.

Da in einem Buchungssatz immer auf beiden Seiten die gleiche Summe eingetragen wird, ergibt sich, dass der Saldo aller Konten immer 0 ist.

Wer sich für die historische Details interessiert, kann ja mal einen Blick in Luca Pacioli's Summa de Arithmetica, Geometria, Proportioni et Proportionalità (Venedig 1494; Repro unter ISBN 88-317-6008-4) werfen, welches wohl die erste geschlossene Darstellung der Venetianischen Methode enthält.

Andere gebräuchliche Darstellungsformen im Rechnungswesen

Alternativ zum T-Konto ist etwa bei der GUV und der Bilanz die Staffelform (lat. scala: Treppe, Stufe) gebräuchlich. 

   Aktiva (Anlagevermögen +  Umlaufvermögen)
 + Passiva
 - Fremdkapital
 = Eigenkapital

Was wo häufiger anzutreffen ist, ist auch von regionalen Gepflogenheiten abhängig. Während man in Kontinentaleuropa eher zum T-Konto tendiert, scheint man im angelsächsischen Sprachraum die Staffelform zu bevorzugen.

Bestandskonten

Am Anfang und am Ende einer Buchführungsperiode, in der Regel das Geschäftsjahr, steht eine Bilanz - ital. 2 Lanzen = 1 Balkenwaage. Damit die Waage ausgewogen ist, müssen die Konten ausgeglichen sein. Die Zahlen hierfür kommen aus der Inventur, der Erfassung des Inventars, der Bestandsaufnahme.

Um hier nun auch Äpfel mit Birnen vergleichen zu können, werden beide in inländischer Währung bewertet. Darauf, welche Bewertungsprinzipien auf welche Kontengruppen anzuwenden sind, soll an anderer Stelle eingegangen werden.

Bilanz.de
Aktiva Passiva
(Kapitalverwendung) (Kapitalherkunft)
Anlagevermögen Eigenkapital
+Umlaufvermögen +Fremdkapital

Vertikal gliedert sich die Bilanz nach der Fristigkeit. Dies ermöglicht eine Beurteilung der Liquidität:

Wenn ich alles langfristig angelegt habe, aber kurzfristig fällige Verbindlichkeiten, habe ich ein Problem - zumindest bei gängigen Größenordnungen, denn McNamara sagte als Weltbankpräsident einmal:

Wenn Sie 1 Mio. Schulden haben, haben Sie ein Problem.
Wenn Sie 100 Mio. Schulden haben, hat ihre Bank ein Problem.

Bei der vertikalen Gliederung gibt es regionale Unterschiede zu beachten:

in Deutschland langfristig vor kurzfristig,
in der Schweiz und den USA beispielsweise umgekehrt.
Bilanz.ch
Aktiva Passiva
(Kapitalverwendung) (Kapitalherkunft)
Umlaufvermögen Fremdkapital
+Anlagevermögen +Eigenkapital

Da man nun aber nicht das ganze Jahr ständig in der Bilanz rumschmieren will, werden die einzelnen Positionen mit den Eröffnungsbuchungen in die Kontenklassen 0-1 beim SKR03, respektive 0-3 beim SKR04 aufgelöst.

Auf diesen Bestandskonten lassen sich alle erfolgsneutralen Buchungen tätigen. Das sind alle Buchungen, die keine Wertänderung bewirken, sondern den Wert nur zwischen 2 Bestandskonten verschieben.

Erfolgt die Verschiebung zwischen einem Aktiv- und einem Passivkonto, so spricht man auch von einer Bilanzverlängerung - die Bilanzsumme, also die Zahl, die auf beiden Seiten unter dem Strich steht, erhöht sich - oder um eine Bilanzverkürzung, wenn die Bilanzsumme dadurch kleiner wird,

Einige typische erfolgsneutrale Gründungsbuchungen:

  • Inhaberin bringt mit EUR X bewertetes Fahrzeug ein.
  • Teilhaber legt EUR Y in Kasse ein.
  • KFW stellt zinsgünstigen Gründerkredit auf Geschäftskonto zur Verfügung.
Typische Aktiv-Konten

Hier sind zunächst die meisten Konten, von denen Zahlungen getätigt werden. Also alle Barbestände wie Kasse und Urlaubskassen für Fremdwährungen, sowie die Girokonten, sofern sie im Haben sind.

Dazu kommen Finanzanlagen wie Sparbücher, Edelmetalle, Pfand- und Schatzbriefe, Aktien, Fonds, Derivate und kapitalbildende Versicherungen.

Weiterhin gehören hier auch die Sachanlagen wie Auto, Häuschen rein, sofern man sie berücksichtigen möchte oder muss, weil sie etwa mit einem Kredit in Zusammenhang stehen.

Typische Passiv-Konten

Hier gehören alle Kredite hin. Von der Hypothek aufs Häuschen über das von Oma geborgte Geld und den bei Tante Emma angeschriebenen Einkauf, sowie alles was man noch bei seinem Wirt auf dem Deckel oder Kerbholz hat, bis zum Girokonto, sofern es im Dispo (oder noch schlimmer überzogen) ist.

Obwohl man mit ihr bezahlen kann, fällt auch die Kreditkarte hierunter.

Erfolgskonten

Üblicherweise betreibt man zunächst einigen Aufwand um später zu einem Ertrag zu kommen. Ist am Ende der Buchführungsperiode der Ertrag größer als der Aufwand, spricht man vom Gewinn, andernfalls vom Verlust - oder allgemein vom Erfolg. Zur Ermittlung dieses Ergebnisses dient die Gewinn- und Verlustrechnung, kurz GuV, engl. Profit & Loss oder P&L.


Betrachtungsebenen im Rechnungswesen

Damit später keine Missverständnisse aufkommen, sollen kurz hier nun die verschiedenen Ebenen des Rechnungswesen und ihrer Begriffspaare betrachtet werden. Beginnen wir mit den juristischen Spitzfindigkeiten:

In dem Moment, in dem man als Käufer einen Kaufvertrag abschließt, tätigt man eine Ausgabe. Analog erzielt man als Verkäufer bei Abschluss eines Verkaufs[vertrages] eine Einnahme. Durch den Vertragsabschluss entsteht erst einmal ein beiderseitiges Schuldverhältnis, der Anbietende schuldet die Leistung und der Nachfragende die Zahlung. Also erst dann, wenn eine Zahlung erfolgt, entstehen daraus Auszahlung und Einzahlung. Wir befinden uns auf der Ebene der Finanz- oder Liquiditätsrechnung. Diese dient auch als Grundlage für die EÜR .

Aber erst in dem Moment, in dem man ein Wirtschaftsgut, also eine Ware oder Dienstleistung verbraucht, handelt es sich um Aufwand. In engem zeitlichem Zusammenhang entsteht zumeist ein Zwischen- oder Endprodukt, welches dann als Ertrag verbucht wird. Der Arbeitnehmer produziert etwa aus 8 Stunden Schlaf und einem guten Frühstück die Arbeitskraft, die er anschließend seinem Arbeitgeber zur Verfügung stellt. Wir befinden uns auf der Ebene der Gewinn- und Verlustrechnung, kurz GuV, die immer noch zum externen Rechnungswesen gehört, da unter Umständen Rechenschaft nach außen, etwa gegenüber dem Finanzamt, abgelegt werden muss.


Das folgende Beispiel ist zugleich ein Ausnahmetatbestand, da auch bei EÜR für höherwertige, langlebige Wirtschaftsgüter nur die Abschreibungen anzusetzen sind. Weiterhin sei ein steuerlicher Kleinunternehmer angenommen, der mit der MWSt. nichts am Hut hat.

Vorgang Ebene Zeitpunkt Betrag
Wir kaufen am 2. Januar eine PC für EUR 900,-- Ausgabe Januar 900,--
Der Händler räumt uns freundlicherweise ein Zahlungsziel von einem Monat ein, welches wir auch ausnutzen und einhalten. Auszahlung Februar 900,--
Der Gesetzgeber sieht eine Nutzungsdauer von 3 Jahren vor. Aufwand lfd. und die beiden folgenden Jahre jeweils 300,--


Wem das noch nicht reicht, der kann sich dann noch mit dem internen Rechnungswesen befassen. Dort wäre die nächste Stufe dann die Kosten- und Leistungsrechnung.

Da bleibt dann der neutrale Aufwand, wie etwa die Spende ans Rote Kreuz, außen vor, während die kalkulatorischen Kosten, wie etwa Unternehmerlohn oder kalkulatorische Abschreibungen, also Kosten, denen kein Aufwand in gleicher Höhe gegenübersteht, hinzukommen.

Dort werden dann zunächst Kostenarten wie etwa Wasser und Strom erfasst und nach verschiedenen Schlüsseln auf Kostenstellen wie etwa den verschiedenen Produktionsstätten umgelegt, um schließlich Kostenträgern, also den erzeugten Produkten zugeordnet zu werden.

Gewinnermittlungsmethoden

Ob aber ein Einkauf als Aufwand oder erfolgsneutral gilt, ist davon abhängig, welche Art der Gewinnermittlung man anwendet:

  • Ist-Besteuerung: In der Einnahmenüberschussrechnung, kurz EÜR, die für Freiberufler und kleine Gewerbetreibende in Frage kommt, wird vereinfacht die Ebene des Zahlungsflusses betrachtet. Der Name deutet an, dass die Steuern erst fällig sind, wenn der Kunde bezahlt hat. Diese Methode dürfte im übrigen auch für den Privatanwender hinreichend sein.
Das bedeutet anders ausgedrückt, dass die Offenen Posten (noch) nicht erfolgswirksam sind.
  • Soll-Besteuerung: In der Bilanzierung, die u. a. für Kapitalgesellschaften vorgeschrieben ist, entsteht der Aufwand u. U. erst beim Werteverzehr, also wenn etwa ein Rohstoff, durch Materialentnahmeschein belegt, in der Produktion verbraucht wird. Zuvor handelt es sich entweder um einen Aktiv-Tausch (liquide Mittel, etwa Bargeld, gegen Ware) oder um eine Bilanzverlängerung (Erhöhung von Warenbestand und Verbindlichkeiten), was in beiden Fällen erfolgsneutral ist. Der Name deutet an, dass die Steuern hier bereits fällig sind, wenn die Rechnung geschrieben wird, also der Kunde bezahlen soll.

Die Details dazu, welche Methode anzuwenden ist, findet man hier.

Typische Aufwands-Konten

Beim Privathaushalt wären das in erster Linie die Kosten für die Unterkunft und die Verpflegung, die je nach ausgeübten Tätigkeiten durch eine nahezu unbegrenzte Zahl weiterer Kosten ergänzt werden können.

Typische Ertrags-Konten
  • Bei abhängig Beschäftigten wäre das Ertragskonto per excellence das Gehalt, während es
  • beim Kapitalisten hingegen die Kapitalerträge Zinsen, Dividenden und realisierte Kursgewinne wären.
  • Der Großgrundbesitzer verbucht Mieten und Pachten,
  • das Unternehmen Umsatzerlöse,
  • der Freiberufler Honorare usw. usf.

Spezielle Kontentypen in GnuCash

Neben den oben hergeleiteten grundlegenden Kontentypen für Bestandskonten Aktiva [engl. Asset], Eigenkapital [engl. Equity], und bis 2.2.8 Passiva, danach Fremdkapital [engl. Liability],

sowie Erfolgskonten Aufwendungen [engl. Expense] und Erträge [engl. Income] gibt es in GnuCash noch einige spezielle Kontentypen.

"Online"-Konten

Die Mehrzahl der Spezialkonten dient dazu das Leben zu erleichtern, indem sie mit der Außenwelt kommunizieren, so dass nicht alles manuell eingegeben werden muss.

Kursabfragen

Bei den Kontentypen Investmentfonds [engl. Mutual Fund] und Aktienkonto [engl. Stock] werden Zusatzinformationen hinterlegt, die es ermöglichen, mittels Finance::Quote online die Kurse abzufragen.

Werden Konten anderen Typs in Devisen geführt, so ist auch deren Bewertung von Kursaktualisierungen mittels Finance::Quote betroffen, falls man das Merkmal bei der entsprechenden Fremdwährung aktiviert.

Online-Banking

Beim aktiven Kontotyp Bank [engl. bank account], ist es möglich, mittels verschiedener Module wie OFX für angelsächsische Länder oder HBCI für Deutschland diverse Online-Transaktionen wie Umsatzabfrage oder auch Online-Banking durchzuführen.

Ähnliches gilt für den passiven Typ Kreditkarte [engl. Credit Card].

Offene-Posten-Verwaltung

Die Kontentypen Forderungen [engl. A/Receivable, account receivable, A/R] und Verbindlichkeiten [engl. A/Payable, account payable, A/P] dienen dazu, im Geschäftsmodul die offenen Posten, also unbezahlten Rechnungen, zu verwalten. Die selbst geschriebenen werden als Forderungen erfasst, die erhaltenen als Verbindlichkeiten. Den Überblick behält man über die zugehörigen Berichte.

Einordnung der in GnuCash definierten Kontentypen

Nach der theoretischen Einführung soll hier nun eine Einordnung der in GnuCash definierten Kontentypen nebst englischer Originalbezeichnung in die Hierarchie erfolgen. 

(Bestandskonten:)
  Aktiva [engl. Asset, kann auch Anlagevermögen bedeuten]
    Bargeld [engl. Cash]
    Bank [engl. bank account]
    Forderungen [auch Debitoren, engl. A/Receivable, account receivable, A/R]
    Investmentfonds [engl. Mutual Fund]
    Aktienkonto [engl. Stock]
  (Passiva, als eigenständiger Typ nicht vorhanden)
    Fremdkapital (bis 2.2.8: Passiva) [engl. Liability]
      Verbindlichkeit[en] (offene, eingeforderte, auch Kreditoren)
                          [engl. A/Payable, account payable, A/P]
      Kreditkarte [engl. Credit Card]
    Eigenkapital [engl. Equity]
(Erfolgskonten:)
  Aufwendungen [engl. Expense]
  Erträge [engl. Income]
  Handelskonten [engl. Trading accounts] (ab 2.3.x, Konten für den Devisenhandel,
                                    deren Ergebnis noch nicht realisiert ist, also schwebt)

Von GnuCash automatisch angelegte Konten

Sicherlich wundert sich der eine oder die andere darüber, wenn in der Kontenübersicht Konten auftauchen, die sie nie im Leben angelegt haben. Das mag zunächst unheimlich erscheinen, lässt sich aber erklären.

Anfangsbestand

Dies Konto ist vom Typ Eigenkapital und wird angelegt, wenn man im Neue-Kontenhierarchie-Assistenten Anfangsbestände eingegeben hat. Dann dient es als Gegenkonto für die daraus generierten Eröffnungsbuchungen. Im Gegensatz zu den unten genannten Konten weist seine Existenz nicht auf einen Fehler hin, sondern auf gängige Praxis.

Ausgleichskonto

Das Ausgleichskonto wird angelegt, wenn man zu mindestens einem Teilbetrag einer Buchung kein Konto angegeben hat. Es existiert also mindestens eine Buchung, die noch ausgeglichen werden muss. Man hat also irgendwo die Doppelte Buchführung nicht konsequent umgesetzt und sollte die in dem Konto aufgeführten Buchungen noch berichtigen.

Ausbuchungskonto-<Währung>

Auch hier hat man einen Fehler gemacht, allerdings im Zusammenhang mit einer Fremdwährung.

Kontenrahmen

Spätestens infolge der Weltwirtschaftskrise wurde offenbar, dass eine gewisse Vergleichbarkeit zwischen verschiedenen Betrieben wünschenswert sei. Daher wurden erstmals durch den Reichskontenrahmen (RKR) von 1937 gewisse Vorgaben verbindlich gemacht.

Aufbau: Kontenklasse, -gruppe, -art

Gewöhnlich ist ein Kontenrahmen im Zehnersystem gegliedert. Dabei gibt die erste Stelle der Kontonummer die Kontenklasse, die zweite die Kontengruppe und ggf. die dritte die Kontenart an.

Kriterien

Zunächst sollen einige Kriterien erläutert werden, nach denen sich die verschiedenen Kontenrahmen klassifizieren lassen.

Verbandskontenrahmen und Standardkontenrahmen

Nach Gründung der BRD haben verschiedene Branchenverbände (Industrie, Groß- & Außenhandel ...) Kontenrahmen entsprechend ihren Erfordernissen entwickelt und ihren Mitgliedsbetrieben anempfohlen. So bietet ein Kontenrahmen

  • für den Handel viel Platz für verschiedene Warengruppen, jeweils mit den diversen Erlösschmälerungen (Rabatte, Boni, Skonti), während
  • verarbeitende Gewerbe selbigen für die Kostenrechnung (Kostenarten, -stellen, -träger) verwenden. Beispiele: GKR, IKR

Für kleinere Organisationen hat die DATEV als Genossenschaft selbstständiger Steuerberater verschiedene Standardkontenrahmen, kurz SKR, entwickelt.

Prozessgliederungsprinzip vs. Abschlussgliederungsprinzip

Die Grundstruktur der Bilanzierung wurde im § 266 HGB festgeschrieben. Kontenrahmen, die entsprechend aufgebaut sind, folgen dem Abschlussgliederungsprinzip. Beispiel: SKR04

Ein anderer, eher pädagogischer Ansatz ist die Gliederung der Konten anhand eines fiktiven Geschäftsjahres. Den bezeichnet man als Prozessgliederungsprinzip. Beispiel: SKR03

Im Prinzip enthalten beide aber dieselben Konten, lediglich deren "Hausnummern" sind verschieden.

Zugriff über Kontonummer oder Gliederung

Da es zur Zeit (noch) nicht möglich ist, per Knopfdruck zwischen Kontobezeichnung und Kontonummer als Auswahlkriterium umzuschalten. Gibt es einige Kontenrahmen, bei denen die Auswahl über die Kontobezeichnung und damit über die HGB-Gliederung erfolgt und andere, bei denen die Kontobezeichnung die Kontonummer enthält. Letztere eignen sich vor allem für Vollzeit-Buchhalter, die ihre Hausnummern aus dem ff kennen. Dagegen werden sich Nebenher-Buchhalter wohl schneller anhand der HGB-Gliederung zum gewünschten Konto durchhangeln.

In GnuCash enthaltene Kontenrahmen

Einige davon sind, wenn auch teilweise in abgespeckter Version, für GnuCash verfügbar. Da diese von Freiwilligen gepflegt werden, sind sie nicht unbedingt vollständig, aktuell oder gar fehlerfrei. Verbesserungen, Ergänzungen etc. sind daher jederzeit auf der deutschen GnuCash-Mailingliste willkommen.

Da die Kontenrahmen länderspezifisch sind, werden sie nur angezeigt, wenn das Programm mit den richtigen Ländereinstellungen gestartet wird.

AT - Austria/Österreich

Leider hat noch niemand den österreichischen Einheitskontenrahmen zur Publizierung bereitgestellt.

Übersicht: http://www.bmf.gv.at/Steuern/FAQHufiggestellteFragen/FragenzurSteuererklrung/EKR_Uebersicht.pdf

Literatur: http://www.bmf.gv.at/Steuern/FAQHufiggestellteFragen/FragenzurSteuererklrung/Kontenplan.pdf

Erläuterungen: http://www.bmf.gv.at/Steuern/FAQHufiggestellteFragen/FragenzurSteuererklrung/Kontenplan_Erl.pdf

CH - Schweiz

Ein chkmu ist in Gnucash enthalten.


DE - Deutschland

SKR03

Ein abgespeckter SKR03, auch für publizitätspflichtige Firmen, nach dem Prozessgliederungsprinzip, bei dem der Zugriff über die Kontonummer erfolgt, ist in GnuCash enthalten.

SKR04

Ein fast vollständiger SKR04, auch für publizitätspflichtige Firmen, nach dem Abschlussgliederungsprinzip, bei dem der Zugriff über die Gliederung nach HGB erfolgt, ist in GnuCash enthalten.

Alternativ gibt es einen nummernorientierten bei Erwin Rieger mit sehr interessanten Erweiterungen.

Literatur:

SKR49 Vereine, Stiftungen und Gemeinnützige GmbHs

Auflistung von Kontenrahmen

Hier sind einige Kontenrahmen aufgelistet.

Kontenrahmen Abkürzung verfügbar Land Beschreibung
SKR01 Standard Konten Rahmen nein DE ist für kleine Personengesellschaften geignet
SKR02 Standard Konten Rahmen nein DE ist für kleine Kapitalgesellschaften
SKR03 Standard Konten Rahmen 10% DE ist wie SKR01, aber stärker untergliedert nach dem Prozessgliederungsprinzip
SKR04 Standard Konten Rahmen 90% DE ist wie SKR02, aber stärker untergliedert nach dem Abschlussprinzip
SKR49 Standard Konten Rahmen 100% ab 2.2.9 DE für Vereine
SKR81 Standard Konten Rahmen nein DE für Ärtze
EKR Einzelhandel Konten Rahmen nein DE für den Einzelhandel
GKR Gemeinschafts Konten Rahmen der Industrie nein DE für den Großhandel
IKR Industrie Konten Rahmen nein DE für die Industrie

Wer noch mehr über Kontenrahmen wissen möchte, sollte sich die Seite von http://de.wikipedia.org/wiki/Kontenrahmen ansehen.

der nächste Kontenrahmen

Es geht das Gerücht um, dass man die verschiedenen Anlagen der Einkommensteuererklärung als Module implementieren könnte. Leider hat sich bisher noch niemand daran gewagt. Falls sich mal jemand an dem einen oder anderen Modul, vielleicht Lohnsteuer, versuchen möchte, kann er/sie/es sich ja mal zwecks Unterstützung vertrauensvoll an gnucash-de@gnucash.org wenden.

Einige kritische Betrachtungen

Dieser Abschnitt gehört sehr wahrscheinlich ganz woanders hin, die Problemstellungen, die hier beschrieben werden sollen, wurden aber beim Erstellen obigen Konzepts offenbar.

Lokalisierung ist mehr als Übersetzung

Gerade wenn es darum geht, Dinge zu bewerten, kann das nicht wertfrei geschehen. Werte sind aber wiederum abhängig von dem Kulturkreis, in dem man sich befindet. So ist beispielsweise in Europa das Rechtswesen der verschiedenen Staaten unterschiedlich stark durchdrungen von römischen Prinzipien im Süden und germanischen im Norden, Präzedenzrecht versus deduktivem Recht etc. pp. Diese Recht wirkt dann auch auf das Rechnungswesen ein. Die Mehrzahl der Entwickler lebt in einem Kulturkreis, für den die Prinzipien in den US_GAAP - United States Generally Accepted Accounting Principles festgelegt sind, die zum Teil im krassen Gegensatz zu den etwa in Deutschland geltenden Bestimmungen des HGB - Handelsgesetzbuchs stehen. Beispiel: Fair Value versus Niederstwertprinzip. Der Versuch eines Kompromisses findet sich in den IFRS - International Financial Reporting Standards. Daher sollte eines der Ziele in der Weiterentwicklung von GnuCash sein, eine Internationalisierung und teilweise auch eine Europäisierung zu erreichen. Letzteres soll bedeuten, dass EU-Richtlinien etwa zum Umsatzsteuerrecht ja für alle Mitgliedsstaaten gleichermaßen gelten und entsprechende eurokratische Floskeln wie

der Zeitpunkt der Lieferung oder sonstigen Leistung oder der Vereinnahmung des Entgelts oder eines Teils des Entgelts (wenn die Lieferung oder Leistung noch nicht ausgeführt ist), sofern dieser Zeitpunkt feststeht und nicht mit dem Ausstellungsdatum der Rechnung identisch ist

oder die gegenteilige Formulierung "Soweit nicht anders angegeben..." gleich in allen EU-Amtssprachen in die Templates Eingang finden, wobei Inter Active Terminology for Europe hilfreich sein könnte - diese Definition des Lieferdatums nur als Beispiel aus dem Richtlinientext, welche hoffentlich nie in der Form auf der Rechnung erscheinen muss.

Daten importieren und exportieren

In diesem Abschnitt werden alle Beiträge zum Import und Export der Buchhaltungsdaten gesammelt.

GnuCash kann andere Buchhaltungsdaten aus anderen Programmen nur importieren, wenn die Daten in den Formaten QIF oder OFX vorliegen. Ein Import aus einem anderen Buchhaltungsprogramm geht also nur, wenn diese andere Software eine Möglichkeit für "Export nach QIF" oder "Export nach OFX" anbietet. Was anderes geht leider nicht.

Seit Version 2.2.0 kommen noch die Möglichkeiten CSV, DTAUS und MT940 als Datenformat hinzu.

Wenn irgendwann in 2.4.x die AqBanking-Schnittstelle angepaßt ist, wird darüber eventuell auch noch ein generisches CSV-Importmodul verfügbar sein.

CSV nach QIF umwandeln

Comma separated values - durch Komata (oder Semikola) getrennte Werte - sind das allgemeinste Datenaustauschformat und werden auf vielen Webseiten zum Herunterladen der Umsatzdaten angeboten. Um sie nun in GnuCash zu importieren, kann man sie mit einer der beiden folgenden Methoden in das für Finanzdaten recht verbreitete QIF-Format umwandeln.

mittels Python-Skript

Die Email von Nils Andresen enthält csv2qif.py, einen csv-nach-qif-Konverter, den man verwenden kann, wenn Python auf dem verwendeten Computer installiert ist.

in der Tabellenkalkulation

Tabellenkalkulationsprogramme wie MS Excel oder Openoffice Calc können von Haus aus CSV-Dateien importieren. Mithilfe des Makros XL2QIF, respective CALC2QIF kann man dann daraus QIF-Dateien erstellen.

QIF Import

Falls beim Importieren von QIF-Dateien (z.B. aus Quicken, Wiso Mein Geld) Probleme auftreten, könnte vielleicht das Programm QIF-Cleaner (nur für Windows) helfen, die QIF-Datei vor dem Import noch ein bisschen an die QIF-Spezifikationen anzupassen. (Hat das jemand mal ausprobiert? ... die Seite ist leider mit einem Passwort geschützt)

Einfacher geht die Erstellung von QIF aus Excel oder Openoffice Calc mit dem Tool Calc2gif. Es ist als Makro ausgefuehrt, dass nach der Makroinstallation und Programmneustart verfuegbar ist. Aus einer geoeffneten Datei heraus kann dann fuer die markierten Bereiche spaltenweise angegeben werden, welche Daten enthalten sind und dies wird dann in ein QIF ueberfuehrt.

OFX Import

Um Umsätze in GnuCash zu importieren bietet sich das Format OFX für alle die an, die nicht HBCI nutzen. Im Gegensatz zum QIF Import kann GnuCash hier erkennen, welche Umsätze es schon importiert hat und welche nicht. OFX Import wird z.B. von der 1822direkt im HTML-Banking unterstützt. Ein Demo-Login ist unter https://banking.1822direkt.com möglich.

XML Export

Im Moment gibt es in GnuCash keine Export-Funktion der Buchungsdaten. Aber für manche gewünschten Export-Formate könnte es auch genügen, die XML Datei entsprechend weiterzuverarbeiten. Ein XSLT-Stylesheet für den Export nach Gnumeric gibt es hier: http://xslfactory.free.fr/

Wer dafür eine Java-Bibliothek zum Lesen und Schreiben von gnucash-Dateien (mit swing-widgets, taglib,... für eigene komplette Programme) braucht kann mal auf http://apps.sourceforge.net/mediawiki/jgnucashlib/index.php?title=Main_Page schauen (benutzt z.B. für den Rechnungs-Export nach einer Openoffice-Vorlage, automatische Rechnungs-Erzeugung in die gnucash-datei aus der eigenen Stunden-Erfassung, Buchungsimport aus CSV-Dateien der nicht-HBCI-Bank,... )

Gnucash Datei in CSV umwandeln

Mit einer XSLT-Transformation kann man aus den XML-Dateien von GnuCash auch CSV erzeugen. Wie das geht beschreibt Jason unter: GnuCash export to gnumeric and CSV

GnuCash Datei in QIF umwandeln

Unter http://gnucashtoqif.sourceforge.net/ findet sich ein Java Programm, mit dem GnuCash XML-Dateien in QIF umgewandelt können.


Wertpapierkurse / Maschinelle Kursabfrage mit GnuCash

Das ausführliche Kapitel zur automatischen Wertpapier-Kursabfrage in GnuCash befindet sich auf der Unterseite Aktienhandel.

Online-Banking

Debuglevel für Aqbanking einschalten

für linux

GnuCash-2.2.9: Dazu muss man die Umgebungsvariable AQBANKING_LOGLEVEL auf den Wert "debug" setzen.

  1. ein terminal-fenster öffnen
  2. export AQBANKING_LOGLEVEL=debug
  3. gnucash

Die debug-info wird nun in das terminal-fenster geschrieben.

GnuCash-2.3.x: Die genannte Umgebungsvariable wird innerhalb von gnucash nochmal verändert. Entscheidend ist jetzt nur noch, ob man das Häkchen unter Einstellungen -> Online Banking -> Ausführliche Debug-Meldungen aktiviert hat oder nicht.

Aqbanking errors und was sie bedeuten

Dazu gibt es auch sehr umfangreiche Dokumente (768 Seiten), herausgegeben vom Zentralen Kredit-Ausschuss der deutschen Banken.


Code Text Erklärung
0010 Nachricht/Auftrag angenommen auch "Nachricht entgegengenommen"
0020 Ausgeführt auch "Information fehlerfrei entgegengenommen"
0100 Dialog korrekt beendet Nachricht/ Auftrag angenommen
3010 Ansonsten bedeutet der HBCI-Code 3010 keinen Fehler, sondern lediglich eine Benachrichtigung über die Aktualisierung mancher interner Daten
3050 Die BPD wird aktualisiert
3060 Teilweise liegen Warnungen oder Hinweise vor
3900 Kein Umsatz gem. Suchbegriff vorh.
3920 Nur Zwei-Schritt-TAN-Verfahren zulaessig
9010 Geschäftvorfall nicht bearbeitet
9050 Teilweise fehlerhaft
9230 Auftrag nicht ausgeführt, da Limit überschritten.
9380 Signaturberechtigung für diesen Kunden unzulässig auch "Benutzer hat keine Auftragsberechtigung"
9800 Abgebrochen
9955 Ein-Schritt-TAN-Verfahren nicht zugelassen

Banken mit Online-Banking

  • VR Bank Rhein-Neckar (BLZ 67090000).
  • Postbank-HBCI-Daten:
    • Benutzerkennung = Kontonummer
    • Die Kontonummer ohne führende Null(en) eingeben.
    • Kunden-ID = ebenfalls die Kontonummer eingeben.
    • PIN ist die gleiche, die im BTX verwendet wird. (Die PIN muss 5-stellig sein, es wird nicht die PIN von Posbank direkt benutzt.
    • Bei der Postbank gibt es eine Besonderheit: über die Internetseite ist eine sechsstellige PIN zulässig - über FinTS (HBCI) PIN/TAN nur eine fünfstellige PIN.)
    • HBCI-Version 2.2
    • Kommunikationsadresse: https://hbci.postbank.de/banking/hbci.do
    • Um beim "Get System Id" nicht einen Timeout Fehler zu bekommen muss man moeglicherweise unter "Special Settings" umstellen auf "HTTP 1.1" und sowohl "Force SSLv3" als auch "No BASE64 Encoding" einschalten.

Online-Kursabfrage mit FinanceQuote

Liste der Kursquellen

Name Dienst Website für Symbolsuche
aex,

aex_futures, aex_options, dutch

Euronext Amsterdam, NL http://www.aex.nl
australia Australian Stock Exchange, AU
deka Deka Investmentfonds (Sparkassen), DE https://www.deka.de/decontent/index.jsp
dwsfunds Deutsche Bank Gruppe Fonds, DE http://dws.de/DE/products/FundFinder.aspx
fidelity Fidelity Investments, US http://www.fidelity.de/funds/kurse.html
tiaacref TIAA-CREF (Lehrer-Pensionsfonds), US http://www.tiaa-cref.org
troweprice T. Rowe Price, US http://corporate.troweprice.com
europe European Markets, EU asegr, bourso, hex, ...
canada Canadian Markets, CA
nasdaq,

nyse, usa

NASDAQ, New York Stock Exchange, AMEX: USA Markets

vom kunterbunten Narren Motley Fool, US

http://quote.fool.com, http://www.fool.com
uk_unit_trusts UK Unit Trusts, UK
unionfunds Union Investment Fonds (Volks- & Raiffeisenbanken), DE [1], Name und Symbol unter [2]
vanguard Vanguard Investments, US http://www.vanguard.com/
vwd Vereinigte Wirtschaftsdienste GmbH, DE Achtung, aus juristischen Gründen original, deutsch wird das Modul nicht mehr gepflegt! http://www.vwd.com/vwd/markt.htm
weitere Module:
aiahk American International Assurance, HK http://www.aia.com.hk
amfiindia,

indiamutual

Association of Mutual Funds India, IN http://amfiindia.com/navreport.asp

Symbolliste

asegr Athens Stock Exchange (ASE), GR http://www.ase.gr/content/en/MarketData/Stocks/Prices/Share_SearchResults.asp?
bmonesbittburns BMO NesbittBurns Quitre Qote, CA: Most Canadiam and US stocks as well as Canadian Mutual Funds http://bmonesbittburns.com/QuickQuote/QuickQuote.asp
bourso,

france

Paris Stock Exchange über boursorama, FR http://www.boursorama.com/recherche/recherche.phtml
lerevenu,

france

Paris Stock Exchange über lerevenu, FR http://bourse.lerevenu.com
financecanada,

canada

finance.canada.com, CA: Canadian Stock and Mutual Funds http://finance.canada.com
ftportfolios First Trust Portfolios, US http://www.ftportfolios.com
fundlibrary,

canadamutual

www.fundlibrary.com, CA: Canadian Mutual Fund http://www.fundlibrary.com/
hex,

finland

Helsinki Stock Exchange (HEX), FI http://omxgroup.is-teledata.com/html/securitypricelistequities.html,

http://www.hex.com/

maninv Man Investments Australia, AU http://www.maninvestments.com.au/
nz, nzx New Zealand stock exchange, NZ http://www.nzx.com/
platinum Platinum Asset Management, AU http://www.platinum.com.au/docs/pricing.htm
seb_funds Skandinaviska Enskilda Banken Fonds, SE http://www.seb.se/pow/borsfinans/fondkurslista/kurslista.asp
yahoo[_europe ?] Yahoo http://de.finance.yahoo.com/

Herkunft:

  • perldoc Finance::Quote
  • fq-dump listet noch viel mehr Dienste. Wer also genaueres zu den nicht aufgeführten herausfindet, möge diese Tabelle bitte ergänzen. In den einzelnen Perl-Modulen stehen am Schluss meist Erläuterungen.
  • Frage: wäre alphabetische oder regionale oder sachliche (Aktien, Fonds, Drittanbieter, ...) Sortierung sinnvoller als die historische?


Tips:

  • Ein Symbol der Form aaabbb=X liefert, zumindest bei Yahoo, den Wechselkurs zwischen den Währungssymbolen aaa und bbb.
  • Auf unixartigen Systemen gibt es seit FQ 1.15 man pages in Abschnitt 3p, welche man beispielsweise mit 
man Finance::Quote::AEX

aufrufen kann.

  • Wenn man auf der Suche nach dem richtigen Symbol ist, wird man oft auch durch googlen fündig.

Welche Einstellungen GnuCash verwendet und wo sie gespeichert werden

Dieser Abschnitt dient verschiedenen Zwecken:

  • Welche Annahmen macht GnuCash beim Start, und wie lassen die sich beeinflussen?
  • Welche Verzeichnisse und Dateien sollten kopiert werden, wenn man auf einen anderen Rechner umzieht, bzw. in einem Backup berücksichtigt werden?
  • Wo befinden sich die Vorlagen, falls man Anpassungen vornehmen möchte?

Konfigurationsvariablen

Was und wohin wird installiert? Auf diese Variablen hat der normale Anwender keinen Einfluß, diese hat der Maintainer des Paketes bzw. Distributor im ./configure-Befehl festgelegt. Es kann aber ganz nützlich sein, schon einmal davon gehört zu haben, da es die Suche nach Dateien, etwa um Berichte anzupassen.

Beispiel: $PREFIX legt gewissermaßen die Wurzel des Teilbaumes fest, in den Dateien installiert werden. Der Standardwert hierfür ist

  • beim Selbstkompilieren /usr/local/<Paketname>,
  • bei Distributionen ursprünglich /usr/share/[<Desktop>/]<Paketname>.
  • Bei *Suse < 11.x war es aber für GnuCash /opt/gnome/gnucash.

Hierzu gehört auch die Festlegung, ob

  • Aqbanking (deutsches Onlinebanking)
  • OFX (Datenimport für den Rest der Welt ;-))
  • DBI (SQL-Datenbankunterstützung ab 2.3.x)

verfügbar ist oder nicht.

Umgebungsvariablen

Beim Start wertet Gnucash zunächst verschiedene Umgebungsvariablen aus. Für den "normalen Benutzer" die wichtigste ist LANG, durch welche die länderspezifischen Einstellungen Sprache, Währung, Datum- und Zeitformat, sowie Vorlagen für Berichte und Kontenrahmen bestimmt werden. Wie diese Variable zu setzen ist, ist vom verwendeten Betriebssystem abhängig.

Das Verzeichnis $HOME/.gnucash (GNC_DOT_DIR)

Traditionell speichern Linux-Programme vom Benutzer individuell anpassbare Einstellungen in einem verborgenen Verzeichnis - daher der Punkt vor dem Namen - mit dem Namen des Programms im Heimatverzeichnis des Benutzers.

Unter Windows bis XP entspräche das wohl C:\Dokumente und Einstellungen\MeinName\Lokale Einstellungen\..., ab Vista C:\Users\myname\AppData\Local\.... Und unter MacOS?

Anpassungen an Vorlagen, die über die Optionen des Programm erfolgen, speichert Gnucash dort. So befinden sich die benutzerdefinierten Berichte in der Datei $HOME/.gnucash/saved-reports-<version>.

Dieser Pfad läßt sich durch das Setzen der Umgebungsvariablen GNC_DOT_DIR verändern , etwa: <code'>GNC_DOT_DIR=~/test/.gnucash gnucash <weitere Parameter></code>

Dadurch ist es beispielsweise möglich, für geschäftliches, privates und Programmierung verschiedene Konfigurationen zu verwenden. Allerdings sollte man beachten, daß für einige Einstellungen gconf zuständig ist.

gconf (GNOME configuration database)

Einstellungen, welche insbesondere die äußere Erscheinungsform von GnuCash betreffen wie

  • Fenstergröße
  • Spaltenanordnung
  • Voreinstellungen von Dialogen
  • Einstellungen für Warnungen

werden, wie bei anderen Programmen des Gnome-Desktops, mithilfe des GConf-Daemons, gewissermaßen einem Gegenstück zur Windows-Registry, im Schlüssel </apps/gnucash/> und seinen Unterverzeichnissen wie

<./history/> Zuletzt geöffnete Dateien
<./file0> aktuelle Datei

gespeichert.

Physikalisch liegen diese in $HOME/.gconf/apps/gnucash/ und eigentlich sollte man die Änderung GnuCash überlassen. Falls man aber - aus welchen Gründen auch immer - doch mal Änderungen daran vornehmen wollte, sollte man die besser mithilfe von dem CLI 

gconftool-2

oder dem GUI 

gconf-editor

durchführen, welches sogar übersetzte Hinweise zur Bedeutung der Einstellungen hat.

Wer meint, trotzdem diese Dateien anderweitig bearbeiten zu müssen, sollte hinterher der GConf-Daemon neu starten, um ihm die Änderungen bekannt zu machen.

Vorlagen: Berichte, Kontenrahmen etc.

Falls man das Bedürfnis hat, weitergehende Änderungen an den Vorlagen vorzunehmen, so findet man sie in der Regel unter dem gnome-Order in den Unterordnern des gnucash-Verzeichnisses.

Wo der Gnome-Ordner liegt ist von Distribution zu Distribution verschieden. Mögliche Anlaufstellen sind etwa

/opt/gnome/ oder
/usr[/local]/share/gnome.

Falls man Änderungen an den Dateien vornimmt, sollte man Das geänderte Formular vor dem Update schützen beachten.

Wie man einen Fehler meldet oder einen Verbesserungsvorschlag einreicht

Ein paar allgemeine Empfehlungen

Da die Problematik der Fehlermeldung ja viele Projekte gleichermaßen betrifft, wird den Anwendern zunächst die Lektüre der beiden folgenden, teils recht unterhaltsamen Dokumente wärmstens empfohlen:

Obacht, jene Seiten bieten KEINEN SUPPORT für GnuCash, daher bitte weiterlesen.

Die verschiedenen Meldungsebenen des Programms

GnuCash versucht auf verschiedenen Ebenen mit dem Benutzer zu kommunizieren. Während für das Tagesgeschäft die Ausgaben der Programmoberfläche reichen, sind bei Fehlermeldungen häufig die Ausgaben der Anderen erforderlich.

Die Programmoberfläche

Normalerweise kommuniziert GnuCash über seine Benutzeroberfläche mit dem Benutzer durch Hinweise in der Statuszeile, Dialog- oder Meldungsfenstern. Falls dort eine unbefriedigende Fehlermeldung erscheint wie "Beim Lesen der Datei »/Pfad/Name« ist ein Fehler aufgetreten.", sollte der nächste Punkt versucht werden.

Die Ausgaben auf der Konsole

Wenn man das Programm nicht über das Start-Menü aufruft, sondern in einem Befehlsfenster, erscheinen dort zusätzliche Informationen. Meist sollte man zumindest diese Informationen bereithalten, wenn man einen Fehler melden möchte. In unserem Beispiel könnte hier etwa als Grund "Datei nicht gefunden", "Zugriff abgelehnt" oder ... stehen.

Wie öffnet man nun so ein Befehlsfenster?

  • Gnome: Rechner->Anwendungen->Weitere Anwendungen->System->Terminal,
  • KDE: K-Menü->System->Terminals->Konsole,
  • MacOSX: [bitte ergänzen] und
  • Windows: Start->Alle Programme->Zubehör->Eingabeaufforderung.

Falls man des Englischen einigermaßen mächtig ist, empfiehlt es sich insbesondere dann, wenn man vorhat, einen Bugzilla-Eintrag zu erstellen oder ergänzen, das Programm gleich auf Englisch mit 

LANG=C gnucash [--log ...] [--logto ...] [--debug|--extra]

zu starten, um Fehler bei der Rückübersetzung der Meldungen zu vermeiden.

"Der Wodka war gut, aber das Steak war gammlig." soll ja seinerzeit das Ergebnis der ersten maschinellen Rückübersetzung von "Der Geist war willig, aber das Fleisch war schwach." gewesen sein.


Manchmal reicht aber auch das nicht, dann geht's zum nächsten Punkt.

Die normale GnuCash Protokoll-Datei .trace

GnuCash schreibt während jedem Programmdurchlauf eine Protokolldatei "gnucash.trace", genannt "Trace-Datei". In vielen Fehlersituationen wird die ausführliche Information zu dem vorliegenden Fehler in diese Prokolldatei geschrieben. Deshalb brauchen die Entwickler in einem Fehlerbericht häufig als erstes den Inhalt dieser Protokolldatei. (Siehe auch die englische Seite "Tracefile".)

Zum Auffinden der Protokolldatei: Sofern die Standardeinstellung nicht durch --logto <PfadName> geändert wird, wird diese an folgendem Ort angelegt:

  • Linux/BSD/*nix: /tmp/gnucash.trace
  • Windows
    • bis XP: C:\Documente und Einstellungen\MeinName\Lokale Einstellungen\Temp\gnucash.trace.XXXXX
    • ab Vista: C:\Users\myname\AppData\Local\Temp\gnucash.trace.XXXXX
Die Zeichenkette "XXXXXX" sind sechs zufällig wechselnde Buchstaben. Anhand des Änderungsdatum muss man jene Datei heraussuchen, die beim Auftreten des Fehlers erstellt wurde.
  • MacOS: [Liebe Apfel-Benutzer, bitte ergänzen]

Die Datei variiert stark in der Größe - wenige Zeilen oder viele Megabyte können beide vorkommen. Die Datei besteht aus einfachem Text und kann in jedem Texteditor betrachtet werden.

Falls gewünscht, kann man die Auswahl der dort protokollierten Informationen genauer einstellen. Ein Beispiel und weitere Details wie Loglevel und Module finden sich auf der englischen Seite "Logging" oder auch in der technische Dokumentation. Falls man nun das Programm immer wieder mit denselben Einstellungen starten möchte, ohne sie jedesmal auf der Befehlzeile neu eingeben zu müssen, kann man die entsprechenden Optionen auch in einer Datei ~/.gnucash/log.conf ablegen.

Die unkomprimierte Gnucash-Datei

Bisweilen kann es auch hilfreich sein, einen Blick in die unkomprimiert gespeicherte Gnucash-Datei zu werfen. Dafür ist vor dem Speichern unter Bearbeiten->Einstellungen->Allgemein das Häkchen bei "Datei komprimieren" zu entfernen.

Falls man vergessen hat, wo die Datei gespeichert wird, kann man das durch Öffnen des Dialogs "Datei->Speichern unter" in Erfahrung bringen.

In Fehlerberichten ist es zuweilen sinnvoll, eine möglichst kleine Beispieldatei anzuhängen, mit deren Hilfe das Problem nachvollzogen werden kann. In einigen ganz seltenen Fällen tritt aber das Problem auf, daß ein Fehler in der eigenen Datei vermutet wird, sich jedoch nicht ohne Weiteres reproduzieren läßt. Bevor man nun seine ganzen persönlichen Finanzdaten an eine relativ fremde Person weitergibt, sollte man die Daten verschleiern, ohne die Struktur der Datei zu verändern. Dazu gibt es auf der englischen Seite ObfuscateScript ein Perl-Skript, welches man auf die zu verschickende Kopie anwenden kann, um das zu bewerkstelligen. Da Perl bei Linux-Distributionen zum Lieferumfang gehört, wird für Windows-Benutzer auf die möglicherweise noch erforderliche Installation verwiesen.

Der Stacktrace

Wenn es einen Programmabsturz gegeben hat, ist die wichtigste Information für die Entwickler ein Stacktrace (auch genannt Call Stack), die Abfolge der Funktionsaufrufe im Programm. Wenn irgend möglich, sollte man bei einem Programmabsturz versuchen, diesen Stacktrace zu bekommen und mit einzuschicken. Dafür muss man GnuCash im Debugger gdb ausführen. Die Anleitung dazu steht auf der englischen Seite "Stack Trace".

Die Recherche: Ist der Fehler bereits bekannt?

Da man ja nicht der einzige GnuCash-Benutzer ist, gibt es eine recht hohe Wahrscheinlichkeit, dass vor einem selbst schon jemand anderes auf das gleiche Problem gestoßen ist und unter Umständen ein – wie auch immer gearteter – Lösungsweg gefunden wurde.

Der schnelle Weg: Rückfrage im Chat

Falls man sein Problem knapp und fließend auf Englisch beschreiben kann, findet man im Chat auch meistens jemanden, der einem helfen kann, zu entscheiden, ob es sich wirklich um einen Programmierfehler oder ein Verständnisproblem handelt.

Suche in Mailinglisten

Auch die Suche in den GnuCash-Mailinglisten oder mit Google oder einer anderen Suchmaschine kann hilfreich sein - wahrscheinlich ist schon jemand anderes zuvor über das Problem gestolpert. Und in der Zeit, in der Entwickler Fragen beantworten, können sie nun mal nicht entwickeln.

Suche im BugZilla

Bugzilla ist das Verzeichnis der Fehlermeldungen und Verbesserungsvorschläge des Gnome Projekts. GnuCash wird dort als eigenes Produkt geführt.

Besonders, wenn man nicht die aktuellste Version verwendet, ist es sinnvoll, in einem 2. Durchgang die Einschränkungen des bug_status rauszunehmen, da der Fehler inzwischen behoben sein könnte.

Endlich: Fehler oder Verbesserungsvorschlag melden oder kommentieren

Häufig ist die Untersuchung von Fehlerberichten recht mühsam, weil der Berichterstatter für ihn selbstverständliche Informationen nicht mitliefert - Wieso, ich arbeite doch immer unter Betriebssystem XYZ, gibt's da etwa auch noch andere?. Trifft er damit auf einen gutgelaunten Freiwilligen, dann fragt der nach. Ist der selber gerade im Stress, wird die Meldung unter Umständen sogar ignoriert.

Daher sollte der Bericht möglichst alle der folgenden Angaben enthalten:

  • Ich benutze Gnucash Version <x.y.z> unter <Distribution> <a.b/Codename> <Betriebssystem> [<Version>] [mit Servicepack <j>] [mit den <relevante Zusatz>-Paketen aus dem Repositorium <wunderbar>].
  • Wenn ich, nachdem ich <dies und das> gemacht habe, <Menü><Untermenü><Menüpunkt> öffne, <erscheinen kleine grüne Männchen>.
  • Ich hätte aber erwartet, dass <Engelchen Halleluja singen>.

Der Inhalt der <spitzen> Klammern ist dabei natürlich durch zutreffende Angaben zu ersetzen.

Zum Herausfinden der verwendeten Versionen gibt es, wie in den meisten modernen Programmen,

  • den Menüpunkt Hilfe->Über, sowie
  • die Befehlszeilenoptionen
    • -v als Abkürzung für
    • --version.

Falls man das Programm selbst gebaut hat, ist auch die genaue SVN-Version wichtig, da sich der Inhalt des Subversion-Repositorium ja sehr schnell ändern kann.

Oft ist es auch hilfreich, das Programm statt über das Startmenü oder eine andere Verknüpfung, direkt in einem Terminalfenster zu starten und das, was es dorthin schreibt, zu analysieren oder als Anhang mitzusenden.

In BugZilla

Bugzilla dient der Verwaltung von Fehlern und Verbesserungsvorschlägen.

Zunächst sollte man die dortige Suche verwenden, um herauszufinden, ob der Fehler schon bekannt ist.

Falls der Fehler schon bekannt ist, kann man durch weitere Kommentare die Informationen ergänzen, etwa "Der Fehler tritt nur bei abnehmendem Mond auf, nie bei zunehmendem". Damit hilft man den Entwicklern, den Fehler einzugrenzen. Am Besten ist es natürlich, gleich einen Patch einschicken. ;-)

Falls er noch nicht bekannt ist, meldet man ihn, am allerbesten auf Englisch, und zwar unter:

Auf der Mailingliste

Wer mit dem Englischen Probleme hat, kann auch auf der deutschen Mailing-Liste anfragen, ob jemand mit dem Übersetzen helfen kann. Dafür ist wegen der Spammer allerdings eine Anmeldung erforderlich.

Hier sollten auch Verbesserungen an spezifisch deutschsprachigen Komponenten wie Kontenrahmen und Übersetzung von Programm-Meldungen oder Dokumentationen eingereicht und diskutiert werden.


Zurück zur Hauptseite

Retrieved from "https://wiki.gnucash.org/wiki/index.php?title=De/Referenz&oldid=6573"