Blog

freee販売の商品マスタCSVを999件ずつ分割する

freee販売の商品マスタCSVはヘッダー込みで1,000行が上限。CSV分割ツールでデータを999件ずつに分け、各ファイルへヘッダーを付ける設定と、1,001件を分割する例を紹介する。先頭ゼロの保持や、取込み前に確認すべき項目も整理する。

1つのCSVを、同じヘッダーを持つ大きなファイルと小さなファイルに分ける模式図

freee販売の商品マスタCSVを分割するなら、CSV分割ツールの「1ファイルの最大データ行数」を 999 にし、「先頭レコードをヘッダとして各ファイルに付ける」をオンにする。これで各ファイルは、データ999件とヘッダー1行を合わせた最大1,000レコードになる。

これはfreeeのすべてのCSV取込みに共通する設定ではない。対象は、freee販売の商品情報(商品マスタ)のインポートである。公式のインポート・エクスポート案内では、ヘッダーを含めて1,000行までとされている。エクスポートには行数制限がないため、大きなCSVをそのまま再取込みできるとは限らない。仕様は2026年11月21日に確認した。

999件とヘッダーを分けて設定する

元のCSVは残し、公式案内のテンプレートと項目定義に沿ったファイルを用意する。分割ツールは列名や値をfreee用に変換するものではない。

  1. CSV分割ツールを開き、「分割するCSV / TSV」でファイルを選ぶ。
  2. 「区切り文字」を「カンマ(CSV)」にする。「先頭プレビュー(文字コードを確認)」を開き、日本語と列の区切りを確認する。文字化けする場合は「入力文字コード」を実際のファイルに合わせる。
  3. 「分割方法」で「データ行数の上限」を選び、「1ファイルの最大データ行数」に 999 を入力する。
  4. 「先頭レコードをヘッダとして各ファイルに付ける」をオンにする。ここで指定した999件にはヘッダーを含めない。
  5. UTF-8のCSVで、文字コードを変える必要がなければ「出力文字コード」は「入力と同じ(BOMの有無も保持)」にする。公式テンプレートと同じUTF-8(BOMあり)へ変換する場合は「UTF-8(BOMあり)」を選べる。BOMの付与が常に必須という意味ではない。「出力のレコード区切り」は「入力と同じ(混在も保持)」にする。
  6. 「保存方法」で「1ファイルずつダウンロード」を選び、「検証して分割する」を押す。
  7. 「このCSVを保存」で保存し、ブラウザ側で完了したことを確かめてから「保存を確認して次へ」を押す。最後のファイルも確認し、完了後の「出力結果」を見る。

対応ブラウザでは「フォルダに直接保存(巨大ファイル向け)」も選べる。個別ダウンロードでは、保存前に次へ進むと前のファイルのリンクが使えなくなるため、保存確認を省かない。

選んだCSVの分割処理はブラウザ内で行われ、ツールがCSVの内容をサーバーへ送信することはない。

架空の商品1,001件なら、999件と2件になる

説明用に、次の列で架空の商品を1,001件並べたCSVを考える。以下は先頭3件だけの抜粋であり、そのまま1,001件のファイルになるわけではない。実データの作成には、公式の最新テンプレートを使う。

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

商品コードは 0001 から 1001 までとする。ファイル名を products.csv にして999件で分割すると、出力は次の2ファイルになる。

ファイル名 データ件数 ヘッダーを含むレコード数 コードの範囲
products_part_000001.csv 999 1,000 0001〜0999
products_part_000002.csv 2 3 1000〜1001

2つ目も1行目は同じ列名になる。ヘッダーを付け忘れたり、最大データ行数を1,000にして合計1,001レコードにしたりしないことが重要だ。

このサンプルにはセル内改行を含めていない。分割ツールの行数はCSVのレコード数であり、引用符で囲んだセル内の改行は別のレコードとして数えない。セル内改行を含む実データについて、freee側での受入れまで保証するものではないため、取込み前のプレビューでも確認する。

先頭のゼロと、空欄の意味は別々に確認する

分割ツールは数値や日付への型変換をしないため、元のCSVにある 0001 は分割後も 0001 のままだ。ただし、その後に表計算ソフトで開いて保存し直すと、ソフト側で数値として扱われることがある。コード列は文字列として取り込むか、CSVをテキストとして確認する。分割前に失われていたゼロを復元する機能ではない。

freeeへの取込みでは、コードが既存商品と一致すると更新、一致しないと新規登録になる。また、列を省くことと、列を残して空欄にすることは同じではない。更新時の扱いは項目ごとに異なるので、公式案内の項目表を確認する。分割が成功したという理由だけで、そのまま実データへ取り込まない。

freee側のプレビューで確認してから取り込む

freee販売の「商品一覧」から「・・・」→「CSVインポート」へ進み、分割したファイルを選んで「プレビュー画面へ」で内容を確認する。件数だけでなく、コード、名称、更新する項目の値が意図どおりかを確かめる。問題がある場合は元データを修正して分割し直し、古い出力と混ぜないようにする。

本記事の例は架空データであり、実際のfreee販売環境へのインポートは検証していない。必要な列や権限、入力値の条件は公式案内を優先し、実行後は取込み結果も確認する。iXamのCSV分割ツールはfreeeの公式ツールではなく、両者の提携を示すものではない。