18.1. Importieren von Lieferanten- und Kundenrechnungen

18.1.1. Grundsätzliches

Diese Funktionalität erzeugt Lieferanten- und Kundenrechnungen aus einer CSV-Importdatei die Zeilen von Rechnungseinträgen enthält. Die Importdatei kann Zeile für neue und oder bestehende Rechnungen enthalten. Falls ein Rechnung bereits existiert, GnuCash fügt die importierten Einträge zur Rechnung hinzu (es sei denn, die Rechnung ist bereits gebucht). Wenn die Importdatei Buchungsdaten für eine Rechnung enthält, dann wird GnuCash auch versuchen, diese Rechnung zu buchen. Falls irgendeine Zeile der Rechnung einen Fehler enthält, wird GnuCash alle Zeile der gleichen Rechnung ignorieren.

Der Trennzeichen für die Felder in der CSV-Datei muss entweder ein Komma oder Semikolon sein; Feldwerte können in doppelte Hochzeichen eingeschlossen sein.

Aus Gründen der besseren Lesbarkeit wird in diesem Kapitel der Begriff Rechnung sowohl für Kundenrechnungen wie auch Lieferantenrechnungen verwendet.

18.1.2. Aufbau der Importdatei

Die Importdatei sollte Zeilen mit Rechnungsdaten enthalten, jede markiert durch eine Rechnungs-Nummer. Die Datei sollte nach der Rechnungs-Nummer sortiert sein. Jede Zeile enthält Kopf- und Eintragsfelder, aber GnuCash übernimmt die Rechnungskopfdaten aus der ersten Zeile zu einer Rechnungsnummer. Für Informationszwecke können die Kopfdaten für jede nachfolgende Zeile derselben Rechnung wiederholt werden.

Die Datei enthält keine Information darüber, ob es Daten zu Kunden- oder Lieferantenrechnungen enthält. Stattdessen erfolgt die Unterscheidung über eine Benutzeroption im Importdialog.

