CSV für den Rechnungsimport in QuickBooks Online vorbereiten

Der native Rechnungsimport von QuickBooks Online akzeptiert CSV-Dateien — aber nur in einem bestimmten Format. Wenn deine Quelldaten andere Spaltennamen, zusätzliche Spalten oder Validierungsfehler enthalten, kann der Import mit schwer verständlichen Fehlermeldungen scheitern oder im ungünstigsten Fall unbemerkt doppelte Rechnungen erzeugen.

Der QuickBooks Invoice CSV Preparer ordnet deine Quellspalten dem von QuickBooks erwarteten Format zu, validiert die Rechnungsdaten und erstellt automatisch QuickBooks-kompatible Importstapel, wenn eine gültige Quelle größer als ein einzelner Zielstapel ist.

Was QuickBooks Online erwartet

Der native Rechnungsimport von QuickBooks Online benötigt diese Spalten:

| Spalte | Pflicht | Hinweise | | ---------------- | ------- | ------------------------------------------------------------------ | | Rechnungsnummer | Ja | Bei mehrzeiligen Rechnungen in jeder Zeile wiederholen | | Kunde | Ja | Muss einem vorhandenen Kundennamen entsprechen | | Rechnungsdatum | Ja | Ein einheitliches Datumsformat verwenden und beim Import auswählen | | Fälligkeitsdatum | Ja | Im gesamten Dokument dasselbe ausgewählte Datumsformat verwenden | | Positionsbetrag | Ja | Darf nicht negativ sein (Null ist erlaubt) | | Beschreibung | Nein | Beschreibung der Rechnungsposition |

Eine Rechnung kann mehrere Positionen enthalten. Jede Position steht in einer eigenen CSV-Zeile und verwendet dieselbe Rechnungsnummer. Der Gesamtbetrag der Rechnung ist die Summe ihrer Positionen.

Ein realistischer Ausgangspunkt

Ein typischer Rechnungsexport kann so aussehen. Die Spalten heißen so, wie dein Quellsystem sie benennt, nicht wie QuickBooks.

Die Rechnung INV-1001 hat zwei Positionen. Beide Zeilen verwenden dieselbe Rechnungsnummer. Der Preparer erhält diese Struktur, während er die Spalten zuordnet und die Daten prüft.

Was das Tool tatsächlich macht

Ein klarer Ablauf: Spalten zuordnen → Regeln prüfen → saubere CSV exportieren.

1. 01

   CSV hinzufügen

   Lade eine CSV mit Rechnungsdaten hoch. Die ersten Zeilen werden untersucht, um die Kopfzeile zu erkennen. Dateien bis 200 MB werden unterstützt.

2. 02

   Spalten zuordnen

   Ordne jedem QuickBooks-Feld die passende Spalte aus deiner Quelldatei zu. Das Tool schlägt anhand der Spaltennamen automatisch Zuordnungen vor.

3. 03

   Preflight-Prüfung ausführen

   Prüft Pflichtwerte, nicht negative Beträge und eine einheitliche Zeilenbreite und plant anschließend QuickBooks-Stapel mit höchstens 1.000 Zeilen und 100 Rechnungen.

4. 04

   Probleme prüfen

   Validierungsfehler werden mit Zeilennummer und Feld aufgelistet. Korrigiere sie in der Quelldatei und lade sie erneut hoch; der Download bleibt deaktiviert, bis die Validierung erfolgreich ist.

5. 05

   Vorbereitete Ausgabe herunterladen

   Ein Stapel wird als quickbooks-invoices.csv heruntergeladen. Mehrere Stapel kommen als quickbooks-invoices.zip mit nummerierten QuickBooks-kompatiblen CSV-Dateien.

Rechnungen mit mehreren Positionen

QuickBooks Online unterstützt mehrere Positionen pro Rechnung. In deinen Quelldaten steht jede Position in einer eigenen Zeile mit derselben Rechnungsnummer.

Der Preparer erhält diese Struktur: INV-2001 hat drei Positionen, und die ausgegebene CSV enthält weiterhin alle drei Zeilen. Der Gesamtbetrag für INV-2001 beträgt $725.00.

Häufige Validierungsfehler

Der Preparer erkennt Probleme, die dazu führen würden, dass QuickBooks den Import ablehnt:

| Fehler | Bedeutung | Lösung | | ------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------- | | Fehlender Wert | Eine Pflichtzelle ist leer | Leere Zelle in der Quelldatei ausfüllen | | Ungültiger Betrag | Der Positionsbetrag ist keine Zahl | Auf Währungssymbole, Kommas oder Text prüfen | | Negativer Betrag | Der Positionsbetrag ist kleiner als null | Gutschriften separat behandeln | | Zeilenbreite | Zeile hat eine andere Spaltenanzahl als die Kopfzeile | Uneinheitliche Zeilen in der Quelle korrigieren | | Eine Rechnung über 1.000 Zeilen | Eine einzelne Rechnung passt nicht in einen QuickBooks-Importstapel | Rechnung verkleinern oder eine andere Importmethode verwenden |

Limits von QuickBooks Online

QuickBooks Online setzt feste Grenzen für CSV-Importe:

• Höchstens 1.000 Datenzeilen pro Importdatei
• Höchstens 100 unterschiedliche Rechnungen pro Importdatei
• Beträge dürfen nicht negativ sein für Rechnungspositionen (Null ist erlaubt)

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.

Was das Tool nicht macht

Der Preparer ist ein Werkzeug zum Zuordnen und Prüfen. Er:

• erstellt oder bearbeitet keine Rechnungen direkt in QuickBooks,
• verarbeitet keine Gutschriften oder Erstattungen (negative Beträge werden als Fehler markiert),
• konvertiert oder validiert keine Datumsformate (QuickBooks Online lässt dich beim Import das verwendete Format auswählen, zum Beispiel DD/MM/YYYY oder MM/DD/YYYY; verwende im gesamten Dokument ein einheitliches Format),
• führt doppelte Rechnungsnummern nicht zusammen.

Importiere die vorbereitete CSV nach dem Download in QuickBooks Online über Settings → Import Data → Invoices.

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