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

2026.06.02

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

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

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

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

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

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

スマレジ商品CSVには必須項目と任意項目があります。商品CSVでは、部門ID、商品コード、商品名、商品単価が必要です。商品IDは空欄の場合に自動採番されます。最新版の公式テンプレートをダウンロードして利用してください。

CSV列名・入力制約は独自に再定義せず、スマレジ管理画面からダウンロードする最新テンプレートと公式項目一覧に従ってください。スマレジ側のバージョンアップで列が追加されることもあるため、テンプレートは最新版を使うことを推奨します。

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

スマレジCSV運用で最頻のトラブルは、文字コードと改行コードに起因する文字化け・取込失敗です。文字コードと改行コードを取込設定に合わせることで、これらの不一致によるトラブルを減らせます。取込前には少量のデータで確認してください。

最も多いのが、取込時に選んだ環境とファイルの文字コードが合わずに文字化けするパターンです。CSV取込時は、スマレジ管理画面でPC環境に合わせ、Windows（Shift_JIS・CRLF）またはMac（UTF-8・LF）を選択します。Excelの「CSV UTF-8」は選択しないでください。手順は次項のフロー参照。

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

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

失敗を最小化するコツは「いきなり全件取込せず、必ず少量データでテストする」「商品コード重複は事前チェックする」の2点です。大量のデータを一度に取り込むと、失敗時の修正や再取込に時間がかかる場合があります。

サンプルCSVと実装例

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

必須項目のサンプル：

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

商品IDを空欄にした行は自動採番されます。部門IDは登録済みの部門を指定します。列名・列順は、管理画面からダウンロードした最新テンプレートに合わせてください。

カンマや改行を含む商品名・説明は、ダブルクォートで囲みます（以下は該当列の抜粋）。

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

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

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

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

APIでの自動登録

商品登録を自動化したい場合、CSVではなくスマレジ Developers APIを使う選択肢があります。API利用可否、認可方式、商品登録・更新の方式は、契約プランとスマレジDevelopersの現行API仕様を確認してください。

API実装の流れのイメージは次のとおりです（Python例）。エンドポイント・スコープ・項目名は、実装前に現行API仕様で確認してください。実行前に契約IDを設定し、認証URLと商品登録URLの両方に同じ値を埋め込んでください：

import requests

contract_id = "YOUR_CONTRACT_ID"  # スマレジの契約ID

# 認証
auth_url = f"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の考え方 でプランごとの費用を、スマレジクレジット連携できない で関連トラブルシューティングを確認できます。EC連携全般は BtoB ECサイト比較 も参考になります。スマレジ公式の最新ヘルプは スマレジヘルプセンター で確認可能です。

よくある質問

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

CSV取込時は、スマレジ管理画面でPC環境に合わせ、Windows（Shift_JIS・CRLF）またはMac（UTF-8・LF）を選択します。Excelの「CSV UTF-8」は選択しないでください。ファイルの文字コードと取込時の選択が合っていないと文字化けします。

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

商品CSVでは、部門ID、商品コード、商品名、商品単価が必要です。商品IDは空欄の場合に自動採番されます。任意項目には規格・説明・キャッチコピー・サイズ・カラー・タグ・URL等があります。最新版の公式テンプレートをダウンロードして利用してください。

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

件数・ファイルサイズの上限は、取込画面と公式ヘルプで最新の条件を確認してください。CSVが大きい場合は事前にカテゴリ別・店舗別に分割し、少量のテスト取込から始めるのが運用上スムーズです。

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

①文字化け（取込時の環境選択と文字コードの不一致）、②商品コード重複、③商品単価が数値でない（カンマ含む等）、④必須項目の欠落、⑤改行コードの混在（CR/LF混在）、⑥部門IDの指定誤り、⑦文字数超過（商品コード20文字・商品名85文字・説明1,000文字）、⑧税区分・在庫管理区分の値違反、が代表例です。詳細は本文の対処表を参照してください。

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

スマレジ Developers APIを使う方法があります。API利用可否、認可方式、商品登録・更新の方式は、契約プランとスマレジDevelopersの現行API仕様を確認してください。CSVアップロードと違い、外部システム（ECサイト・基幹システム・PIM）と直接連携でき、リアルタイム同期が可能。実装はPython・Node.js等のサーバーサイドコードで認証トークン取得後にPOSTする流れです。