Jede Zeile sollte die unten aufgeführten Felder in derselben Reihenfolge enthalten, getrennt durch Komma oder Semikolon. Die Felder sind hier mit ihren technischen Namen aufgeführt, welche GnuCash in der Vorschau der Importdaten verwendet.

  • Nummer - Die Rechnungsnummer. Pflichtfeld. Jede Zeile ohne Rechnungsnummer wird ignoriert. Falls die Rechnungsnummer bereits existiert, wird GnuCash die Einträge zur existierenden Rechnung hinzufügen (es sei denn, die Rechnung ist bereits gebucht).

  • Eröffnungsdatum - Verwenden Sie das gleiche Datumsformat wie in den Einstellungen definiert. Standardwert ist das Tagesdatum, falls das Feld nur Leerzeichen enthält oder das angegebene Datum ungültig ist.

  • Mandant-Nr - Kunden- oder Lieferantennummer. Pflichtfeld in der ersten Datenzeile einer Rechnung. Falls es nicht angegeben ist, werden alle Zeile derselben Rechnung ignoriert.

  • Rechnungs-Nr - Zahlungsnummer. Optional.

  • Bemerkungen - Rechnungsbemerkungen. Optional.

  • Datum - Das Datum des Eintrags. Es wird das Tagesdatum verwendet falls das Feld nur Leerzeichen enthält oder das angegebene Datum nicht gültig ist.

  • Beschreibung - Beschreibung. Optional.

  • Aktion - Aktion. Optional.

  • Konto - Konto für den Eintrag. Pflichtfeld in jeder Zeile. Falls nicht angegeben oder ungültig, werden alle Zeilen derselben Rechnung ignoriert.

  • Anzahl - Anzahl. Standardwert ist 1 falls das Feld nur Leerzeichen enthält.

  • Preis - Preis. Pflichtfeld in jeder Zeile. Falls nicht angegeben, werden alle Zeilen derselben Rechnung ignoriert.

  • Rabatt-Art - Art des Rabattes. Optional. Nur für Kundenrechnungen relevant, nicht für Lieferantenrechnungen. Verwenden Sie% oder ein Leerzeichen für Prozentwerte, alles andere für Geldbeträge.

  • Rabatt-Berechnung - Art der Rabatt-Berechnung. Optional. Nur für Kundenrechnungen relevant, nicht für Lieferantenrechnungen. Verwenden Sie >, wenn der Rabatt auf den Betrag nach Steuern angewendet wird, =, wenn sowohl Rabatt als auch Steuer auf den Vorsteuerwert angewendet wird, und <, ein Leerzeichen oder ein anderes Zeichen, wenn der Rabatt auf den Betrag vor Steuern angewendet wird.

  • Rabatt - Betrag oder Prozentsatz des Rabattes. Optional. Nur für Kundenrechnungen relevant, nicht für Lieferantenrechnungen.

  • Steuerwirksam - Ist der Eintrag steuerwirksam? Optional. Verwenden Sie J oder X für Ja, N oder ein Leerzeichen für Nein.

  • Inklusive Steuern - Ist die Steuer im Artikelpreis enthalten? Optional. Verwenden Sie J oder X für Ja, N oder ein Leerzeichen für Nein.

  • Steuersatz - Steuersatz. Optional. Falls der angegebene Steuersatz nicht vorhanden ist, wird es in der Rechnung leer bleiben.

  • Buchungsdatum - Buchungsdatum. Optional. Verwenden Sie das gleiche Datumsformat wie in den Einstellungen definiert. Falls für die erste Zeile einer Rechnung ein Buchungsdatum angegeben wird, GnuCash wird versuchen, auch die Rechnung zu buchen (anstatt sie nur zu speichern oder aktualisieren).

  • Fälligkeitsdatum - Fälligkeitsdatum. Optional. Verwenden Sie das gleiche Datumsformat wie in den Einstellungen definiert. Es wird das Tagesdatum verwendet falls das Feld nur Leerzeichen enthält. Nur relevant in der ersten Zeile einer Rechnung, wenn die Rechnung gebucht ist.

  • Konto-gebucht - Konto auf das gebucht wird, für Lieferanten- oder Kundenbuchungen. Nur obligatorisch in der ersten Zeile einer Rechnung, wenn die Rechnung gebucht ist.

  • Buchungstext-gebucht - Buchungstext. Optional. Nur relevant in der ersten Zeile einer Rechnung, wenn die Rechnung gebucht ist.

  • Kumul-Zeilen - Buchungsteile kumulieren? Optional. Verwenden Sie J oder X für Ja, N oder Leerzeichen für Nein. Nur relevant in der ersten Zeile einer Rechnung, wenn die Rechnung gebucht ist. Falls Sie ein Tabellenkalkulationsprogramm zur Erstellung der Importdatei verwenden, sollte kein Leerzeichen für Nein verwendet werden da eine letzte Spalte, die nur Leerzeichen enthält möglicherweise nicht als relevant erkannt wird, wenn die Tabellenkalkulation die CSV-Datei erzeugt.

Anmerkung zu Anführungszeichen

Falls Sie das Trennzeichen für Felder innerhalb eines Feldes verwenden, sollte das Feld in Anführungszeichen eingeschlossen werden. Nur für die Felder Beschreibung und Bemerkungen können Sie Anführungszeichen in ein durch Anführungszeichen eigneschlossenes Feld einfügen in dem Sie das Anführungszeichen verdoppeln. Beispielsweise wird "Dieses Feld verwendet das Trennzeichen und ein ""Wort"" in Anführungszeichen" importiert als Dieses Feld verwendet das Trennzeichen und ein "Wort" in Anführungszeichen.

Beispielhafter Inhalt für zwei Lieferantenrechnungen, eine mit 2 Einträgen und eine mit 3. Die erste Rechnung ist gespeichert und gebucht, die zweite nur gespeichert. Als Feldtrenner wird das Semikolon verwendet, Dezimalkomma und tt.mm.jjjj als Datumsformat.

    1204;15.12.2018;2001;PO 210220;Kurierdienst;16.12.2018;Stolz und Vorurteil;pc;Aufwendungen:Bildung:Bücher;1;30,00;;;;X;;7;17.12.2018;17.1.2019;Verbindlichkeiten:Verbindlichkeiten aus Lieferung und Leistung;;X
    1204;15.12.2018;2001;PO 210220;Kurierdienst;16.12.2018;Das Kochbuch;pc;Aufwendungen:Bildung:Bücher;1;50,00;;;;X;;7;17.12.2018;17.1.2019;Verbindlichkeiten:Verbindlichkeiten aus Lieferung und Leistung;;X
    1205;15.12.2018;2044;PO 21099;;16.12.2018;Ferien in der Heide;pc;Aufwendungen:Bildung:Bücher;1;10,01;;;;;;;;;;;
    1205;15.12.2018;2044;PO 21099;;16.12.2018;Essen und Trinken;pc;Aufwendungen:Lebensmittel;1;10,01;;;;;;;;;;;
    1205;15.12.2018;2044;PO 21099;;16.12.2018;Kursgebühr;pc;Aufwendungen:Bildung:Studiengebühren;1;10,01;;;;;;;;;;;
         

