CSV項目定義マニュアル
▼概要
このマニュアルでは、MOTENASUのCSVインポート機能で使用できる各項目の定義、制限、動作仕様を詳しく説明します。
対応CSV種別
- ユーザーCSV - 顧客・会員情報の登録・更新
- 商品CSV - 商品マスタの登録・更新
- 注文CSV - 注文データの登録・更新
- LINE連携CSV - LINE友だち情報の登録・更新
重要な注意事項
- CSVファイルの文字コードは UTF-8、Shift-JIS、Windows-31J (CP932) に対応していますが、UTF-8を推奨します（文字化けを防ぐため）
- CSVテンプレートに含まれない項目は更新対象外となり、既存データが保持されます
- CSVテンプレートに含まれていて空白の項目は、空白（NULL/空文字）として登録・更新されます
- 必須マークの項目が空の場合、該当行はエラーとなりスキップされます
▼ユーザーCSV項目定義
基本情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| リードコード(外部サイト用)文字 | 任意 | 60文字 |
説明: 外部システムで管理されているユーザーID 空の場合: 空白（NULL/空文字）で上書き 更新: この値で既存ユーザーを識別 |
| 氏名 (姓)文字 | 必須 | 80文字 |
説明: 氏名(姓) OR 氏名(名) - どちらか一方が必須 空の場合: 氏名(名)も空の場合はエラー 制限: 前後の空白は自動削除 |
| 氏名 (名)文字 | 必須 | 80文字 |
説明: 氏名(姓) OR 氏名(名) - どちらか一方が必須 空の場合: 氏名(姓)も空の場合はエラー 制限: 前後の空白は自動削除 |
| 氏名カナ (姓)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き 推奨: 全角カタカナ |
| 氏名カナ (名)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き 推奨: 全角カタカナ |
| 生年月日日付 | 任意 | - |
説明: 生年月日 (yyyyMMdd or yyyy/MM/dd or yyyy年MM月dd日 or yyyy-mm-dd) 空の場合: 空白（NULL/空文字）で上書き |
| 性別文字 | 任意 | - |
説明: 男性:m or 1 or 男 女性:f or 2 or 女 空の場合: CSV設定の「性別デフォルト値」で上書き |
| 血液型文字 | 任意 | - |
説明: A, B, O, AB のいずれか 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（年）数値 | 任意 | - |
説明: yyyy (半角数字4桁) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（月）数値 | 任意 | - |
説明: mm (半角数字2桁) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（日）数値 | 任意 | - |
説明: dd (半角数字2桁) 空の場合: 空白（NULL/空文字）で上書き |
連絡先情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| モバイル Eメール文字 | 任意 | 255文字 |
説明: 例:sample@ezweb.ne.jp 空の場合: 空白（NULL/空文字）で上書き |
| PC Eメール文字 | 任意 | 255文字 |
説明: 例:sample@example.com 空の場合: 空白（NULL/空文字）で上書き |
| メールアドレス(自動判別)文字 | 任意 | 255文字 |
説明: 例:sample@example.com 空の場合: 空白（NULL/空文字）で上書き |
| 電話番号文字 | 任意 | 13文字 |
説明: 例:09012345678 空の場合: 空白（NULL/空文字）で上書き |
住所情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 郵便番号文字 | 任意 | 7桁（ハイフン含む場合8文字） |
説明: 数字のみ（ハイフン可）、形式例: 1234567 または 123-4567 空の場合: 空白（NULL/空文字）で上書き |
| 地域文字 | 任意 | 255文字 |
説明: 例:東京都or東京 空の場合: 空白（NULL/空文字）で上書き |
| 地域詳細１文字 | 任意 | 255文字 |
説明: 市町村区・番地など 空の場合: 空白（NULL/空文字）で上書き |
| 地域詳細２文字 | 任意 | 255文字 |
説明: ビル・アパート・マンション名など 空の場合: 空白（NULL/空文字）で上書き |
| 国文字 | 任意 | 100文字 |
説明: 国名またはISO3166-1国名コード (例:日本orJP) 空の場合: 空白（NULL/空文字）で上書き |
企業・法人情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 法人名文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 法人名カナカナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| 部署名文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 部署名カナカナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| 法人・電話番号1文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
| 法人・FAX番号文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
| 法人・郵便番号文字 | 任意 | 7桁（ハイフン含む場合8文字） |
説明: 数字のみ（ハイフン可）、形式例: 1234567 または 123-4567 空の場合: 空白（NULL/空文字）で上書き |
| 法人・地域文字 | 任意 | 255文字 |
説明: 例:東京都or東京 空の場合: 空白（NULL/空文字）で上書き |
| 法人・地域詳細１文字 | 任意 | 255文字 |
説明: 市町村区・番地など 空の場合: 空白（NULL/空文字）で上書き |
| 法人・地域詳細２文字 | 任意 | 255文字 |
説明: ビル・アパート・マンション名など 空の場合: 空白（NULL/空文字）で上書き |
| WEBサイト文字 | 任意 | 255文字 |
説明: https://sample.jp 空の場合: 空白（NULL/空文字）で上書き |
| 役職名文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 法人・携帯番号文字 | 任意 | 13文字 |
説明: 例:09012345678 空の場合: 空白（NULL/空文字）で上書き |
| 法人・電話番号2文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
| 法人・電話番号3文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
購入情報・統計項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 総購入金額数字 | 任意 | - |
説明: 数字 空の場合: 空白（NULL/空文字）で上書き |
| 入金回数数字 | 任意 | - |
説明: 数字 空の場合: 空白（NULL/空文字）で上書き |
| サービスポイント数字 | 任意 | - |
説明: 数字 空の場合: 空白（NULL/空文字）で上書き |
ステータス・設定項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 測定コード文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 測定コード名文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 測定費用数字 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 管理者メモ文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| PC送信エラー文字 | 任意 | - |
説明: ok:送信OK,550:送信NG,552:送信NG 空の場合: 空白（NULL/空文字）で上書き |
| モバイル送信エラー文字 | 任意 | - |
説明: ok:送信OK,550:送信NG,552:送信NG 空の場合: 空白（NULL/空文字）で上書き |
| 本登録日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 初回入金日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 最終入金日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 初回アクセス日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 最終アクセス日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| ユーザエージェント文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| メール受け取り数値 | 任意 | - |
説明: 0:受け取らない 1:受け取る 空の場合: 空白（NULL/空文字）で上書き |
| DM受け取りフラグ数値 | 任意 | - |
説明: 0:受け取らない 1:受け取る 空の場合: 空白（NULL/空文字）で上書き |
| リード状態文字 | 任意 | 255文字 |
説明: 休止:休会or休止or休眠顧客 退会:退会 本登録:左記以外 空の場合: 空白（NULL/空文字）で上書き |
| ステージ１文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| ステージ２文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| ステージ３文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
カスタムフィールド項目
カスタムフィールドとは
MOTENASUの管理画面で事前に定義したカスタムフィールドをCSVでインポートできます。カスタムフィールドは、標準項目では足りない独自の情報を管理するための拡張項目です。CSVテンプレート設定で、任意の項目名（例：「アンケート1」「会員ランク」）を設定できます。
| 項目名 | 型 / 必須 | 設定例 | 説明・制限 |
|---|---|---|---|
| 任意の名称可変 | 任意 | アンケート1 会員ランク 購入回数 |
説明: CSVテンプレート設定で任意の項目名を設定し、カスタムフィールドにマッピングします データ型: 管理画面で定義したフィールドタイプに依存 空の場合: 既存のカスタムフィールド値が全削除されます 複数値: カンマ区切りで複数値を指定可能（checkbox、selectbox-multiple型） |
カスタムフィールドの重要な動作
- 全削除・全置換: CSVテンプレートに含まれるカスタムフィールドは、既存データを全削除してから新しい値で置き換えます
- 事前定義が必須: CSVインポート前に、MOTENASU管理画面でカスタムフィールドを定義しておく必要があります
- CSVテンプレート設定が必要: CSVテンプレート画面で、CSV項目名とカスタムフィールドのマッピングを設定してください
- フィールドタイプ: text（テキスト）、text-integer（数値）、textarea（長文）、timestamp（日時）、radio（ラジオボタン）、selectbox（セレクトボックス）、selectbox-multiple（複数選択）、checkbox（チェックボックス）
カスタムフィールドの例
outside_id,last_name,first_name,アンケート1,趣味 USER001,山田,太郎,満足,釣り,ゴルフ USER002,佐藤,花子,やや満足,読書
この例では、「アンケート1」（単一選択型）と「趣味」（複数選択型、カンマ区切り）をインポートしています。実際の項目名はCSVテンプレート設定で自由に設定できます。
フリーセグメント項目
フリーセグメントとは
フリーセグメントは、ユーザーを柔軟に分類するためのタグ機能です。1つの分類（classification）に対して、複数のセグメント値を設定できます。シナリオ配信やターゲティングに活用できます。CSVテンプレート設定で、任意の項目名（例：「会員ランク」「参加キャンペーン」）を設定できます。
| 項目名 | 型 / 必須 | 設定例 | 説明・制限 |
|---|---|---|---|
| 任意の名称文字列 | 任意 | 会員ランク 参加キャンペーン 興味関心 |
説明: CSVテンプレート設定で任意の項目名を設定し、フリーセグメント分類にマッピングします 複数指定: カンマ区切りで複数セグメント指定可能 例: VIP,ゴールド会員,キャンペーン対象 空の場合: 該当分類のセグメントが全削除されます 自動作成: 存在しないセグメント名は自動的に作成されます |
フリーセグメントの重要な動作
- 分類単位で上書き: CSVテンプレートに含まれる分類（例: 会員ランク）は、既存のセグメントを全削除してから新しい値で置き換えます
- 追加ではなく置き換え: 既存セグメント「VIP」を持つユーザーに「ゴールド会員」を指定すると、「VIP」は削除され「ゴールド会員」のみになります
- CSVテンプレート設定が必要: CSVテンプレート画面で、CSV項目名とフリーセグメント分類のマッピングを設定してください
フリーセグメントの例
outside_id,last_name,first_name,会員ランク,参加キャンペーン USER001,山田,太郎,VIP,キャンペーンA,キャンペーンB USER002,佐藤,花子,ゴールド会員,キャンペーンA
この例では、「会員ランク」（分類1）と「参加キャンペーン」（分類2、複数可）をインポートしています。実際の項目名はCSVテンプレート設定で自由に設定できます。
▼商品CSV項目定義
基本情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 商品ID(外部サイト用)文字 | 必須 | 255文字 |
説明: 文字 空の場合: エラー（必須項目） 更新: この値で既存商品を識別 |
| 商品の名前文字 | 必須 | 255文字 |
説明: 文字 空の場合: エラー（必須項目） |
| 商品の名前フリガナカナ | 任意 | 255文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き 推奨: 全角カタカナ |
| 商品カテゴリ名文字 | 任意 | 255文字 |
説明: 文字 (値1,値2,値3) 複数指定: カンマ区切りで複数指定可能 空の場合: 既存カテゴリを全削除 自動作成: 存在しないカテゴリ名は自動作成 |
| 商品コード文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| JANコード文字 | 任意 | 13文字 |
説明: 数字のみ、8桁または13桁（JAN-8、JAN-13に対応） 空の場合: 空白（NULL/空文字）で上書き |
| 商品連携用外部キー文字 | 任意 | 255文字 |
説明: 商品IDが重複している場合は連携用にこちらを用いて一意になるIDを指定してください (文字) 空の場合: NULL として登録 |
価格・在庫項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 商品単価数字 | 必須 | - |
説明: 数字 空の場合: エラー（必須項目） 範囲: 0以上 |
| 商品原価数字 | 任意 | - |
説明: 数字 空の場合: 空白（NULL/空文字）で上書き 範囲: 0以上 |
| 消費税率数字 | 任意 | - |
説明: 数字（0〜100） 範囲: 0〜100 空の場合: 空白（NULL/空文字）で上書き |
商品属性項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| セール商品数値 | 任意 | - |
説明: 0:通常商品 1:セール商品 空の場合: 空白（NULL/空文字）で上書き |
| 表示単位文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 内容量文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 商品種別数値 | 任意 | - |
説明: 0:通常商品 1:サンプル商品 2:定期商品 3:トライアル商品 4:セット商品 5:同梱物 空の場合: 空白（NULL/空文字）で上書き |
| 配送種別数値 | 任意 | - |
説明: 0:通常配送 1:冷蔵配送 2:冷凍配送 空の場合: 空白（NULL/空文字）で上書き |
| ポイント付与率数字 | 任意 | - |
説明: 数字(0～100) 空の場合: 空白（NULL/空文字）で上書き 範囲: 0～100 |
| AI学習数値 | 任意 | - |
説明: 0:学習する 1:学習しない 空の場合: 空白（NULL/空文字）で上書き |
商品説明・詳細項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 商品説明1文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 商品説明2文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 商品説明3文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 決済方法文字 | 任意 | 80文字 |
説明: 文字 (値1,値2,値3) 複数指定: カンマ区切りで複数指定可能 空の場合: 空白（NULL/空文字）で上書き |
| 備考文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
販売期間・URL・画像項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 販売開始日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 販売終了日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 商品URL文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 画像URL1文字 | 任意 | 255文字 |
説明: 文字 空の場合: 該当番号の画像を削除 対応形式: JPG, PNG, GIF, WebP |
| 画像URL2文字 | 任意 | 255文字 |
説明: 文字 空の場合: 該当番号の画像を削除 |
| 画像URL3文字 | 任意 | 255文字 |
説明: 文字 空の場合: 該当番号の画像を削除 |
| 画像URL4文字 | 任意 | 255文字 |
説明: 文字 空の場合: 該当番号の画像を削除 |
| 画像URL5文字 | 任意 | 255文字 |
説明: 文字 空の場合: 該当番号の画像を削除 |
カテゴリ・決済方法の自動作成機能
CSVで指定されたカテゴリ名・決済方法が存在しない場合、自動的に新規として作成されます。管理画面で並び順や設定を変更できます。
重要: 商品IDの重複について
※商品ID(外部サイト用)が重複している場合は連携用に「商品連携用外部キー」を用いて一意になるIDを必ず指定してください。
カスタムフィールド項目
カスタムフィールドとは
商品に対して独自の情報を管理するための拡張項目です。CSVテンプレート設定で、任意の項目名（例：「メーカー名」「原産地」「賞味期限」）を設定できます。
| 項目名 | 型 / 必須 | 設定例 | 説明・制限 |
|---|---|---|---|
| 任意の名称可変 | 任意 | メーカー名 原産地 賞味期限 |
説明: CSVテンプレート設定で任意の項目名を設定し、カスタムフィールドにマッピングします データ型: 管理画面で定義したフィールドタイプに依存 空の場合: 既存のカスタムフィールド値が全削除されます 複数値: カンマ区切りで複数値を指定可能（checkbox、selectbox-multiple型） |
カスタムフィールドの重要な動作
- 全削除・全置換: CSVテンプレートに含まれるカスタムフィールドは、既存データを全削除してから新しい値で置き換えます
- 事前定義が必須: CSVインポート前に、MOTENASU管理画面でカスタムフィールドを定義しておく必要があります
- CSVテンプレート設定が必要: CSVテンプレート画面で、CSV項目名とカスタムフィールドのマッピングを設定してください
▼注文CSV項目定義
基本情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 受注ID(外部サイト用)文字 | 必須 | 255文字 |
説明: 他システム側で発行された受注ID 空の場合: エラー（必須項目） 更新: この値で既存注文を識別 |
| リードコード(外部サイト用)文字 | 任意 | 60文字 |
説明: 他システム側で管理されているユーザID (文字) 空の場合: 空白（NULL/空文字）で上書き |
| メールアドレス(自動判別)文字 | 任意 | 255文字 |
説明: 例:sample@example.com 空の場合: 空白（NULL/空文字）で上書き |
| 親定期受注ID文字 | 任意 | 255文字 |
説明: 定期受注の場合 空の場合: 空白（NULL/空文字）で上書き |
注文者情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 注文者 氏名 (姓)文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 氏名 (名)文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 氏名カナ (姓)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 氏名カナ (名)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 性別文字 | 任意 | - |
説明: 男性:m or 1 or 男 女性:f or 2 or 女 空の場合: "unknown"で上書き |
| 注文者 モバイル Eメール文字 | 任意 | 255文字 |
説明: 例:sample@ezweb.ne.jp 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 PC Eメール文字 | 任意 | 255文字 |
説明: 例:sample@example.com 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 郵便番号文字 | 任意 | 7桁（ハイフン含む場合8文字） |
説明: 数字のみ（ハイフン可）、形式例: 1234567 または 123-4567 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 地域文字 | 任意 | 255文字 |
説明: 例:東京都or東京 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 地域詳細１文字 | 任意 | 255文字 |
説明: 市町村区・番地など 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 地域詳細2文字 | 任意 | 255文字 |
説明: ビル・アパート・マンション名など 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 電話番号文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 携帯電話番号文字 | 任意 | 13文字 |
説明: 例:09012345678 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日日付 | 任意 | - |
説明: 生年月日 (yyyyMMdd or yyyy/MM/dd or yyyy年MM月dd日 or yyyy-mm-dd) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（年）数値 | 任意 | - |
説明: yyyy (半角数字4桁) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（日）数値 | 任意 | - |
説明: dd (半角数字2桁) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 生年月日（月）数値 | 任意 | - |
説明: mm (半角数字2桁) 空の場合: 空白（NULL/空文字）で上書き |
| 注文者 国文字 | 任意 | 100文字 |
説明: 国名またはISO3166-1国名コード (例:日本orJP) 空の場合: 空白（NULL/空文字）で上書き |
お届け先情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| お届け先 氏名 (姓)文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 氏名 (名)文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 氏名カナ (姓)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 氏名カナ (名)カナ | 任意 | 80文字 |
説明: カナ 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 郵便番号文字 | 任意 | 7桁（ハイフン含む場合8文字） |
説明: 数字のみ（ハイフン可）、形式例: 1234567 または 123-4567 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 地域文字 | 任意 | 255文字 |
説明: 例:東京都or東京 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 地域詳細1文字 | 任意 | 255文字 |
説明: 市町村区・番地など 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 地域詳細2文字 | 任意 | 255文字 |
説明: ビル・アパート・マンション名など 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 電話番号文字 | 任意 | 13文字 |
説明: 例:0312345678 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 携帯電話番号文字 | 任意 | 13文字 |
説明: 例:09012345678 空の場合: 空白（NULL/空文字）で上書き |
| お届け先 国文字 | 任意 | 100文字 |
説明: 国名またはISO3166-1国名コード (例:日本orJP) 空の場合: 空白（NULL/空文字）で上書き |
商品情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 商品ID(外部サイト用)文字 | 必須 | 255文字 |
説明: 他システム側で管理されている商品ID (文字)（※1） 空の場合: エラー（必須項目） |
| 商品名文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 商品コード文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| JANコード文字 | 任意 | 13文字 |
説明: 数字のみ、8桁または13桁（JAN-8、JAN-13に対応） 空の場合: 空白（NULL/空文字）で上書き |
| 商品カテゴリ名文字 | 任意 | 255文字 |
説明: 文字 (値1,値2,値3) 空の場合: 空白（NULL/空文字）で上書き |
| 購入個数数値 | 必須 | - |
説明: 半角数字（※2） 空の場合: エラー（必須項目） |
| 商品単価数値 | 必須 | - |
説明: 半角数字（※2） 空の場合: エラー（必須項目） |
| 商品原価数値 | 任意 | - |
説明: 半角数字 空の場合: 空白（NULL/空文字）で上書き |
| 消費税率数値 | 任意 | - |
説明: 半角数字 空の場合: 空白（NULL/空文字）で上書き |
| 商品連携用外部キー文字 | 任意 | 255文字 |
説明: 商品IDが重複している場合は連携用にこちらを用いて一意になるIDを指定してください (文字) 空の場合: NULL として登録 |
金額・手数料項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 送料数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 代引き手数料数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| コンビニ手数料数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 後払い手数料数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| その他手数料数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| クーポン割引額数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| ポイント割引額数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| その他割引額数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 加算ポイント数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 小計数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 消費税額数値 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 請求合計金額数値 | 必須 | - |
説明: 半角数字（0以上）（※2） 範囲: 0以上 空の場合: エラー（必須項目） |
注文状況・日時項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| 備考文字 | 任意 | 65535文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 受注ステータス文字 | 必須 | 80文字 |
説明: 文字 自動作成: 存在しない受注ステータスは自動作成 空の場合: エラー（必須項目） |
| 決済方法文字 | 必須 | 80文字 |
説明: 文字 (値1,値2,値3) 自動作成: 存在しない決済方法は自動作成 空の場合: エラー（必須項目） |
| 測定コード文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 測定コード名文字 | 任意 | 80文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 測定費用数字 | 任意 | - |
説明: 半角数字（0以上） 範囲: 0以上 空の場合: 空白（NULL/空文字）で上書き |
| 配送希望日日付 | 任意 | - |
説明: yyyy/MM/dd or yyyy-MM-dd 空の場合: 空白（NULL/空文字）で上書き |
| 配送希望時間文字 | 任意 | 255文字 |
説明: 文字 空の場合: 空白（NULL/空文字）で上書き |
| 受注日時日時 | 必須 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: エラー（必須項目） |
| 受注日日付 | 任意 | - |
説明: yyyy/MM/dd or yyyy年MM月dd日 or yyyy-mm-dd 空の場合: 空白（NULL/空文字）で上書き |
| 受注時間時刻 | 任意 | - |
説明: HH:mm:ss or HH時mm分ss秒 空の場合: 空白（NULL/空文字）で上書き |
| 入金日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 発送完了日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| 定期受注完了日時（解約日/完了日）日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
| キャンセルフラグ数値 | 任意 | - |
説明: 0:通常 1:キャンセル 空の場合: 空白（NULL/空文字）で上書き |
| キャンセル日時日時 | 任意 | - |
説明: yyyy/MM/dd HH:mm:ss or yyyy-MM-dd HH:mm:ss (HH:mm:ssは任意) 空の場合: 空白（NULL/空文字）で上書き |
※1: 商品IDの重複について
商品ID(外部サイト用)が重複している場合は連携用に「商品連携用外部キー」を用いて一意になるIDを必ず指定してください。
※2: 金額・個数・単価について
請求合計金額、購入個数、商品単価が無くても取込は可能ですが、請求合計金額:0円、購入個数:1、商品単価:0円での登録となります。10,000円以上購入した方などへのシナリオ配信ができなくなるので、取込対象にする事を推奨しております。
カスタムフィールド項目
カスタムフィールドとは
注文に対して独自の情報を管理するための拡張項目です。CSVテンプレート設定で、任意の項目名（例：「配送業者」「ギフト包装」「備考メモ」）を設定できます。
| 項目名 | 型 / 必須 | 設定例 | 説明・制限 |
|---|---|---|---|
| 任意の名称可変 | 任意 | 配送業者 ギフト包装 備考メモ |
説明: CSVテンプレート設定で任意の項目名を設定し、カスタムフィールドにマッピングします データ型: 管理画面で定義したフィールドタイプに依存 空の場合: 既存のカスタムフィールド値が全削除されます 複数値: カンマ区切りで複数値を指定可能（checkbox、selectbox-multiple型） |
カスタムフィールドの重要な動作
- 全削除・全置換: CSVテンプレートに含まれるカスタムフィールドは、既存データを全削除してから新しい値で置き換えます
- 事前定義が必須: CSVインポート前に、MOTENASU管理画面でカスタムフィールドを定義しておく必要があります
- CSVテンプレート設定が必要: CSVテンプレート画面で、CSV項目名とカスタムフィールドのマッピングを設定してください
▼LINE連携CSV項目定義
基本情報項目
| 項目名 | 型 / 必須 | 最大長 | 説明・制限 |
|---|---|---|---|
| リードコード(外部サイト用)文字 | 任意 | 60文字 |
説明: リードコード、メールアドレス、電話番号のいずれか1つ以上が必須 空の場合: 他の識別項目も空の場合はエラー |
| メールアドレス(自動判別)文字 | 任意 | 255文字 |
説明: リードコード、メールアドレス、電話番号のいずれか1つ以上が必須 空の場合: 他の識別項目も空の場合はエラー |
| 電話番号文字 | 任意 | 13文字 |
説明: リードコード、メールアドレス、電話番号のいずれか1つ以上が必須 空の場合: 他の識別項目も空の場合はエラー |
| LINE ユーザーID文字 | 必須 | 255文字 |
説明: 文字 空の場合: エラー（必須項目） |
| LINE 友だち名文字 | 任意 | 255文字 |
説明: LINEユーザー登録時：必須項目 / 紐付け時：未入力の場合、連携対象のリード姓名を登録 空の場合: 空白（NULL/空文字）で上書き |
| LINE 友だち登録日時日時 | 任意 | - |
説明: DateTime(yyyy/MM/dd hh:mm:ss....) 空の場合: 空白（NULL/空文字）で上書き |
| LINE ブロック日時日時 | 任意 | - |
説明: DateTime(yyyy/MM/dd hh:mm:ss....) 空の場合: 空白（NULL/空文字）で上書き |
日時フォーマットについて
LINE 友だち登録日時/LINE ブロック日時のフォーマット: yyyy/MM/dd hh:mm:ss or yyyy-MM-dd hh:mm:ss or yyyy/MM/dd or yyyy-hh-dd or yyyy/M/d h:m:ss or yyyy-M-d h:m:ss or yyyy/M/d or yyyy-h-d
▼共通の動作仕様
空データの処理
CSVファイル内のデータは以下のルールで処理されます：
重要：CSVテンプレート設定による動作の違い
- CSVテンプレートに含まれない項目：更新対象外となり、既存データが保持されます
- CSVテンプレートに含まれていて空白の項目：空白（NULL/空文字）として登録・更新されます
- 必須項目が空白の場合：エラーとなり、該当行はスキップされます
カテゴリ・画像URLの特殊な動作
- 商品カテゴリ名：CSVテンプレートに含まれていて空白の場合、既存のカテゴリ設定が全削除されます
- 画像URL：CSVテンプレートに含まれていて空白の場合、該当番号の画像が削除されます
エラーハンドリング
- 必須項目のエラー：必須項目が未入力または形式不正の場合、該当行はスキップされ、エラーログに記録されます
- 任意項目のエラー：任意項目で形式不正や変換エラーが発生した場合、該当項目はデフォルト値で登録されます（文字列項目：NULL、数値項目：0）。警告ログに記録されますが、行全体はスキップされません
- データ型不整合：数値項目に文字列が入力された場合など、変換を試行します。変換不可能な場合は上記のルールに従って処理されます（数値項目は0、文字列項目はNULL）
エラー処理の具体例
必須項目以外のエラーでは行をスキップせず、可能な限り登録を継続します：
- 例1：任意項目「生年月日」に不正な日付（例：2025-13-45）が入力された場合 → 生年月日はNULLで登録、他の項目は正常に登録
- 例2：任意項目「郵便番号」に文字列（例：ABC-DEFG）が入力された場合 → 郵便番号はNULLで登録、他の項目は正常に登録
- 例3：任意項目「支払い金額」に文字列（例：abc）が入力された場合 → 支払い金額は0で登録、他の項目は正常に登録
- 例4：必須項目「氏名(姓)」が空の場合 → 該当行全体がスキップされ、登録されません
文字コード・改行コード
- 対応文字コード：UTF-8、Shift-JIS、Windows-31J (CP932)
- 推奨文字コード：UTF-8（文字化けを防ぐため、UTF-8での保存を強く推奨します）
- 自動変換：アップロードされたファイルは処理時に自動的にUTF-8に変換されます
- 改行コード：LF（
\n）、CRLF（\r\n）に対応
UTF-8の使用を推奨
Shift-JISやWindows-31Jでも処理可能ですが、一部の文字（機種依存文字など）で文字化けが発生する可能性があります。Excelで保存する場合は、「名前を付けて保存」→「CSV UTF-8（カンマ区切り）」を選択してください。
文字コードの自動検出
ファイルは行ごとに文字コードを自動検出し、UTF-8 → CP932 → Shift-JISの順でフォールバック処理されます。混在エンコーディングのファイルにも対応しています。
▼パフォーマンスとベストプラクティス
処理速度の最適化
- CSVファイルはストリーミング処理のため、ファイルサイズや行数に制限はありません
- 不要な項目は含めず、必要な項目のみのCSVを作成すると処理が高速化されます
実測パフォーマンス（参考値）
以下は実際の検証結果に基づく、レコード数ごとの処理時間の目安です：
新規登録時
| CSV種別 | 10,000 | 50,000 | 100,000 | 500,000 | 1,000,000 | 備考 |
|---|---|---|---|---|---|---|
| ユーザーCSV | 1分 | 7分 | 14分 | 1時間 | 2時間 | カスタム項目10個、フリーセグメント10個含む |
| 商品CSV | 10秒 | 1分 | 2分 | 10分 | 20分 | カスタム項目10個含む |
| 注文CSV | 10秒 | 1分 | 2分 | 10分 | 20分 | カスタム項目10個含む、注文明細5件/注文 |
| LINE連携CSV | 15秒 | 1分 | 2分 | 12分 | 24分 | フリーセグメント10個含む |
更新時
| CSV種別 | 10,000 | 50,000 | 100,000 | 500,000 | 1,000,000 | 備考 |
|---|---|---|---|---|---|---|
| ユーザーCSV | 1分 | 8分 | 15分 | 1時間 | 3時間 | カスタム項目10個、フリーセグメント10個含む |
| 商品CSV | 20秒 | 2分 | 4分 | 17分 | 35分 | カスタム項目10個含む |
| 注文CSV | 20秒 | 2分 | 3分 | 16分 | 32分 | カスタム項目10個含む、注文明細5件/注文 |
注意: 上記の数値は参考値です。実際の処理速度は、カスタム項目数・フリーセグメント数・データの複雑さ・サーバー負荷などにより変動します。ユーザーCSVは複雑な重複チェックと関連テーブル処理があるため、他のCSVより処理時間が長くなります。
データ品質の向上
- 事前にデータの重複チェックを行ってください
- 日付・時刻項目は統一した形式で入力してください
- 数値項目に不要な文字（カンマ、円マーク等）が含まれていないか確認してください
セキュリティ
- 個人情報を含むCSVファイルは適切に暗号化して保管してください
- 不要になったCSVファイルは確実に削除してください
▼よくある質問
Q1. CSVファイルで更新したデータが反映されません
A: 以下の点を確認してください：
- 必須項目が正しく入力されているか
- データ形式（日付、数値等）が正しいか
- 文字コードがUTF-8、Shift-JIS、Windows-31Jのいずれかであるか
- エラーログに詳細な情報が記載されていないか
Q2. 大量のデータを一度にアップロードできますか？
A: はい。ストリーミング処理により、ファイルサイズや行数に制限はありません。
Q3. CSVファイルの項目順序は重要ですか？
A: いいえ。CSVテンプレート設定で各項目の列位置をマッピングするため、項目の順序は自由です。
Q4. 一部の項目だけを更新したい場合は？
A: CSVテンプレート設定で更新したい項目のみをマッピングしてください。テンプレートに含まれない項目は既存データが保持されます。
▼トラブルシューティング
よくあるエラーと対処法
エラー: 「必須項目が入力されていません」
原因: 必須マークの項目が空になっています
対処: 該当項目に適切な値を入力してください
エラー: 「日付形式が正しくありません」
原因: 日付項目の形式が指定されたものと異なります
対処: yyyy/MM/dd、yyyy-MM-dd、yyyyMMdd、yyyy年MM月dd日のいずれかの形式で入力してください
エラー: 「文字数制限を超えています」
原因: 項目の最大文字数を超えています
対処: 該当項目の文字数を制限内に収めてください
エラー: 「数値以外の文字が含まれています」
原因: 数値項目に文字や記号が含まれています
対処: 半角数字のみで入力してください（カンマ、円マーク等は不可）
処理が遅い場合の対処法
- ファイルサイズを小さくして分割処理を行う
- 不要な項目を削除してCSVを軽量化する
- 処理が集中しない時間帯にアップロードする
サポート連絡先
上記で解決しない問題については、以下の情報を添えてサポートまでお問い合わせください：
- 発生したエラーメッセージの全文
- 使用したCSVファイルのサンプル（個人情報は除く）
- 処理を実行した日時
- 使用環境（ブラウザ、OS等）