スマレジ商品登録CSV｜フォーマット・手順・エラー対処

2026.06.02

スマレジの商品マスタを更新する作業で、最も使われるのがCSV一括登録です。100件・1,000件と商品が増えてくると、手動入力では現実的でなく、CSV運用が必須になります。一方で「文字化け」「フォーマットエラー」「重複エラー」など、現場担当者がつまずきやすいポイントも多い機能です。

結論から言うと、スマレジCSV運用の失敗の9割は「文字コード（UTF-8 BOM）」と「必須列の理解不足」に集約されます。本記事ではCSVフォーマット仕様、文字コードの正しい扱い、サンプルCSV、ありがちなエラー10種類と対処、APIでの自動登録までを実装担当者の視点で整理します。スマレジを運用するEC担当者・情報システム担当者・実装者向けの内容です。

スマレジ商品登録CSVの全体像

スマレジの商品登録CSVは、管理画面の「商品 > 商品インポート」から実行します。インポート方法は大きく3パターンあります。

初回マスタ投入なら「新規登録」、定期的な価格・在庫更新なら「上書き更新」、ECサイトとの同期なら「新規＋更新」を使い分けるのが標準的な運用です。

CSVフォーマット仕様（必須列・任意列）

スマレジ商品CSVには必須列と任意列があります。最小構成は「商品コード」「商品名」「価格」の3列ですが、業態に応じて任意列も活用することになります。

これらに加えて、業態別オプション列（食品なら賞味期限、アパレルならサイズ・カラー）が追加できます。実際の列名は管理画面の「インポート > テンプレートダウンロード」で取得するのが確実です。スマレジ側のバージョンアップで列が追加されることもあるため、テンプレートは最新版を使うことを推奨します。

文字コードと改行コードの落とし穴

スマレジCSV運用で最頻のトラブルは、文字コードと改行コードに起因する文字化け・取込失敗です。これらは事前に正しく設定しておけば必ず防げる問題です。

最も多いのが「Excelで普通にCSV保存→文字化け」のパターンです。Excelは標準でShift_JISでCSV保存するため、スマレジで読み込むと日本語が「???」や「縺ｪ縺?」のように化けます。対処は次項のフロー参照。

CSV作成から取込完了までの手順

実際にCSVを作成してスマレジに取り込む標準フローです。Excel→CSV変換時の落とし穴も含めて整理しました。

失敗を最小化するコツは「いきなり全件取込せず、必ず少量データでテストする」「商品コード重複は事前チェックする」の2点です。1,000件以上を一発で取り込んで失敗すると、修正・再取込で半日溶けることがあります。

サンプルCSVと実装例

実際のCSVがどう見えるか、最小構成と標準構成のサンプルを示します。

最小構成（3列）のサンプル：

商品コード,商品名,価格
P-001,オリジナルマグカップ,1500
P-002,コットンTシャツ Mサイズ,2980
P-003,ロゴステッカー（5枚セット）,500

標準構成（よく使う列のサンプル）：

商品コード,商品名,価格,カテゴリコード,JAN,税区分,在庫管理対象,有効フラグ
P-001,オリジナルマグカップ,1500,CAT-KITCHEN,4901234567890,1,1,1
P-002,コットンTシャツ Mサイズ,2980,CAT-APPAREL,4901234567891,1,1,1
P-003,ロゴステッカー（5枚セット）,500,CAT-NOVELTY,4901234567892,1,0,1
P-004,輸入オーガニックティー,1200,CAT-FOOD,4901234567893,2,1,1

カンマや改行を含む商品名・商品説明は、ダブルクォートで囲みます。

商品コード,商品名,商品説明
P-005,"和菓子 詰合せ, 5種類","季節の和菓子5種を詰め合わせました。
化粧箱入り、贈答用にも最適です。"

よくあるエラー10種類と対処

スマレジCSV取込でよく出るエラーと対処法を整理します。エラーメッセージの内容によって対処が異なるため、ログを保存しておくことが重要です。