Beispielhafter Inhalt für eine Kundenrechnung mit einem Eintrag mit Steuern und Rabatt. Als Feldtrenner wird das Semikolon verwendet, Dezimalkomma und tt.mm.jjjj als Datumsformat. Der Wert des Feldes Beschreibung enthält das Feldtrennzeichen.

    20221;16.12.2018;1001;Bestellung 3378;Rabatt wie vereinbart;4.12.2018;"Accounting part 1; 2";ea;Erträge:Sonstiges;1;769,95;%;=;10;X;N;19;16.12.2018;16.01.2019;Aktiva:offene Forderungen;Gebucht beim Import;X
         

18.1.3. Importieren der Daten

Um die Rechnungsdaten zu importieren, navigieren Sie zu DateiImportierenRechnungen importieren… um einen neuen Importdialog zu öffnen, und geben Sie die notwendigen Informationen ein.

  • 1. Wählen einer Datei, die importiert werden soll - Wählen Sie die Importdatei aus oder geben Sie den Pfad- und Dateinamen manuell ein.

  • 2. Wählen Sie die Import-Art - Wählen Sie die Import-Art aus, entweder Lieferantenrechnung oder Rechnung.

  • 3. Wählen Sie die Importoptionen - Wählen Sie das CSV-Format aus. Verwenden Sie die mit Anführungszeichen-Optionen, falls Ihre Datei Felder enthält, die in Anführungszeichen eingeschlossen sind. Diese Optionen passen auch auf Felder, die nicht in Anführungszeichen eingeschlossen sind; mit Ausnahme der Felder für Beschreibung und Notizen sollten Felder nicht das Anführungszeichen selbst enthalten.. Siehe Anmerkung zu Anführungszeichen oben. Verwenden Sie eine der anderen Optionen, falls Ihre Datei keine in Anführungszeichen eingeschlossenen Felder enthält; jedes Anführungszeichen in der Datei wird unverändert importiert.

  • 4. Vorschau - Nachdem Sie die Ihre Importdatei und das CSV-Format ausgewählt haben zeigt GnuCash eine Vorschau der Daten an. Sie können überprüfen, ob Ihre Daten in den richtigen Spalten angezeigt werden. Falls Sie keine Zeilen in der Vorschauf sehen, konnte GnuCash die importierten Zeilen nicht mit dem gewählten CSV-Format abgleichen. Siehe Abschnitt 18.1.5, „Was kann schief gehen?“ unten.

  • 5. Danach - Sie können wählen, ob GnuCash nach dem Import Registerkarten für die Rechnungen öffnen soll. Entweder für alle Rechnungen oder für die Rechnungen, die gespeichert aber nicht gebucht werden, oder für keine der Rechnungen. Das Öffnen von Registerkarten verlangsamt den Importvorgang erheblich.

  • Starten des Imports - Wenn Sie mit Ihrer Auswahl zufrieden sind, klicken Sie auf die Schaltfläche OK, um den Import zu starten.

Wenn Ihre Importdatei Rechnungsnummern enthält, die bereits existieren, wird GnuCash Sie fragen (einmal pro Importsitzung), ob Sie die bestehenden Rechnungen aktualisieren möchten. Wenn Sie das nicht bestätigen, werden alle Zeilen für existierende Rechnungen ignoriert.

Anmerkung

Intern verwendet GnuCash so genannte reguläre Ausdrücke um die Importzeilen den Datenfeldern zuzuordnen. Die Importoption Benutzerdefinierter Regulärer Ausdruck bietet die Möglichkeit, eigene Reguläre Ausdrücke für diesen Zuordnungsprozess zu verwenden. Diese Option setzt natürlich voraus, dass Sie sich mit regulären Ausdrücken gut auskennen. Wenn Sie die Option Benutzerdefinierter Regulärer Ausdruck auswählen, öffnet GnuCash ein Fenster, in dem Sie den GnuCash Regulären Ausdruck editieren oder durch Ihren eigenen ersetzen können. Ihr regulärer Ausdruck sollte für jedes der Felder der CSV-Datei ein benanntes Untermuster enthalten (unter Verwendung der technischen Namen). Ein benutzerdefinierter regulärer Ausdruck kann nützlich sein, wenn die Zeilen Ihrer Quelldatendatei alle erforderlichen Felder enthalten, aber in einer anderen Reihenfolge oder einem anderen Format. Wenn z.B. das Format Ihrer Quelldatendatei mit der Kundennummer beginnt, gefolgt von der Rechnungsnummer, gefolgt vom Fälligkeitsdatum, und | als Trennzeichen verwendet, würde Ihr regulärer Ausdruck mit etwas wie diesem beginnen:

   ^(?<Mandant-Nr>[^|]*)\|(?<Nummer>[^|]*)\|(?<Fälligkeitsdatum>[^|]*)
           

