블로그

freee販売 상품 마스터 CSV를 999건씩 분할하는 방법

freee販売 상품 마스터 CSV는 헤더를 포함해 최대 1,000행만 가져올 수 있다. 데이터 999건씩 분할하고 헤더를 반복하는 방법, 1,001건의 예시, 앞자리 0과 업데이트 시 주의점을 설명한다.

하나의 CSV를 동일한 헤더가 있는 큰 파일과 작은 파일로 나누는 그림

freee販売(freee Sales)의 상품 마스터 CSV를 나누려면 CSV 분할 도구에서 파일당 최대 데이터 행 수를 999로 설정하고, 첫 번째 레코드를 각 파일의 헤더로 추가하는 옵션을 켜면 된다. 그러면 각 파일은 데이터 999건과 헤더 1행을 합쳐 최대 1,000레코드가 된다.

이 제한이 freee의 모든 CSV 가져오기에 적용되는 것은 아니다. 대상은 freee販売의 상품 정보(상품 마스터) 가져오기다. 공식 가져오기·내보내기 안내에 따르면 헤더를 포함해 1,000행까지 허용된다. 내보내기에는 행 수 제한이 없어, 내보낸 큰 CSV를 그대로 다시 가져올 수 있는 것은 아니다. 이 사양은 2026년 11월 21일에 확인했다.

CSV 분할 도구의 화면은 현재 일본어다. 아래에는 실제 화면의 일본어 항목명과 한국어 뜻을 함께 적었다.

데이터 999건과 헤더를 별도로 설정하기

원본 CSV는 보관하고, 공식 템플릿과 필드 정의에 맞춰 데이터를 준비한다. 분할 도구는 열 이름이나 값을 freee 형식으로 변환하지 않는다.

  1. CSV 분할 도구를 열어 分割するCSV / TSV(분할할 CSV/TSV)에서 파일을 선택한다.
  2. 区切り文字(구분 문자)를 カンマ(CSV)(쉼표)로 설정한다. 先頭プレビュー(文字コードを確認)(앞부분 미리보기)를 열어 일본어 문자와 열 구분이 정상인지 확인한다. 글자가 깨지면 入力文字コード(입력 문자 인코딩)를 실제 파일에 맞춘다.
  3. 分割方法(분할 방식)에서 データ行数の上限(데이터 행 수 상한)을 선택하고, 1ファイルの最大データ行数(파일당 최대 데이터 행 수)에 999를 입력한다.
  4. 先頭レコードをヘッダとして各ファイルに付ける(첫 레코드를 각 파일의 헤더로 추가)를 켠다. 이때 999건에 헤더는 포함되지 않는다.
  5. 인코딩을 바꿀 필요가 없는 UTF-8 CSV라면 出力文字コード(출력 인코딩)를 入力と同じ(BOMの有無も保持)(입력과 동일, BOM 상태 유지)로 둔다. 공식 UTF-8 BOM 템플릿과 일치시켜야 한다면 UTF-8(BOMあり)(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건씩 분할하면 다음 두 파일이 나온다.

파일명 데이터 건수 헤더 포함 레코드 수 상품 코드 범위
products_part_000001.csv 999 1,000 0001~0999
products_part_000002.csv 2 3 1000~1001

두 번째 파일도 첫 줄은 동일한 헤더다. 헤더 추가를 잊거나 데이터 상한을 1,000으로 설정해 헤더까지 1,001레코드가 되지 않도록 주의한다.

이 예제에는 셀 안의 줄바꿈이 없다. 도구가 세는 것은 CSV 레코드 수이며, 따옴표로 감싼 셀 안의 줄바꿈을 별도 레코드로 세지 않는다. 다만 freee가 모든 셀 내 줄바꿈을 받아들인다는 보장은 없으므로 가져오기 미리보기에서도 확인한다.

앞자리 0과 빈칸의 의미는 따로 확인한다

분할 도구는 숫자·날짜 형식으로 변환하지 않으므로 0001은 분할 후에도 0001이다. 하지만 스프레드시트 프로그램에서 다시 열고 저장하면 숫자로 변환될 수 있다. 코드 열은 텍스트로 가져오거나 CSV를 텍스트 편집기로 확인한다. 이미 사라진 0을 되살리는 기능은 아니다.

freee 가져오기에서는 기존 상품과 코드가 같으면 갱신하고, 일치하지 않으면 새 상품을 등록할 수 있다. 또한 열을 통째로 생략하는 것과 열은 두되 값을 비워 두는 것은 다르다. 갱신 시 처리 방식은 항목마다 다르므로 공식 필드 표를 확인한다. 파일 분할이 성공했다고 곧바로 실데이터에 가져와서는 안 된다.

freee 미리보기에서 확인한 다음 가져오기

freee販売의 商品一覧(상품 목록)에서 ・・・ → CSVインポート(CSV 가져오기)로 이동한다. 분할 파일을 선택하고 プレビュー画面へ(미리보기 화면으로)에서 건수뿐 아니라 상품 코드, 이름, 갱신할 값도 확인한다. 잘못됐다면 원본을 수정해 다시 분할하고 이전 출력과 섞지 않는다.

이 글은 가상의 데이터로 설명하며 실제 freee販売 환경에서 가져오기까지 검증한 것은 아니다. 필수 열, 권한, 입력값 조건은 공식 안내를 우선하고 실행 후 결과도 확인한다. iXam CSV 분할 도구는 freee의 공식 제품이 아니며 양측의 제휴를 의미하지 않는다.