Häufige Fehler beim QuickBooks-Rechnungsimport per CSV und ihre Lösung

Der CSV-Import von QuickBooks Online ist streng. Schon ein einzelner Formatierungsfehler kann dazu führen, dass der gesamte Import scheitert — oder im ungünstigsten Fall nur ein Teil der Daten angelegt wird und sich nur schwer rückgängig machen lässt.

Dieser Leitfaden behandelt die häufigsten Fehler beim Rechnungsimport in QuickBooks Online und zeigt, wie du sie mit dem QuickBooks Invoice CSV Preparer vermeiden kannst.

„Ungültige Referenz“ oder „Kunde nicht gefunden“

QuickBooks gleicht die Spalte „Customer“ mit vorhandenen Kundennamen in deiner Unternehmensdatei ab. Dabei wird zwischen Groß- und Kleinschreibung unterschieden, und der Name muss exakt übereinstimmen.

Häufige Ursachen:

• Leerzeichen am Ende von Kundennamen
• Abweichende Groß- und Kleinschreibung (z. B. „acme studio“ statt „Acme Studio“)
• Ein Anzeigename statt des rechtlichen Namens in QuickBooks

„Ungültiges Datumsformat“

QuickBooks Online fordert dich beim Import auf, das in deiner Datei verwendete Datumsformat auszuwählen, zum Beispiel DD/MM/YYYY oder MM/DD/YYYY. Verwende im gesamten Dokument ein einheitliches Format.

Der Preparer übernimmt den Datumstext unverändert und validiert oder normalisiert Datumsformate nicht. Stelle daher sicher, dass die Datumswerte dem Format entsprechen, das du in QuickBooks auswählst.

„Betrag darf nicht negativ sein“

QuickBooks Online erlaubt keine negativen Belastungen in Rechnungspositionen. Null ist erlaubt; Gutschriften und Erstattungen müssen separat als Credit Memos importiert werden, nicht als negative Rechnungspositionen.

Der Preparer markiert negative Beträge als Validierungsfehler. Für Gutschriften:

1. Entferne Zeilen mit negativen Beträgen aus deiner Rechnungs-CSV.
2. Importiere sie separat als Credit Memos in QuickBooks.

„Zeile hat zu viele/zu wenige Spalten“

Jede Datenzeile muss dieselbe Anzahl von Spalten wie die Kopfzeile haben. Uneinheitliche Zeilen mit fehlenden oder zusätzlichen Feldern führen zu Importfehlern.

Häufige Ursachen:

• Nicht in Anführungszeichen gesetzte Felder mit Kommas
• Zeilenumbrüche innerhalb von Feldern
• Abschließende Kommas am Zeilenende

Der Preparer prüft die Zeilenbreite und meldet abweichende Zeilen mit ihrer Zeilennummer.

Wiederholte Rechnungsnummern

Mehrere Zeilen mit derselben Rechnungsnummer sind normal, wenn eine Rechnung mehrere Positionen enthält. Der Preparer erlaubt solche Wiederholungen und zählt für das Limit von 100 Rechnungen pro Stapel nur unterschiedliche Rechnungsnummern.

Wenn du einen versehentlichen erneuten Export oder Import erkennen möchtest, musst du die Quelldaten separat mit deiner bisherigen Importhistorie vergleichen. Der Preparer stuft wiederholte Rechnungsnummern nicht als Duplikate ein.

Importlimits von QuickBooks Online

| Limit | Wert | | ------------------------------------ | ----------------------------- | | Maximale Zeilen pro Import | 1.000 | | Maximale unterschiedliche Rechnungen | 100 | | Maximale Dateigröße | Abhängig vom QuickBooks-Tarif |

Die 200-MiB-Grenze von Nablyx ist eine Browser-Verarbeitungsgrenze und keine QuickBooks-Importgrenze. QuickBooks Online akzeptiert pro Rechnungsimport höchstens 1.000 Zeilen und 100 Rechnungen. Eine größere Quell-CSV kannst du mit Nablyx trotzdem lokal bis 200 MiB verarbeiten. Nach der Validierung erstellt Nablyx so viele QuickBooks-kompatible Stapeldateien wie nötig und hält jede Rechnung vollständig in einem Stapel. Bei größeren Datensätzen lädst du die ZIP-Datei herunter und importierst quickbooks-invoices-batch-01.csv, quickbooks-invoices-batch-02.csv und die restlichen Stapel nacheinander in QuickBooks Online.

Checkliste zur Vermeidung von Fehlern

Vor dem Import deiner CSV:

• [ ] Alle Pflichtspalten sind zugeordnet (Invoice number, Customer, Invoice Date, Due Date, Item Amount).
• [ ] Kundennamen stimmen exakt mit QuickBooks überein.
• [ ] Im gesamten Dokument wird ein einheitliches Datumsformat verwendet und beim Import ausgewählt (zum Beispiel DD/MM/YYYY oder MM/DD/YYYY).
• [ ] Kein Betrag ist negativ (Null ist erlaubt).
• [ ] Keine uneinheitlichen Zeilen: Alle Zeilen haben dieselbe Spaltenanzahl.
• [ ] Jeder erzeugte QuickBooks-Stapel enthält höchstens 1.000 Zeilen.
• [ ] Jeder erzeugte QuickBooks-Stapel enthält höchstens 100 unterschiedliche Rechnungen.
• [ ] Keine doppelten Rechnungsnummern über mehrere Importstapel hinweg.

Lass deine CSV durch den QuickBooks Invoice CSV Preparer laufen, um die strukturellen Regeln automatisch zu prüfen — zugeordnete Pflichtspalten, nicht negative Beträge und einheitliche Zeilenbreite — und QuickBooks-kompatible Stapel zu erzeugen, sobald die geprüfte Quelle 1.000 Zeilen oder 100 Rechnungen überschreitet. Der Abgleich von Kundennamen, die Konvertierung oder Validierung von Datumsformaten und die Erkennung von Duplikaten über mehrere Importstapel hinweg werden nicht automatisiert; prüfe diese Punkte vor dem Import gegen deine QuickBooks-Daten.

customer_id ; name ; email

1042 ;  Alex  ; alex@example.com
1043 ; Sam ; sam@example.com ;

customer_id,name,email
1042,Alex,alex@example.com
1043,Sam,sam@example.com