CSVデータフォーマット

顧客管理アプリで使用するCSVファイルの詳細なフォーマット仕様について説明します。

📋 CSVファイルについて

アプリでは顧客データと来店履歴データの2種類のCSVファイルを扱うことができます。それぞれ異なるフォーマットを使用しますので、以下の仕様をご確認ください。

👥 顧客データCSVフォーマット

列番号 項目名 データ型 必須 説明 例
1 ID 数値 ○ 顧客の一意識別子 1
2 顧客名 文字列 ○ 顧客の氏名 田中花子
3 カード番号 文字列 会員カード番号（13桁、空欄可） 1234567890123
4 性別 文字列 男性・女性・その他（空欄可） 女性
5 備考 文字列 顧客に関するメモ（空欄可） リピーター様
6 登録日時 日時 ○ YYYY-MM-DD HH:MM:SS形式 2025-01-15 14:30:00
📝 顧客データCSVの例
ID,顧客名,カード番号,性別,備考,登録日時 1,田中花子,1234567890123,女性,リピーター様,2025-01-15 14:30:00 2,佐藤太郎,,男性,,2025-01-16 10:15:00 3,山田美咲,9876543210987,女性,初回来店時紹介,2025-01-17 16:45:00

📝 来店履歴データCSVフォーマット

列番号 項目名 データ型 必須 説明 例
1 ID 数値 ○ 来店履歴の一意識別子 1
2 顧客ID 数値 ○ 顧客データのIDと対応 1
3 顧客名 文字列 ○ 顧客の氏名（参考情報） 田中花子
4 カード番号 文字列 ○ 会員カード番号（13桁） 1234567890123
5 来店日時 日時 ○ YYYY-MM-DD HH:MM:SS形式 2025-01-15 14:30:00
6 施術内容 文字列 ○ 実施した施術の内容 全身マッサージ
7 個人指名 文字列 ○ 「あり」または「なし」 あり
8 備考 文字列 来店時のメモ（空欄可） リラックス重視
📝 来店履歴CSVの例
ID,顧客ID,顧客名,カード番号,来店日時,施術内容,個人指名,備考 1,1,田中花子,1234567890123,2025-01-15 14:30:00,全身マッサージ,あり,リラックス重視 2,1,田中花子,1234567890123,2025-01-22 15:00:00,フェイシャル,あり, 3,2,佐藤太郎,,2025-01-16 10:15:00,アロマトリートメント,なし,初回来店

⚠️ 重要な注意事項

⚠️ ファイル形式について
  • ファイルの文字エンコーディングは UTF-8 を使用してください
  • BOM（Byte Order Mark）付きのUTF-8にも対応しています
  • ファイル拡張子は .csv にしてください
  • カード番号は 13桁の数字 で入力してください
📋 データ形式について
  • 日時は「YYYY-MM-DD HH:MM:SS」形式で入力してください
  • 「YYYY/MM/DD HH:MM:SS」形式でも読み込み可能です
  • 個人指名は「あり」「なし」「true」「false」「1」「0」で入力できます
  • 空欄は空の文字列「""」またはセルを空にしてください
⚠️ インポート時の注意
  • 顧客データで同じカード番号の顧客が存在する場合、データが更新されます
  • 来店履歴をインポートする前に、対応する顧客データが登録されている必要があります
  • CSVのヘッダー行は必須です（1行目に項目名を記載）
  • すべての必須項目にデータが入力されていることを確認してください

📊 Excelで作成する場合の注意事項

💡 Excel保存時のポイント
  • 「名前を付けて保存」で「CSV UTF-8（コンマ区切り）」を選択してください
  • 単純に「CSV（コンマ区切り）」を選択すると文字化けする可能性があります
  • 日付セルの書式は「YYYY-MM-DD HH:MM:SS」に設定してください
  • カード番号は「文字列」形式で13桁の数字を入力してください（数値にすると先頭の0が消える場合があります）
📋 推奨手順
  1. アプリから一度CSVをエクスポートして、フォーマットを確認
  2. エクスポートしたファイルを参考にしてデータを入力
  3. UTF-8形式で保存してからアプリにインポート
  4. 少量のデータでテストしてから本格的にインポート