Блог

Как разделить CSV справочника товаров freee Sales на части по 999 записей

Для импорта товаров в freee Sales действует предел в 1 000 строк вместе с заголовком. Разделите CSV по 999 записей, повторяйте заголовок и проверьте ведущие нули и обновление товаров.

Схема разделения одного CSV на большой и маленький файлы с одинаковой строкой заголовков.

При импорте справочника товаров в freee Sales (freee販売) откройте CSV Splitter с английским интерфейсом, установите Maximum data rows per output file равным 999 и включите повторение первой записи в качестве заголовка в каждой части. Тогда каждый файл содержит не более 999 строк данных плюс одну строку заголовков, то есть 1 000 записей.

Ограничение не относится ко всем операциям импорта CSV в freee. Оно действует при импорте сведений о товарах в freee Sales. В официальной инструкции по импорту и экспорту указан предел 1 000 строк вместе с заголовками. Для экспорта такого ограничения нет, поэтому большой экспортированный файл не обязательно удастся загрузить обратно целиком. Условия проверены 21 ноября 2026 года.

Русского интерфейса у разделителя пока нет: ссылка ведёт на английскую версию. Ниже приведены названия элементов английского интерфейса. Японские имена столбцов в примере соответствуют формату freee.

Отдельно задать 999 записей и строку заголовков

Сохраните исходный CSV. Подготовьте данные по актуальному официальному шаблону и описаниям полей: разделитель не переименовывает столбцы и не преобразует значения под формат freee.

  1. В поле CSV / TSV file to split выберите локальный файл.
  2. В Delimiter укажите Comma (CSV). Откройте предварительный просмотр и проверьте японские символы и границы столбцов. При искажении текста измените Input encoding на фактическую кодировку.
  3. В Split by выберите ограничение числа строк данных и введите 999 в Maximum data rows per output file.
  4. Включите Repeat the first record as a header in each output file. Строка заголовков не входит в эти 999 записей.
  5. Если исходный CSV уже в UTF-8, в Output encoding выберите Same as input (preserve BOM). При необходимости доступно UTF-8 (with BOM), но BOM нужен не всегда. В Output record separator установите Same as input (preserve mixed line endings).
  6. В Save method выберите Download one file at a time и нажмите Validate and split.
  7. Сохраняйте каждую часть через Save this CSV и только после завершения загрузки переходите по Confirm download and continue. Проверьте последнюю часть и итоговый список файлов.

В совместимых браузерах можно записывать большие результаты прямо в папку. При пофайловом скачивании переход вперёд до сохранения делает прежнюю ссылку недоступной. Содержимое CSV обрабатывается в браузере и не отправляется на сервер.

Из 1 001 вымышленного товара получатся части по 999 и 2 записи

Пусть CSV содержит 1 001 вымышленный товар. Ниже показаны только первые три записи, а не полный импортируемый файл. Для настоящих данных используйте актуальный официальный шаблон.

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

Японские названия столбцов означают название товара, отображаемое имя в документах, код и отпускную цену. Если коды идут от 0001 до 1001, разделение products.csv даст:

Файл Строк данных Всего с заголовком Коды
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 Sales откройте 商品一覧 (список товаров), затем ・・・ → CSVインポート (импорт CSV) и プレビュー画面へ (предварительный просмотр). Сверьте количество товаров, коды, имена и значения обновляемых полей. При ошибках исправьте исходник и повторите разделение, не смешивая старые и новые части.

Пример содержит вымышленные данные; реальный импорт в freee Sales не тестировался. Приоритет имеют официальные требования к столбцам, правам и значениям. После импорта проверьте фактические результаты. CSV Splitter от iXam не является официальным продуктом freee; партнёрство не подразумевается.