Blog

freee Sales: Produktstamm-CSV in Dateien mit je 999 Datensätzen aufteilen

Beim Produktimport in freee Sales sind höchstens 1.000 CSV-Zeilen einschließlich Kopfzeile erlaubt. So entstehen Dateien mit je 999 Datensätzen und wiederholter Kopfzeile, ohne führende Nullen zu verlieren.

Schema: Eine CSV wird in eine große und eine kleine Datei aufgeteilt, beide mit derselben Kopfzeile.

Für den Import von Produktstammdaten in freee Sales (freee販売) die CSV-Splitter-Oberfläche auf Englisch öffnen, Maximum data rows per output file auf 999 setzen und die Option aktivieren, den ersten Datensatz als Kopfzeile in jeder Datei zu wiederholen. Eine Ausgabedatei enthält damit höchstens 999 Produktdatensätze plus eine Kopfzeile, insgesamt 1.000 CSV-Datensätze.

Die Grenze gilt nicht für sämtliche CSV-Importe von freee, sondern für Produktinformationen in freee Sales. Die offizielle Anleitung zu Import und Export nennt 1.000 Zeilen inklusive Kopfzeile. Exporte haben keine entsprechende Zeilenbegrenzung: Eine exportierte große Datei lässt sich daher nicht unbedingt unverändert wieder importieren. Stand der Prüfung: 21. November 2026.

Der CSV-Splitter ist für Deutsch noch nicht lokalisiert; die verlinkte englische Oberfläche ist nutzbar. Die folgenden englischen Beschriftungen entsprechen den Bedienelementen; die japanischen Bezeichnungen im Beispiel stammen aus dem offiziellen Produktdatenformat.

999 Datenzeilen und die Kopfzeile getrennt einstellen

Die Originaldatei aufbewahren und die Daten anhand der aktuellen offiziellen Vorlage sowie der Felddefinitionen vorbereiten. Das Tool übersetzt weder Spaltennamen noch Feldwerte in das freee-Format.

  1. Über CSV / TSV file to split die lokale Datei auswählen.
  2. Unter Delimiter Comma (CSV) wählen. In der Eingabevorschau japanische Zeichen und Spaltengrenzen prüfen; bei fehlerhaften Zeichen die tatsächliche Input encoding einstellen.
  3. Unter Split by die Option Maximum number of data rows wählen und bei Maximum data rows per output file den Wert 999 eingeben.
  4. Die Option zum Wiederholen des ersten Datensatzes als Kopfzeile aktivieren. Die Kopfzeile zählt nicht zu den 999 Datenzeilen.
  5. Für unveränderte UTF-8-Dateien bei Output encoding Same as input (preserve BOM) wählen. Falls die Zielvorlage UTF-8 mit BOM verlangt, ist UTF-8 (with BOM) möglich; ein BOM ist nicht generell vorgeschrieben. Output record separator auf Same as input (preserve mixed line endings) setzen.
  6. Bei Save method Download one file at a time auswählen und Validate and split starten.
  7. Jede Datei über Save this CSV speichern und erst nach bestätigtem Download mit Confirm download and continue fortfahren. Auch die letzte Datei kontrollieren und die Ausgabeliste überprüfen.

Unterstützte Browser können große Dateien außerdem direkt in einen Ordner speichern. Beim Einzeldownload verfällt der Link zur vorherigen Datei, wenn man ohne Speichern fortfährt. Die CSV-Inhalte bleiben zur Verarbeitung im Browser und werden nicht an den Server des Tools hochgeladen.

1.001 fiktive Produkte ergeben Dateien mit 999 und 2 Datensätzen

Angenommen, eine CSV enthält 1.001 erfundene Produkte. Das folgende Beispiel zeigt nur die ersten drei Datensätze, nicht die vollständige Importdatei. Für reale Importe ist die neueste offizielle Vorlage maßgeblich.

名称,帳票・明細への表示名称,コード,販売単価
サンプル商品0001,サンプル商品0001,0001,100
サンプル商品0002,サンプル商品0002,0002,100
サンプル商品0003,サンプル商品0003,0003,100

Die japanischen Spalten stehen für Name, Anzeigename auf Dokumenten, Produktcode und Verkaufseinzelpreis. Laufen die Produktcodes von 0001 bis 1001, ergibt das Aufteilen von products.csv:

Datei Produktdatensätze Datensätze mit Kopfzeile Codes
products_part_000001.csv 999 1.000 0001–0999
products_part_000002.csv 2 3 1000–1001

Auch die zweite Datei benötigt dieselbe Kopfzeile. Bei einer fälschlichen Obergrenze von 1.000 Datenzeilen entstünden mit Kopfzeile 1.001 Datensätze. Die Software zählt CSV-Datensätze, nicht physische Textzeilen: Ein Zeilenumbruch innerhalb eines korrekt zitierten Feldes erzeugt keinen zusätzlichen Datensatz. Ob freee solche Feldinhalte akzeptiert, muss in der Importvorschau geprüft werden.

Führende Nullen und leere Spalten gesondert prüfen

Das Tool wandelt Feldinhalte nicht in Zahlen um: 0001 bleibt 0001. Tabellenkalkulationen können beim erneuten Öffnen und Speichern allerdings führende Nullen entfernen. Codes daher als Text importieren oder die CSV im Texteditor prüfen; bereits verlorene Nullen kann der Splitter nicht wiederherstellen.

Ein vorhandener Produktcode kann beim Import einen Datensatz aktualisieren, ein neuer Code einen Datensatz anlegen. Eine Spalte wegzulassen ist nicht dasselbe, wie sie mit leerem Wert mitzusenden. Das Aktualisierungsverhalten hängt vom Feld ab. Das erfolgreiche Aufteilen ist keine Bestätigung dafür, dass der anschließende Import korrekt ist.

Vor dem Import die Vorschau in freee prüfen

In freee Sales von 商品一覧 (Produktliste) über ・・・ → CSVインポート (CSV-Import) zu プレビュー画面へ (Vorschau) wechseln. Datensatzanzahl, Codes, Namen und zu aktualisierende Werte prüfen. Bei Fehlern die Quelldatei korrigieren, erneut aufteilen und alte und neue Ausgabedateien nicht mischen.

Das Beispiel verwendet fiktive Daten; ein tatsächlicher Import in freee Sales wurde nicht getestet. Die offizielle freee-Dokumentation hat bei Pflichtfeldern, Berechtigungen und Eingabebeschränkungen Vorrang. Anschließend die wirklichen Importergebnisse prüfen. Der iXam-CSV-Splitter ist kein offizielles freee-Produkt; eine Partnerschaft wird nicht behauptet.