BカートのCSVインポート完全ガイド｜大量商品登録を効率化
2026.03.12
BtoB ECサイトは、取引先ごとに扱う品目が多くなりがちだ。商品数が多い卸売業では、管理画面からの手入力が商品登録の負担になりやすい。
Bカートでは、商品・会員・在庫情報をCSVで登録・更新できる。受注情報のインポートは有料オプションで、受注詳細では受注商品をCSVで追加できる。本記事ではテンプレートの選び方から文字コードの確認、商品画像をCSVで扱う際の確認事項、基幹システムとの連携パターンまで、運用で確認したい点をまとめた。
商品登録の手入力に限界を感じたら
BtoB ECサイトは、取引先ごとに扱う品目が多くなりがちだ。商品数が多い卸売業では、管理画面からの手入力が商品登録の負担になりやすい。
Bカートでは、商品・会員・在庫情報をCSVで登録・更新できる。受注情報のインポートは有料オプションで、受注詳細では受注商品をCSVで追加できる。このうち最も使う頻度が高いのが商品マスタと在庫データのインポートで、日常的な価格変更や在庫更新にも使える。
本記事では、公式マニュアルとあわせて確認したいCSV運用上の注意点を、テンプレートの選び方、文字コード、商品画像の確認事項、基幹システムとの連携パターンの順に整理する。
CSVインポートで扱えるデータ
Bカートが対応するCSVインポートの全体像を整理する。
商品マスタのインポートは、新規登録と一括更新の両方に使える。商品コード（品番）をキーにして、既存の商品コードと一致すれば更新、一致しなければ新規登録される。商品名、販売価格、説明文、カテゴリ、画像パスなど、ほぼすべての項目をCSVから設定できる。
在庫データのインポートには2つの方式がある。「洗い替え方式」はCSVに書かれた在庫数で上書きする。「入荷実績方式」は現在の在庫数にCSVの数値を加算する。期首の棚卸で全在庫を書き換えるなら洗い替え、入荷のたびに加算するなら入荷実績を選ぶ。
会員データのインポートは、取引先の一括登録に使う。BtoB ECではサイト公開前に既存の得意先を数十社から数百社まとめて登録するケースが多い。会社名、担当者名、メールアドレス、会員グループ（価格グループ）を一括で流し込める。
受注データのインポートは有料オプションだ。電話やFAXで受けた注文をBカートの受注管理に統合したい場合に使う。受注商品のインポートは、受注詳細画面から既存の受注に対して商品をCSVで追加する機能。出荷情報については、公式ガイド上ではCSVエクスポート機能が案内されている。
テンプレート選びで迷わない
商品CSVのインポート画面を開くと、用途別のテンプレート（雛形）がダウンロードできる。初見では違いが分かりにくいが、用途に応じて使い分ける。
「かんたん新規登録」は、最小限の項目で素早く商品を登録するためのテンプレートだ。商品コード、商品名、販売価格など基本項目だけが並んでおり、初めてCSVインポートを使う場合の練習にもいい。
「全項目」テンプレートは、すべての設定項目が含まれた完全版だ。説明文（HTML対応）、メタ情報、公開/非公開フラグ、削除フラグまで入っている。大量の商品を一括で登録する本番作業では、このテンプレートを使って全項目を制御するのが安全だ。
「基本情報更新【必須のみ】」は、既存商品の価格やカテゴリを変更するときに使う。商品コードと更新したい項目だけを記入すればいい。全項目テンプレートで更新すると、空欄の項目が上書きされてデータが消えるリスクがある。更新作業には必ず「更新用」テンプレートを使うこと。
「セット情報登録」と「セット情報更新」は、商品バリエーション（カラーやサイズ違い）を管理するSKUデータ用だ。基本情報とセット情報は別のCSVに分ける設計になっている。1つのCSVにまとめることはできない。
注意: 古いテンプレートの使い回しはNG
テンプレートは必ず管理画面から最新版をダウンロードする。過去に使用したCSVは、現在の仕様と一致しない場合にインポートに失敗することがある。利用前に最新の雛形と照合する。Bカートの仕様がアップデートされると項目が追加・変更される場合があるため、「前回使ったCSVをコピーして使い回す」のは避けたほうがよい。
文字コードを最初に確認する
BカートのCSVインポートで起きやすいトラブルが文字化けだ。原因は文字コードの不一致にある。
文字コードの仕様は、利用中のCSV種別の仕様書と管理画面からダウンロードした雛形で確認する。文字化けした場合は、公式ガイドにあるShift-JISでの確認方法も試すとよい。
文字コードが合わない状態でインポートを実行しても、Bカート側でエラーが出ずに文字化けした状態で登録されてしまうことがある。インポート後は必ず管理画面で数件の商品データを目視確認する習慣をつけること。
商品CSVの書き方
テンプレートの中身を見ていく。必須項目は商品コード（品番）だ。この値が既存商品と一致すれば更新、一致しなければ新規登録になる。商品コードの命名ルールは自由だが、基幹システムの品番と揃えておくと連携が楽になる。
商品名、販売価格、説明文は任意項目だが、新規登録なら当然必要だ。説明文にはHTMLタグを直接記述できる。箇条書きやリンク、太字などをCSVの段階で仕込んでおけば、登録後に管理画面で1つずつ編集する手間が省ける。ただし、セル内にカンマが含まれる場合はダブルクォーテーションで値を囲むこと。HTMLタグにはカンマが入りやすいため、囲み忘れると列がずれる。
カテゴリはBカート上のカテゴリ名をそのまま記入する。存在しないカテゴリ名を書いてもエラーにはならないが、どのカテゴリにも属さない商品として登録される。事前にカテゴリをBカートの管理画面で作成しておき、正確な名称をCSVに反映する必要がある。
削除を伴う操作に注意
削除を伴うCSV操作は、対象CSVの仕様書を確認したうえで行う。誤って削除すると取り返しがつかないため、事前に商品データをエクスポートしてバックアップしておくこと。
商品画像をCSVで扱う際の確認事項
商品画像のCSV登録可否、URL指定方法、対応形式・容量は、商品インポート仕様書の最新記載に従う。仕様書を確認せずに独自の形式で画像列を埋めると、画像なしの状態で商品が登録されることがある。インポート後は管理画面で画像の表示を確認すること。
バリエーション商品の登録
BtoB ECではカラー展開やサイズ展開がある商品も多い。Bカートではこれを「セット情報」として管理する。
基本情報のCSVとセット情報のCSVは別ファイルだ。まず基本情報のCSVで親商品を登録し、その後でセット情報のCSVにSKUコード、カラー、サイズ、各SKUの在庫数や価格を記入してインポートする。
セットIDはシステムが自動採番するが、CSVでBカートセットIDを明示的に指定することもできる。基幹システムとの連携でSKU単位のIDを統一したい場合は、自社のSKUコードを指定する方が管理しやすい。
セット情報のCSVで最も注意すべきは行のずれだ。SKUと商品を対応付ける列の一部だけを移動・並べ替えすると、紐付けが崩れ、別の商品に別のSKUが紐付くおそれがある。加工後はインポート前に対応関係を確認すること。
在庫CSVインポートの使い分け
在庫のCSVインポートには「洗い替え方式」と「入荷実績方式」の2つがある。混同すると在庫数が狂うため、使い分けを正しく理解しておく必要がある。
洗い替え方式は、CSVに書かれた在庫数でBカートの在庫を上書きする。品番、在庫数、在庫制限の3項目が必須だ。月初の棚卸結果を一括で反映する、基幹システムの在庫マスタと週次で同期する、といった用途に向いている。
入荷実績方式は、現在の在庫数にCSVの数値を加算する。品番と在庫数の2項目だけで動作する。入荷のたびに「入荷数だけ」をCSVに書いてインポートする運用だ。同一品番を複数行に書くと、すべて加算される。
在庫無制限に設定されている商品と参照商品は、在庫インポートの対象外になる。これは仕様であり、エラーも出ない。対象外の商品がCSVに含まれていても単にスキップされるだけだ。在庫無制限の商品が多い場合、「インポートしたのに在庫が変わらない」と混乱するケースがある。
基幹システムとの連携パターン
Bカートを単体で運用する中小企業は少数派で、多くの企業は販売管理システムやERPと在庫・受注データを連携させている。CSVは最もシンプルな連携方法だ。
手動CSV連携は、担当者が基幹システムからCSVをエクスポートし、必要に応じて加工してBカートにインポートする方式。更新頻度が低く、品目数が少ない場合に向く。
Bカートにはカスタムフォーマットのマッピング機能がある。基幹システムが出力するCSVの列構成がBカートと異なっていても、一度マッピングを設定すれば基幹システム側のフォーマットのまま取り込める。特に受注CSVのインポートでは、電話やFAXで受けた注文を基幹システム経由でBカートに流し込む際に重宝する。
さらに自動化を進めるなら、BカートはAPI・Webhookや、公式アプリストア掲載の連携サービスを利用した外部連携に対応している。対象システム、連携方向、追加費用は各サービスの最新仕様を確認する。kintoneとの連携はBカート×kintone連携の記事で解説している。
よくあるエラーと回避策
CSVインポートで発生しやすいエラーを6つ挙げる。
- 文字コード問題。文字コードが合わないと文字化けする。利用中のCSV種別の仕様書と管理画面の雛形で文字コードを確認すること。
- カンマを含む値の列ずれ。商品説明文やHTMLタグにカンマが入っていると、CSVの区切り文字として解釈されて列がずれる。カンマを含む値はダブルクォーテーションで囲む。
- 画像列の指定ミス。画像の指定方法は商品インポート仕様書の最新記載に従う。仕様と異なる値を入れると画像が表示されない。
- Excelによる数値変換。電話番号の先頭ゼロが消える、長い数値が指数表記になるのはExcelの自動変換が原因だ。CSVを直接Excelで開くのではなく、「データ」タブの「テキストファイルのインポート」から開いて、該当列を「文字列」として読み込む。
- 在庫無制限商品のスキップ。在庫インポートは在庫無制限商品を更新しない仕様だ。エラーが出ずに黙ってスキップされるため、更新漏れに気づきにくい。在庫無制限の商品は別途管理画面から個別に更新する。
- バックアップの未取得。これはエラーではなく運用ミスだが、最も被害が大きい。インポート前のエクスポートを作業手順に必ず組み込むこと。
CSVインポートの実践チェックリスト
大量の商品データをインポートする際の作業手順をまとめる。
インポート前の準備として、管理画面から最新のテンプレートをダウンロードする。既存データのエクスポートを実行してバックアップを保存する。画像を登録する場合は、商品インポート仕様書で指定方法を確認しておく。
CSVの作成では、仕様書と雛形で確認した文字コードで保存する。カンマを含む値はダブルクォーテーションで囲む。画像列は仕様書どおりに指定する。バリエーション商品は基本情報とセット情報を別CSVに分ける。
インポート実行後は、管理画面でエラー表示を確認する。エラーがなくても、登録された商品を5件から10件ピックアップして目視で確認する。商品名の文字化け、画像の表示、価格の正確さ、カテゴリの紐付けを見る。
初回のインポートで全件を一気に流し込むのではなく、まず10件程度のテストデータで試すことを推奨する。テストで問題がなければ本番データを投入する。このひと手間が、数千件の登録をやり直す事態を防ぐ。
よくある質問
BカートのCSVで文字化けした場合はどうすればよいですか
文字コードの仕様は、利用中のCSV種別の仕様書と管理画面からダウンロードした雛形で確認してください。文字化けした場合は、公式ガイドにあるShift-JISでの確認方法も試してください。
1回のCSVで何件まで取り込めますか
1回に取り込める件数の上限は、対象CSVの最新仕様書またはBカートサポートで確認してください。
画像はCSVに添付できますか
商品画像のCSV登録可否、URL指定方法、対応形式・容量は、商品インポート仕様書の最新記載に従ってください。
在庫の洗い替え方式と入荷実績方式の使い分けは？
棚卸で在庫を上書きするなら洗い替え方式、入荷のたびに在庫を加算するなら入荷実績方式です。方式を取り違えると、意図しない上書きや加算によって在庫数が不正確になるため、運用ルールを事前に明確にしてください。
CSVで商品を削除する際の注意点は？
削除を伴うCSV操作は、対象CSVの仕様書を確認したうえで、事前に商品データをエクスポートしてバックアップしてください。
BカートのCSV運用・基幹連携でお困りなら
Bカート公式パートナーの株式会社Cravalが、CSVテンプレート設計から販売管理・在庫システムとのAPI連携まで一気通貫で支援します。商品データ移行・大量登録の代行もご相談ください。
無料で相談する