Mit einem benutzerdefinierten Regulären Ausdruck kann GnuCash Ihre Quelldatendatei importieren, ohne dass die Notwendigkeit besteht, sie in das GnuCash Importformat zu konvertieren.

18.1.4. Rückmeldungen und Statistiken

GnuCash führt den Importprozess in drei Schritten durch:

  • Importieren - Importiert die CSV-Datei und versucht, jede Zeile den Datenfeldern zuzuordnen.

  • Validieren and Anpassung - Validiert die Datenfelder und ersetzt die Daten ggf. durch Standardwerte.

  • Verarbeitung - Erledigt die währungsbezogenen Validierungen und erstellt, aktualisiert und bucht die Rechnungen.

Nachdem alle Schritte abgeschlossen sind, gibt GnuCash Informationen über das Ergebnis des Prozesses aus. Der erste Dialog zeigt die Informations- oder Fehlermeldungen aus den Validierungs- und Verarbeitungsschritten. Der zweite Dialog zeigt die Statistik des Prozesses an:

  • Import - Zeilen ignoriert: Die Anzahl der Zeilen, die nicht mit den Datenfeldern abgeglichen werden konnten.

  • Import - Zeilen importiert: Die Anzahl der Zeilen, die erfolgreich mit den Datenfeldern abgeglichen wurden.

  • Validierung & Verarbeitung - Zeilen repariert: Die Anzahl der Zeilen, für die ein Standardwert für ein Feld verwendet wurde.

  • Validierung & Verarbeitung - Zeilen ignoriert: Die Anzahl der Zeilen, die aufgrund eines Validierungsfehlers nicht verarbeitet wurden.

  • Validierung & Verarbeitung - Rechnungen erstellt: Die Anzahl der erstellten Rechnungen.

  • Validierung & Verarbeitung - Rechnungen aktualisiert: Die Anzahl der Rechnungen, die aktualisiert wurden.

Wenn es im Importschritt nicht übereinstimmende Zeilen gab, zeigt ein abschließender Dialog die tatsächlichen Zeilen an, die nicht zugeordnet werden konnten.

18.1.5. Was kann schief gehen?

18.1.5.1. Fehler im Importschritt

Wenn die Statistik unter Import - Zeilen ignoriert nicht übereinstimmende Zeilen anzeigt, dann gibt es ein Problem mit dem Format Ihrer Importdatei. Überprüfen Sie, ob Sie das richtige Trennzeichen verwenden und wählen Sie es aus. Stellen Sie sicher, dass Ihre Datenzeilen genau 21 Trennzeichen enthalten (1 für jedes Feld, außer dem letzten). Überprüfen Sie, ob Sie das Trennzeichen innerhalb eines Datenfelds verwenden; wenn ja, schließen Sie das Feld in doppelte Anführungszeichen ein.

Wenn Sie eine der Importoptionen mit Anführungszeichen verwenden, prüfen Sie, ob Sie das doppelte Anführungszeichen in einem der Datenfeldwerte verwenden; wenn innerhalb der Felder Beschreibung oder Notizen, stellen Sie sicher, dass der Feldwert in Anführungszeichen steht, und setzen Sie vor jedes doppelte Anführungszeichen innerhalb des Feldes ein zusätzliches doppeltes Anführungszeichen. Wenn es sich um ein anderes Feld handelt, entfernen Sie das doppelte Anführungszeichen.

18.1.5.2. Fehler im Validierungsschritt

Die folgenden Fehler können im Validierungsschritt auftreten. Jeder Fehler in einer Datenzeile führt dazu, dass alle Zeilen der gleichen Rechnung ignoriert werden.

Anmerkung