取込時の進捗画面でエラー詳細CSVがダウンロードできるため、それを元に該当行を修正して再取込する流れになります。

APIでの自動登録

商品登録を自動化したい場合、CSVではなくスマレジ Developers APIを使う選択肢があります。プレミアム以上のプランで利用可能で、外部システムから直接登録・更新できます。

API実装の概要は次のとおりです（Python例）：

import requests

# 認証
auth_url = "https://id.smaregi.jp/app/{contract_id}/token"
token = requests.post(auth_url, data={
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "scope": "pos.products:write"
}).json()["access_token"]

# 商品登録
api_url = f"https://api.smaregi.jp/{contract_id}/pos/products"
headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
payload = {
    "productCode": "P-001",
    "productName": "オリジナルマグカップ",
    "price": "1500",
    "categoryId": "10"
}
response = requests.post(api_url, headers=headers, json=payload)
print(response.json())

APIを使うとEC・基幹システム・PIM（商品情報管理ツール）と直接連携でき、CSVのような「人を介する」運用を排除できます。一方で実装・保守が必要になるため、運用規模・更新頻度・リアルタイム性のニーズで判断することになります。API仕様は スマレジ Developers で公開されています。

ExcelからCSVへの安全な移行手順

多くの店舗がExcelで商品マスタを管理していて、それをスマレジに移行するパターンが最も多いケースです。安全な移行手順は次のとおりです。

関連する記事として スマレジ費用｜料金プラン・初期費用・TCO比較 でAPI連携が可能なプラン（プレミアム以上）の費用を、スマレジクレジット連携できない で関連トラブルシューティングを確認できます。EC連携全般は BtoB ECサイト比較 も参考になります。スマレジ公式の最新ヘルプは スマレジヘルプセンター で確認可能です。

よくある質問

スマレジCSVの文字コードは何ですか？

スマレジ標準のCSVは「UTF-8（BOM付き）」です。ExcelからCSV保存すると標準で「Shift_JIS」になるため、そのままアップロードすると文字化けします。対処法は①Excelで「CSV UTF-8」形式を選んで保存、②保存後にメモ帳でUTF-8（BOM付き）に変換、③Googleスプレッドシートからダウンロードで自動UTF-8、のいずれかです。

スマレジ商品CSVに必須の列は何ですか？

最小必須は「商品コード」「商品名」「価格」の3列です。これらを欠くとエラーで取込失敗。任意列には「カテゴリ」「メーカー名」「在庫管理対象フラグ」「税区分」「バーコード（JAN）」「画像URL」「商品説明」などがあり、業態に応じて使い分けます。詳細は本文の仕様表を参照してください。

スマレジCSVで一度に何件まで登録できますか？

1ファイルあたり10,000件が上限の目安です。大量登録（10万件超）の場合は、ファイルを分割するか、APIで分割アップロードする方法を推奨します。ファイルサイズの上限は管理画面アップロードで30MB程度。CSVが大きい場合は事前にカテゴリ別・店舗別に分割するのが運用上スムーズです。

スマレジCSV取込でよく出るエラーは何ですか？

①文字化け（UTF-8 BOM未対応）、②商品コード重複、③価格が数値でない（カンマ含む等）、④必須列の欠落、⑤改行コードの混在（CR/LF混在）、⑥カテゴリコードが未登録、⑦在庫管理対象フラグの値違反、⑧画像URLの形式エラー、⑨税区分の値違反、⑩CSVの最終行に改行なし、が代表例です。詳細は本文の対処表を参照してください。

スマレジ商品登録をAPIで自動化できますか？

可能です。スマレジ Developers APIに「商品登録／更新API」が用意されており、JSONリクエストで1件ずつ or バッチで登録できます。プレミアム以上のプランでAPI利用可能。CSVアップロードと違い、外部システム（ECサイト・基幹システム・PIM）と直接連携でき、リアルタイム同期が可能。実装はPython・Node.js等のサーバーサイドコードで認証トークン取得後にPOSTする流れです。