博客

将 freee 销售商品主数据 CSV 按每 999 条拆分

freee販売 的商品主数据 CSV 导入上限为包含表头在内的 1,000 行。介绍每份保留表头、按 999 条数据拆分的设置、1,001 条示例,以及前导零和更新字段的注意事项。

一个 CSV 文件被拆分为两个大小不同的文件,两者均保留相同表头的示意图

要拆分 freee販売(freee Sales)的商品主数据 CSV,可以在 CSV 拆分工具中将每个文件的最大数据行数设为 999,并开启将第一条记录作为表头附加到每个文件。这样,每个文件最多包含 999 条数据和 1 行表头,即 1,000 条 CSV 记录。

这并非 freee 所有 CSV 导入功能的通用限制。这里针对的是 freee販売 的商品信息(商品主数据)导入。官方导入与导出说明规定,上限是包括表头在内的 1,000 行。导出没有相同的行数限制,因此导出的大文件未必能够原样重新导入。上述规则于 2026 年 11 月 21 日核对。

拆分工具目前提供日语界面。以下保留实际控件的日文名称,并附上中文解释,便于操作。

分别设置 999 条数据和表头

保留原始 CSV,并按照官方最新模板和字段定义准备数据。拆分工具不会将列名或字段值转换为 freee 要求的格式。

  1. 打开 CSV 拆分工具,在 分割するCSV / TSV(待拆分 CSV/TSV)中选择文件。
  2. 将 区切り文字(分隔符)设为 カンマ(CSV)(逗号)。打开 先頭プレビュー(文字コードを確認)(文件开头预览),检查日文字符与分列是否正确。若出现乱码,根据文件实际编码调整 入力文字コード(输入编码)。
  3. 在 分割方法(拆分方式)中选择 データ行数の上限(数据行数上限),在 1ファイルの最大データ行数(每文件最大数据行数)输入 999。
  4. 开启 先頭レコードをヘッダとして各ファイルに付ける(把首条记录作为表头添加到每个文件)。这里的 999 条不包含表头。
  5. 若源 CSV 是 UTF-8 且无需改编码,将 出力文字コード(输出编码)设为 入力と同じ(BOMの有無も保持)(与输入相同,保留 BOM 状态)。如果需要与官方带 BOM 的 UTF-8 模板一致,可选择 UTF-8(BOMあり)(含 BOM);这并不代表 BOM 总是必须的。将 出力のレコード区切り(输出记录换行符)设为 入力と同じ(混在も保持)(与输入相同,混合换行符也保留)。
  6. 在 保存方法(保存方式)中选择 1ファイルずつダウンロード(逐个下载),点击 検証して分割する(验证并拆分)。
  7. 点击 このCSVを保存(保存此 CSV),确认浏览器已完成保存后,再点击 保存を確認して次へ(确认保存并继续)。最后一个文件也要确认,完成后查看 出力結果(输出结果)。

支持的浏览器还可选择 フォルダに直接保存(巨大ファイル向け)(直接保存到文件夹,适合大文件)。逐个下载时,若未保存就继续,前一个文件的下载链接将不可再用,因此不要省略确认步骤。

所选 CSV 的拆分完全在浏览器中执行,工具不会将内容上传至服务器。

虚构的 1,001 条商品数据,会分为 999 条和 2 条

假设某个 CSV 包含 1,001 条虚构商品记录,列结构如下。这里只摘录前 3 条,并不是一份完整的 1,001 条数据文件。实际导入请使用最新官方模板。

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

示例的商品代码从 0001 到 1001。以 products.csv 为文件名,按每份 999 条数据拆分后得到:

文件名 数据条数 包含表头的记录总数 商品代码范围
products_part_000001.csv 999 1,000 0001~0999
products_part_000002.csv 2 3 1000~1001

第二个文件的第一行也必须是相同的列名。特别注意不要忘记添加表头,也不要误把数据行数设为 1,000,从而让文件包含 1,001 条记录。

示例没有在单元格内部换行。拆分工具统计的是 CSV 记录数,被引号包围的单元格内换行不会算作新记录。不过,这并不保证 freee 能接受所有包含单元格内换行的数据,导入前仍需预览。

前导零与空白字段必须分别检查

拆分工具不会强制把字段转成数值或日期,因此 0001 拆分后仍是 0001。但用电子表格软件重新打开并保存时,软件可能把它当作数字,导致前导零丢失。应将代码列按文本导入,或在文本编辑器中检查 CSV。工具无法恢复拆分前就已丢失的零。

导入 freee 时,若商品代码与已有商品一致,可能更新已有记录;若不一致,则可能新建商品。此外,完全省略某列,与保留该列但留空,不是同一种操作。更新行为因字段而异,必须对照官方字段说明。拆分成功不代表可以不经检查就导入真实数据。

在 freee 的预览中确认后再导入

在 freee販売 中从 商品一覧(商品列表)进入 ・・・ → CSVインポート(CSV 导入),选择拆分后的文件,再进入 プレビュー画面へ(预览界面)。除记录数外,还要检查商品代码、名称及更新字段的值。若有问题,应修改原始数据并重新拆分,避免混用新旧输出文件。

本文使用的是虚构数据,没有在实际 freee販売 环境中验证导入过程。必需的列、权限及字段约束应以官方说明为准,并在导入后核对结果。iXam CSV 拆分工具不是 freee 的官方产品,本文不代表双方存在合作关系。