In den Versionen 3.4 und früher führte ein Fehler in einer Datenzeile dazu, dass nur diese Zeile ignoriert wurde, im Gegensatz zu allen Zeilen der gleichen Rechnung.

  • Das Feld Nummer ist leer. Jede Zeile sollte eine Rechnungsnummer haben.

  • Das Feld Mandant-Nr ist leer. Jede erste Zeile einer Rechnung sollte eine Mandant-Nr haben.

  • Die Kunden- oder Lieferantennummer im Feld Mandant-Nr existiert nicht. Die Mandant-Nr in der ersten Zeile einer Rechnung sollte eine existierende Nummer für Kunden (bei Rechnungen) oder Lieferanten (bei Lieferantenrechnungen) sein.

  • Das Datum im Feld Buchungsdatum ist kein gültiges Datum. Wenn Sie einen Wert für das Buchungsdatum in der ersten Zeile einer Rechnung angeben, sollte es ein gültiges Datum sein. Haben Sie das Datumsformat verwendet, das in den Voreinstellungen eingestellt ist?

  • Das Konto im Feld Konto-gebucht existiert nicht. Wenn Sie einen Wert für das Feld Buchungsdatum in der ersten Zeile einer Rechnung angeben, sollte das Feld Konto-gebucht ein existierendes Konto sein.

  • Das Konto im Feld Konto-gebucht ist nicht vom Typ offene Forderungen (für Rechnungen) oder offene Verbindlichkeiten (für Lieferantenrechnungen). Wenn Sie einen Wert im Feld Buchungsdatum in der ersten Zeile einer Rechnung angeben, sollte das Feld Konto-gebucht ein Konto des richtigen Typs sein.

  • Das Feld Preis ist leer. Jede Zeile sollte einen Wert für das Feld Preis enthalten.

  • Das Konto im Feld Konto existiert nicht. Jede Zeile sollte ein vorhandenes Konto im Feld Konto haben.

Jeder Fehler im Validierungsschritt wird nach Abschluss des gesamten Importvorgangs aufgelistet. Korrigieren Sie Ihre Datendatei entsprechend.

18.1.5.3. Fehler im Verarbeitungsschritt

Die folgenden Fehler können im Verarbeitungsschritt auftreten.

  • Die Lieferantenrechnung kann nicht aktualisiert werden, da sie bereits gebucht ist. Alle Zeilen der gleichen Lieferantenrechnung werden ignoriert. Wenn Sie die bestehende Lieferantenrechnung aktualisieren wollen, buchen Sie sie zuerst in GnuCash aus.

  • Die Währung der Lieferantenrechnung weicht von der Währung des gebuchten Kontos ab (Rechnung x nicht gebucht, da die Währungen nicht übereinstimmen.). GnuCash ermittelt die Währung der Lieferantenrechnung entweder aus den Kunden- oder Lieferantenstammdaten (bei einer neuen Lieferantenrechnung) oder aus der Lieferantenrechnung selbst (bei einer bestehenden Lieferantenrechnung). Die Währung der Lieferantenrechnung muss übereinstimmen mit der Währung der zu kontierenden Buchung im Feld Konto-gebucht übereinstimmen. GnuCash erstellt die Lieferantenrechnung, kann sie aber nicht buchen. Korrigieren Sie die Lieferantenrechnung manuell in GnuCash.

  • Die Lieferantenrechnung erfordert eine Währungsumrechnung. (Rechnung x wird nicht gebucht, da sie eine Währungsumrechnung erfordert). Die Lieferantenrechnung enthält Buchungen auf Konten mit unterschiedlichen Währungen, oder die Währung der Buchungen weicht von der Währung des Buchungskontos ab. Für eine solche Lieferantenrechnung benötigt GnuCash Wechselkurse zur Umrechnung der Währungsbeträge. GnuCash erstellt die Lieferantenrechnung, kann sie aber nicht buchen. Buchen Sie die Lieferantenrechnung manuell in GnuCash und geben Sie die gewünschten Wechselkurse an.

18.1.6. Nicht unterstützte Funktionalität für Lieferantenrechnungen

Derzeit unterstützt die Importfunktion der Lieferantenrechnung (mindestens) Folgendes nicht:

  • Import von Abrechnungsbedingungen und Auftrag.

  • Importieren von Kunden und Aufträgen in Standard-Rückbuchungs-Projekten für Lieferantenrechnungen.

  • Anwendung von Rechnungsbedingungen aus Kunden- oder Lieferantenstammdaten.

  • Automatische Nummerierung der Lieferantenrechnungen.

  • Gutschriften.