投稿者 投稿日: カテゴリー EC・WEBノウハウ
「カラーミーショップの顧客CSV移行とは、顧客一覧を規定19項目のCSVで書き出し・整形して登録し直す作業のことです。」
カラーミーショップで顧客データを別の管理環境へ移したり、リニューアル後のショップへ取り込み直したりする場面では、必ずCSVのフォーマット調整が発生します。この記事では、カラーミーの顧客CSVが持つ19項目の仕様を整理し、書き出しから整形、アップロードまでの手順を順番に追いかけます。今回の更新では、文字数オーバーや項目数ズレといった「登録できない」原因の切り分けに加えて、ChatGPTやClaude、Geminiで重複の名寄せや表記ゆれのクレンジングを下処理する手順を新しく足しました。手作業でセルを1つずつ直していた工程を、AIに下書きさせて人が確認する流れに置き換える前提で読み進めてください。
カラーミーショップの顧客CSVとは何を指すか
カラーミーショップの顧客CSVは、ショップに登録された会員情報を表形式で書き出し・取り込みするためのファイルです。エクスポートすれば顧客一覧をExcelやスプレッドシートで扱え、規定のフォーマットに沿って整えたCSVをインポートすれば、まとめて顧客を登録・更新できます。
現場でこの作業が必要になるのは、たとえば次のような場面です。実店舗やイベントで集めた会員リストをショップに反映したいとき。別のカートからカラーミーへ乗り換えて、過去の顧客を移したいとき。逆に、カラーミーから別環境へ顧客を持ち出したいとき。いずれも「人が読める表」と「システムが読み込めるCSV」の間を行き来する作業で、ここでつまずく店舗が多く見られます。
ALSELが支援する店舗群でも、移行作業そのものより「項目数が合わない」「文字化けした」「特定の顧客だけ登録されない」といった登録エラーの切り分けに時間を取られるケースが目立ちます。仕様を先に押さえておくと、こうした手戻りを大きく減らせます。なお、カラーミーの費用体系を合わせて確認したい場合は、カラーミーショップの手数料解説で月額利用料や決済手数料の内訳をまとめています。
書き出すCSVの19項目と文字数の上限
カラーミーの顧客CSVは項目数が19個で固定されています。この数は変更できず、列を足したり削ったりするとアップロード時に弾かれます。各列の意味と上限は次のとおりです（2026年5月時点の確認値。最新仕様は管理画面のヘルプで再確認してください）。
A列は名前で、必須項目です。50バイト、全角25文字以内とします。B列はフリガナ、C列は法人名・会社名、D列は部署名で、いずれも同じく50バイト・全角25文字以内です。E列は郵便番号で、半角数字7桁（例：1000000）で入れます。F列は都道府県で、後述の都道府県コードを数字で指定します。G列は市区町村番地、H列は建物名などのその他住所です。
I列はメールアドレスで、こちらも必須です。255文字以内の半角英数字で入れ、ここが重複しているとアップロードに失敗します。J列は電話番号、K列はFAX番号、L列は携帯電話番号で、半角の数字・ハイフン・丸括弧のみが使えます。M列は性別で、「男性」「女性」または0が男性・1が女性という指定です。値を入れなければ「男性」として登録されます。
N列は生年月日で、半角英数字で1975/1/1のように入れます。O列はHPアドレス、P列はメルマガ受信可否です。Pは「受信する」「受信しない」または0が受信する・1が受信しないで、未指定の場合は「受信しない」で登録される点に注意してください。Q列・R列・S列はフリー項目1〜3で、各255バイト・全角約127文字以内です。
つまり必須はA列名前とI列メールアドレスの2つで、残り17項目は任意です。ただし項目の「数」は19個ぴったりに揃える必要があるため、使わない列も空のまま残します。一度に登録できる件数は1000件まで、アップロードできるファイルの最大サイズは15MBが目安です。1000件を超える場合はファイルを分割します。
都道府県コードと文字加工の注意点
F列の都道府県は都道府県名そのものではなく、1〜49の数字で指定します。北海道が1、青森県が2と続き、沖縄県が47、海外が48、離島部が49という割り当てです。元データに「東京都」のような文字列が入っている場合は、ここでコードに置き換える変換が必要になります。
データ加工で最も事故が起きやすいのが、カンマ・改行・ダブルクォーテーションの扱いです。CSVはカンマで列を区切る形式なので、住所や備考にカンマや改行が含まれていると、システムが列の境目を誤認します。対策として、これらの文字を含むデータはダブルクォーテーション「”」で囲みます。ダブルクォーテーション自体をデータとして登録したい場合は、重ねて指定します。たとえば「1″2」というデータは「1″”2」と書きます。Excelで作成・保存する場合はこの処理が自動で行われるため、Excel経由で書き出すのが安全です。
文字コードはSHIFT-JISを指定するのが基本です。UTF-8のままアップロードすると、日本語が文字化けして登録される、あるいはエラーになることがあります。加工が終わってCSVに変換したあとは、そのファイルを再度開かないでください。Excelで開くと郵便番号の先頭ゼロが消える、日付の表記が勝手に変わるといった崩れが起き、せっかく整えたデータが壊れます。最終CSVは開かずにそのままアップロードするのが鉄則です。
カラーミーから別環境への移行と取り込み手順
ここでは、カラーミーの顧客データを整えて登録し直す、あるいは別カートやリニューアル後のショップへ移す流れを順番に追います。
最初に、雛形となるサンプルCSVを用意します。カラーミーの管理画面の顧客管理から、規定フォーマットのサンプルCSVをダウンロードできます。19項目の並び順がそこに入っているので、これを土台にします。ゼロから列を組むより、サンプルの1行目（ヘッダー）をそのまま使ったほうが項目数ズレを防げます。
次に、移行元のデータをこの雛形に流し込みます。別カートから書き出した顧客データや、手元のExcelリストを、サンプルCSVの列順に並べ替えます。このときF列の都道府県を数字コードに変換し、各列の文字数上限を超えていないか確認します。法人名や部署名が全角25文字を超えていると、その行だけ登録に失敗するため、超過分はあらかじめ詰めます。
整形が終わったら、Excelの「名前を付けて保存」でCSV形式（SHIFT-JIS）として書き出します。そのうえで、カラーミーの管理画面から顧客の一括登録（インポート）を開き、作成したCSVをアップロードします。アップロード後はエラー表示の有無を確認します。エラーが出た場合は失敗理由をダウンロードできるので、どの行のどの項目が原因かを特定して修正し、再アップロードします。別環境へ持ち出す場合も考え方は同じで、移行先サービスが求める列順・文字コードに合わせて、書き出したCSVを変換してから取り込みます。Shopifyやその他のカートはそれぞれ独自の顧客CSVフォーマットを持つため、カラーミーの19項目をそのまま流用せず、移行先の項目名にマッピングし直す点だけ注意してください。
作業の精度を上げるなら、本番アップロードの前にテスト登録を挟むのが安全です。整形済みデータから5件ほど抜き出して小さなCSVを作り、それだけを先にアップロードします。ここで通れば、列順・文字コード・必須項目の設計は正しいと判断できます。1000件を一気に流して全件エラーになると、原因の特定に時間がかかるうえ、途中まで登録された場合は重複の整理まで発生します。少数で型を確かめてから本番に進む流れにすると、手戻りがほとんど出ません。
ファイルを分割する場合は、ヘッダー行（1行目の項目名）を各ファイルに必ず付け直します。データだけを切り出してヘッダーを忘れると、先頭の顧客が項目名として扱われて登録から漏れます。分割の単位は1ファイルあたり数百件にとどめると、どのファイルでエラーが出たかを追いやすくなります。
移行前にやっておくデータ棚卸し
CSVを整形する前に、移行元データの状態を一度棚卸ししておくと、後工程のエラーが目に見えて減ります。チェックすべきは大きく3つです。
1つ目は重複です。同じ顧客が複数行に分かれていないか、特にメールアドレスの重複を先に潰します。カラーミーはI列メールアドレスの重複を許さないため、重複が残っているとその行はまとめて弾かれます。実店舗とオンラインで別々に集めた会員リストを合算するときは、ここが最大の落とし穴になります。
2つ目は表記ゆれです。都道府県名の全角・半角、姓名の間のスペースの有無、法人名の「株式会社」と「（株）」の混在などが代表例です。表記がばらついたまま移行すると、移行後にセグメント配信や検索をかけたときに同じ属性の顧客がうまくまとまりません。CSV移行は単なる引っ越しではなく、顧客マスタを整える機会でもあるという視点で臨むと、移行後の運用が楽になります。
3つ目は欠損と桁あふれです。必須のA列名前・I列メールアドレスが空の行を洗い出し、名前や法人名が全角25文字を超えていないか、郵便番号が7桁そろっているかを確認します。この棚卸しを目視と関数だけでやると時間がかかるため、次の章のAI活用が効いてきます。
登録がうまくいかないときの切り分け
アップロードで多いエラーが「項目数が異なります。項目数を19個に合わせてください。」という表示です。これは列の数がずれているサインで、列を削りすぎたか、加工中に余計な列が増えたかのどちらかです。サンプルCSVのヘッダー行と自分のファイルの列数を見比べると原因が早く見つかります。
文字化けが起きたときは、保存時の文字コードを疑います。MicrosoftのExcelで作成した場合は、書き出し時の文字コードをSHIFT-JISに指定し直して保存し直します。特定の顧客だけ登録されないときは、I列メールアドレスの重複か、必須項目（名前・メールアドレス）の空欄を確認します。郵便番号や日付が崩れているときは、最終CSVを一度開いてしまった可能性が高いので、加工済みの大本のExcelから書き出し直すのが確実です。
AIで顧客CSVのクレンジングと名寄せを下処理する
ここからが今回の更新の核です。19項目への整形・都道府県コード変換・表記ゆれの統一・重複の名寄せといった単純作業は、ChatGPTやClaude、Geminiに下書きをさせて人が最終確認する流れに置き換えられます。生成AIは確実な処理装置ではないため、出力は必ず目視で検算する前提で使ってください。個人情報を外部AIに渡すことになる点も踏まえ、社内ルールやプライバシーポリシーに沿って運用範囲を決めてから始めます。
最初に使えるのが、列マッピングの設計です。移行元のExcelの列名を貼り付けて、カラーミーの19項目にどう対応させるかをAIに整理させます。
あなたはEC事業者のデータ移行を支援するアシスタントです。
これからカラーミーショップの顧客CSV（19項目固定）に移行元データをマッピングします。
カラーミーの19項目の並び順は次の通りです。
A:名前 B:フリガナ C:法人名 D:部署名 E:郵便番号 F:都道府県(1〜49のコード)
G:住所(市区町村番地) H:住所(建物名など) I:メールアドレス J:電話番号
K:FAX番号 L:携帯電話番号 M:性別(男性/女性) N:生年月日 O:HPアドレス
P:メルマガ受信可否(受信する/受信しない) Q:フリー項目1 R:フリー項目2 S:フリー項目3
移行元データの列名は次の通りです。
{ここに移行元の列名を貼り付け}
出力フォーマット:
- 移行元の各列が、カラーミーのどの列に対応するかを一覧で示す
- 対応先が無い列は「対応なし(Qなどのフリー項目に退避を検討)」と明記
- 都道府県名→コード変換が必要な列を指摘
- 文字数上限を超える恐れがある列を指摘
次に、表記ゆれの統一と都道府県コードへの変換です。実データの一部を貼り付けて、変換ルールと変換後のサンプルを作らせます。
あなたはデータクレンジングの担当者です。
以下の顧客データについて、カラーミーショップの顧客CSV仕様に合わせて整形ルールを作ってください。
仕様:
- 都道府県は1〜49の数字コードに変換(北海道=1 … 沖縄県=47 海外=48 離島部=49)
- 名前・フリガナ・法人名・部署名は全角25文字以内
- 電話/FAX/携帯は半角の数字・ハイフン・丸括弧のみ
- メールアドレスは255文字以内の半角英数字、重複は不可
- 性別は「男性」「女性」、メルマガ受信可否は「受信する」「受信しない」に統一
入力データ(一部):
{ここに実データを5〜10行貼り付け}
出力:
1. 適用すべき変換ルールの一覧
2. 上記入力を仕様に沿って整形した結果(列ズレを起こさないようカンマ・改行を含む値はダブルクォーテーションで囲む)
3. 文字数オーバーや重複メールなど、人の確認が必要な行を理由付きで指摘
3本目は、同一人物が複数行に分かれている重複の名寄せです。完全自動で消すのではなく、統合候補を提示させて人が判断する形にすると安全です。
あなたは顧客マスタの名寄せを支援するアシスタントです。
以下の顧客リストから、同一人物・同一世帯と思われる重複候補を抽出してください。
判定の手がかり:
- メールアドレスの一致(最優先)
- 氏名+電話番号の一致
- 氏名+住所の近似(表記ゆれを考慮)
入力データ:
{ここに顧客リストを貼り付け}
出力:
- 重複候補のグループごとに、対象行と一致理由を提示
- どの行を残すべきか(情報が最も新しい・欠損が少ない)の推奨を1つ添える
- 自動で削除はせず、人が最終判断する前提で「要確認」フラグを付ける
これらのプロンプトで作った変換ルールやマッピング表を手元に置き、実ファイルの加工はExcelやスプレッドシートで行うのが現実的です。AIの出力をそのままCSVに貼り付けるのではなく、ルールを受け取って自分で適用し、結果をAIに再チェックさせる二段構えにすると精度が安定します。生成AIをECの文章作成にも広げたい場合は、ChatGPTで商品説明文を作るプロンプト集やEC運営で使えるAIツールまとめも合わせて参考にしてください。カラーミーからShopifyへの移行を視野にAI活用を検討している場合は、移行先の運用設計まで見据えて準備を進めると無駄が出ません。
よくある質問
カラーミーの顧客CSVは何項目で書けばいいですか
19項目で固定です。この数は変えられず、列を足したり削ったりするとアップロード時に「項目数が異なります」というエラーになります。使わない項目も空欄のまま19列を維持してください。必須はA列の名前とI列のメールアドレスの2つです。
一度に何件まで登録できますか
一度に登録できるのは1000件まで、アップロードできるファイルの最大サイズは15MBが目安です（2026年5月時点）。これを超える顧客数の場合は、CSVを複数ファイルに分割してから順番にアップロードします。
文字コードはどれを指定すればいいですか
SHIFT-JISを指定するのが基本です。UTF-8のままだと日本語が文字化けすることがあります。Microsoftのエクセルで作成した場合は、保存時に文字コードをSHIFT-JISに指定し直してください。
加工後のCSVを開いたらデータが崩れました。どうすればいいですか
最終CSVは開かないのが原則です。Excelで開くと郵便番号の先頭ゼロが消えたり、日付表記が変わったりします。崩れてしまった場合は、加工に使った大本のExcelファイルから、CSV形式（SHIFT-JIS）で書き出し直してください。
特定の顧客だけ登録されないのはなぜですか
最も多い原因はI列メールアドレスの重複です。同じメールアドレスは登録できません。次に多いのが必須項目の空欄（名前・メールアドレス）と、文字数上限のオーバー（名前や法人名が全角25文字超）です。アップロード後にダウンロードできる失敗理由を見ると、どの行のどの項目が原因かを特定できます。
AIに顧客データを渡しても大丈夫ですか
個人情報を外部の生成AIに渡すことになるため、社内ルールやプライバシーポリシーに沿って運用範囲を決めてから使ってください。実データを直接貼り付けるのが不安な場合は、列名やサンプルだけをAIに渡して変換ルールやマッピング表を作らせ、実ファイルの加工は手元のExcelで行う方法が安全です。AIの出力は必ず目視で検算してください。
Shopifyなど他のカートへそのまま移せますか
カラーミーの19項目フォーマットは他カートではそのまま使えません。Shopifyやその他のサービスはそれぞれ独自の顧客CSV仕様を持つため、移行先の項目名にマッピングし直し、文字コードや列順を移行先の要求に合わせて変換してから取り込みます。前述のAIによる列マッピングのプロンプトが、この対応付け作業の下書きに使えます。
著者：齋藤竹紘（株式会社オルセル 編集長／5,000社以上のEC支援実績／書籍3冊）
※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談（30分）も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/
株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。
この記事を読んだ人は、こんな記事も読んでいます
