インポートされたフィールドの形式

CS-Cart や Multi-Vendor では、UTF-8の文字コードで作成されたファイルのみをインポートできます。

インポートが上手くいかない場合は、ファイルをUTF-8の文字コードで保存してから、もう一度インポートしてみてください。

インポートされたCSVファイルには、以下のフィールドを設定することができます。

商品コード(Product code)

Product code は必須項目であり、値は商品ごとにユニークである必要があります。

数字、文字、それらの組み合わせ（最大32個の記号）で作成ができます。

商品データをCSVファイルにエクスポートする場合は、商品コードが指定されていることを確認してください。

例：B0002OG6NY

フィールドの値が既存の製品コードと等しい場合、インポートされたデータがその製品のデータに置き換わります。

言語Language

2文字の小文字の言語コード。このフィールドは必須項目です。

言語コードを見つけるには：

  1. 管理画面の上部メニューから「一般設定 > テキストと言語 > 言語の管理」をクリック。
  2. 「設定可能な言語」タブをクリック。
  3. 目的の言語を見つけて、言語コードの行に該当の言語コードを表示します。

例：en

商品ID(Product id)

ECサイトのデータベースでの商品の数値ID。Product codeが空の場合、代わりにProduct IDが商品の判別に使用されます。

例：130

カテゴリー(Category)

商品のメインカテゴリーへのフルパス。

パス内の親と子のカテゴリーは、商品データを含むCSVファイルをインポートするときに指定する、カテゴリ区切り文字で互いに分離する必要があります。

例（区切り文字は///）：コンピューター///デスクトップ

指定したカテゴリとサブカテゴリがデータベースに存在しない場合は、作成されます。

カテゴリの名前にコロン（:）が含まれている場合（たとえば、プロモーション /// 割引：10％）には、インポートされたファイルで|Promotions///Discount: 10%|のようにエスケープする必要があります。

そうしないと、カテゴリが正しくインポートされません。

価格(Price)

あなたのECサイトの商品価格。

0.00形式である必要があります。

例：1600.00

表示価格(List price)

商品の推奨価格。

ECサイトで割引ラベルを表示するために使用されます。Discount = List price - Price

表示価格は0.00形式である必要があります。

例：1750.00

ステータス(Status)

商品のステータス：

  • A：有効：商品がECサイトで表示されます。
  • H：非表示：商品はECサイトに表示されません。直接リンクでご覧いただけます。
  • D：無効：商品は管理画面でのみ表示されます。

例：A

数量(Quantity)

商品の在庫量。

例：50

重量(Weight)

商品重量。

重量測定の単位は、管理画面の上部メニューにある「基本設定 > 全般｝で設定できます。

デフォルトでは、lbsです。

例：20.25

重量は、小数点以下2桁以下の整数または小数でなければなりません。小数部分は完全な点（.）で区切られます。

最小数量(Min quantity)

1回の注文で購入できるこの商品の最小量。

例：1

最大数量(Max quantity)

1回の注文で購入できるこの商品の最大量。

例：10

数量ステップ(Quantity step)

お客様が、カート内の商品数を増減できる商品のアイテム数。

例えば：

  • 最小数量：2
  • 最大数量：10
  • 数量ステップ：2

この設定の場合、お客様はこの商品の2、4、6、8、10個のアイテムを1回の注文で購入できるようになります。

例：1

利用可能な数量(List qty count)

カート内の商品アイテムの数を選択できる、ドロップダウンリストの選択肢の最大数。

例えば：

  • 最小数量：2
  • 最大数量：10
  • 数量ステップ：2
  • 数量カウント数：3

その後、お客様はこの製品の2、4、6つのアイテムから選択できるようになります。

例：10

List qty countを使用すると、商品ページの「利用可能な数量」フィールドが選択ボックスに変わります。

追加送料(Shipping freight)

特定商品の追加送料。

ECサイトの主要通貨で指定されます。

追加送料は、注文手続き時に計算された配送料に追加され、梱包費として使用できます。

例：2.00

計算された配送料金が5,000円で、商品の追加送料が500円の場合、カートに3つのアイテムがあると、合計配送料は6,500円になります。

追加日付(Date added)

商品が追加された日付。

次の形式を使用します。dd mmm yyyy 00:00:00

例：2011年12月25日14:05:00

このフィールドに入力がない場合は、代わりに商品がインポートされた日時が使用されます。

ダウンロード商品(Downloadable)

  • Y：商品はダウンロード可能です。
  • N：商品はダウンロードできません。

例：Y

ECサイトでのダウンロード商品の販売を可能にするには、管理画面の上部メニューから「基本設定 > 全般」で、「デジタルコンテンツのダウンロード販売を行う」のチェックボックスを有効にします。

ファイル(Files)

ダウンロード可能商品のファイルへのフルパス。

例：/home/client/public_html/cscart-4.4.1/var/files/exim/backup/downloads/filename.pdf

商品データを含むCSVファイルをインポートするときに、ファイルディレクトリを指定すると、ファイルをパスなしで（名前だけで）指定できます。複数のファイルはコンマで区切る必要があります。

例：file1.pdf、file2.jpg

ダウンロード商品の送料(Ship downloadable)

  • Y：有形の商品と同じように、ダウンロード可能商品の送料を計算します。
  • N：ダウンロード可能商品の送料を計算しません。

例：Y

在庫追跡(Inventory tracking)

  • B：在庫のある商品の数を追跡します。
  • D：在庫のある商品の数を追跡しません。

例：D

在庫切れアクション(Out of stock actions)

このフィールドは、商品が在庫切れの場合、お客様が商品ページで何ができるかを決定します。

  • B：事前に商品購入ができます。
  • S：商品が購入可能になったときに、メール通知を受け取るように登録します。
  • N：何もできません。

例：B

送料無料(Free shipping)

  • Y：商品は無料で発送されます。送料無料で配送方法を使用できる場合、送料の計算には考慮されません。
  • N：商品は無料で出荷されず、送料の計算では常に考慮されます。

例：Y

価格ゼロ商品(Zero price action)

このフィールドは、商品価格がゼロの場合の動作を説明します。

  • R：商品をカートに追加することを許可しません。
  • P：商品をカートに追加できます。
  • A：お客様に価格を入力するように依頼します。

例：A

画像(Images)

このフィールドは、「商品インポート」アドオンでのみ使用できます。

商品画像へのパス（または複数のパス）。

インポートプリセットの「ファイル」タブの追加設定で、画像区切り文字を使用して、複数の画像を指定できます。

例：exim / backup / images / main_image.jpg /// exim / backup / images /additional_image.jpg

商品データを含むCSVファイルをインポートするときに、画像ディレクトリを指定すると、パスなし（名前のみ）で画像ファイルを指定できます。

パスの後に追加することで、画像の代替テキストを指定できます。

例： exim/backup/images/main_image.jpg#{[ar]:Arabic alt text;[en]:English alt text;}///exim/backup/images/Nadditional_image.jpg#{[ar]:Arabic alt text;[en]:English alt text;}

各商品画像に独自カラム（CSVファイル内）またはノード（XMLファイル内）がある場合は、それらすべてを画像に設定でき、これらのフィールドが適切に結合されると、商品に複数の画像がインポートされます。

詳細画像(Detailed image)

商品詳細画像へのフルパス。

例：/home/client/public_html/cscart/var/files/exim/backup/images/detailed_image.jpg

商品データを含むCSVファイルをインポートするときに、画像ディレクトリを指定すると、パスなし（名前のみ）で画像ファイルを指定でき、パスの後に追加することで、画像の代替テキストも指定できます。

たとえば、英語とドイツ語の画像の代替テキストとしてALT TEXTを指定するには、次のように画像をインポートします。

例：/home/client/public_html/cscart/var/files/exim/backup/images/detailed_image.jpg＃{[de]：ALT TEXT; [en]：ALT TEXT;}

サムネイル(Thumbnail)

商品のサムネイル画像へのフルパス。

サムネイルは詳細画像から自動的に生成されるため、このフィールドは、商品詳細画像とは異なるサムネイルが必要な場合にのみ使用する必要があります。

例：/home/client/public_html/cscart/var/files/exim/backup/images/thumbnail_image.jpg

サムネイルのパスと代替テキストの指定は、詳細画像の場合と同じように機能します。

名前(Product name)

商品の名前。最大255個の記号を含めることができます。

例：Adidas Men’s ClimaCool Short Sleeve Mock

説明文(Description)

最大16,777,215個の記号を含んだ商品の説明文。

例：ClimaCoolは綿よりも柔らかく、他の天然繊維や合成繊維よりも毛玉に強いです。ClimaCoolファイバーの形状と配置は、水分をすばやく外面に移動させ、体から蒸発させます。

インポートされたファイルには、テキストの外観に影響を与えるHTMLが含まれている場合があります。

これは、説明文でよく利用されます。

次に例を示します

<p><i>ClimaCool</i> は綿よりも柔らかく、他の天然繊維や合成繊維よりも毛玉に強いです。ClimaCoolファイバーの形状と配置は、水分をすばやく外面に移動させ、体から蒸発させます。</p>

CSVファイルの場合は問題ではありませんが、XMLファイルをインポートすると、問題が発生します。

XMLタグとHTMLタグはどちらものように見え<...>、CS-Cartは何が何であるかを区別できませんので、HTMLタグ（説明の一部）をXMLタグ（ファイル構造の一部）から分離する必要があります。

HTMLを含むテキストは、次のようにインポートする必要があります。

<![CDATA[<p><i>ClimaCool</i>は綿よりも柔らかく、他の天然繊維や合成繊維よりも毛玉に強いです。</p>]]>

簡単な説明(Short description)

最大16,777,215個の記号を含んだ商品の簡単な説明。

例：100％円形リブCoolmax«UVおよび抗菌仕上げのエクストリーム1×1ミニリブソリッドピケモック。

メタキーワードMeta keywords

最大255個の記号を含んだ商品のメタキーワード。SEO目的で使用されます。

例：adidas,climacool,clima cool,モックタートルネック,ゴルフシャツ,UV保護,太陽

メタディスクリプション(Meta description)

最大255個の記号を含んだ商品のメタディスクリプション。SEO目的で使用されます。

例：アディダスメンズClimaCool半袖モック

検索単語(Search words)

最大65,535個の記号を含んだ商品の検索語リスト。CS-Cart の検索バーにこれらの検索語を入力すると、検索語を含む商品を見つけることができます。

例：adidas、climacool、男性

CS-Cart と Multi-Vendor の検索では、大文字と小文字は区別されません。

ページタイトル(Page title)

最大255個の記号を含んだブラウザに表示されるページの名前。

例：アディダスメンズClimaCool半袖モック

プロモーションテキスト(Promo text)

最大16,777,215の記号を含んだ商品ページに表示される短いプロモーションテキスト。

例：100ドル以上の送料無料！2日以内のご注文は月曜日に発送されます

税金(Taxes)

商品に適用される税金の名前。複数の税金はコンマで区切る必要があります。

例：消費税,簡易課税

税金は、商品をインポートする作成をしておく必要があります。

機能(Features)

インポートするすべての機能は、次の形式に従う必要があります。

{Feature ID} (Group name) Feature name: Feature type[Feature value]
  • Feature ID：機能ID。
  • Group name：機能が属するグループ名。
  • Feature name：機能名。
  • Feature type：次のタイプのいずれか：
    • C：チェックボックス。
    • M：複数のチェックボックス。
    • S：テキスト選択ボックス。
    • N：番号選択ボックス。
    • E：拡張選択ボックス（ブランド/メーカー）。
    • T：単純なテキスト。
    • O：番号。
    • D：日付。
  • Feature value：機能値。

いくつかの機能はセミコロンで区切る必要があります。

例： T[1233423423]; Release date: D[05/05/07]; Color: S[Red]

機能やバリデーションがデータベースに存在しない場合は、自動的に作成されます。機能を手動で作成することも、それらの機能を備えた商品をインポートする前にインポートすることもできます。

バリエーショングループコード(Variation group code)

複数の商品バリエーションを1つのグループに結び付ける共通ID。

たとえば、サイズや色などの種類があるTシャツを販売する場合、ミディアムホワイトのTシャツとスモールブルーのTシャツは、商品のバリエーションになります。

バリエーショングループコードが同じ場合、お客様は商品ページでこれらのバリエーションを切り替えることができます。

グループコードには、数字、ラテン文字、-および_の記号のみを含めることができます。

商品バリエーションをインポートする方法については別の記事をご覧ください。

例：Tシャツ_Need4Sports

デフォルトとして設定されたバリエーション(Variation set as default)

このカラムは、インポートされたファイルにバリエーショングループコードも含まれている場合にのみ機能します。

複数の商品バリエーションで1つのカタログアイテムを共有できます。

その場合、お客様はECサイトの商品リストにあるバリエーションの1つだけを見ることができ、その他のバリエーションは、商品ページで選択できます。

このカラムでは、お客様が商品リストで最初に表示するバリエーションを選択できますが、必須ではありません。このカラムを含めないと、次のようになります。

  • バリエーショングループが作成されると、グループの最初の商品がデフォルトのバリエーションになります。
  • 既存のバリエーショングループの商品が更新されても、インポートされたファイル内の商品の順序に関係なく、デフォルトのバリエーションは変更されません。

例：Y

オプション(Options)

インポートするすべての商品オプションは、次の形式に従う必要があります。

(Storefront) Option name: Option type[Variant 1///variant_property=value///variant_property=value, ..., Variant N///variant_property=value///variant_property=value]///setting=value///setting=value

いくつかのオプションは、セミコロン（;）で区切る必要があります。

  • (Storefront)：ストアフロントの名前。ストアフロントを指定しないと、オプションを編集できません。
  • Option name：オプションの名前。
  • Option type：次のオプションタイプを選択。
    • IG：テキスト。
    • TG：テキスト領域。
    • SG：選択ボックス。
    • RG：ラジオグループ。
    • CG：チェックボックス。
例： (text options): (Simtech) Your age: IG; (Simtech) Date of birth: IG; (Simtech) Notes: TG

オプションバリアントOption Variants

オプションタイプの直後に、選択ボックス（SG）およびラジオグループ（RG）オプションのバリアントを指定できます。

(Storefront) Option name: Option type[Variant 1///variant_property=value///variant_property=value, ..., Variant N///variant_property=value///variant_property=value]
  • Variant 1, …, Variant N：バリアントの名前。
例： (Simtech) Color: SG[Red, Green, Blue]; (Simtech) Size: RG[S, M, L, XL, XXL]
  • ///：商品データを含むCSVファイルをインポートするときに指定する機能値の区切り文字。
  • Variant_property = value /// Variant_property = value：オプションバリアントのプロパティ。
    • modifier：このオプションバリアントが選択されたときに、商品価格に加算または減算される正または負の値。
    • modify_type：価格を変更するためのタイプ。
      • P：パーセンテージ。
      • A：ECサイトストアの主要通貨での固定値。
    • weight_modifier：このオプションバリアントが選択されたとき、商品の重量に加算または減算される正または負の値。
    • weight_modifier_type：重量を変更するためのタイプ。
      • P：パーセンテージ。
      • A：ECサイトの重量測定単位の固定値。
    • image：オプションバリアントの画像。このフィールドは、詳細画像と同じように機能します。
例: (Simtech) Size: SG[Normal,Large///modifier=10.000///modifier_type=P///weight_modifier=20.000///weight_modifier_type=A]; Color: SG[Grey///image=exim/backup/images/variant_image/grey_example.jpg,Black///modifier=50.000///modifier_type=A///image=exim/backup/images/variant_image/black_example.jpg]

オプション設定(Option Settings)

オプションバリアントの後に設定を指定できます。

指定できる設定は次のとおりです。

  • inventory：このオプションを組み合わせの一部にすることができ、個別に追跡する必要があるかどうかを判断します。
    • Y：はい。
    • N：いいえ。
  • missing_variants_handling：オプションのすべてのバリアントが無効になっている場合、またはまったく指定されていない場合にどうなるかを設定します。
    • M：メッセージを表示します。
    • H：オプションを完全に非表示にします。
  • required：オプションが必要な場合、お客様はこのオプションのバリエーションを選択/入力する必要があります。
    • Y：オプションは必須です。
    • N：オプションは必要ありません。
  • status：オプションのステータス：
    • A：有効。
    • D：無効。
例: (Simtech) Color: SG[Red///modifier=5///modifier_type=A,Green///modifier=10///modifier_type=P]///inventory=Y///missing_variants_handling=M///required=Y///status=A
  • multiupload（ファイル（F）タイプのオプションの場合）：お客様が1つのオプションに対して複数のファイルをアップロードできるかどうかを決定します。
    • Y：はい。
    • N：いいえ。
  • allowed_extensions（ファイル（FG）タイプのオプションの場合）：お客様がアップロードを許可されているファイルの拡張子。
  • max_file_size（ファイル（FG）タイプのオプションの場合）：アップロードされたファイルの最大サイズ（KB単位）。
例: (Simtech) Custom image: FG///required=Y///multiupload=N///allowed_extensions=jpg,bmp,gif///max_file_size=1000

子カテゴリー(Secondary categories)

商品が割り当てられている追加カテゴリーへのフルパス。

親と子のカテゴリーは、商品データを含むCSVファイルをインポートするときに指定するカテゴリ区切り文字で区切る必要があります。

商品が複数の子カテゴリーに割り当てられている場合、各カテゴリーへのパスはセミコロン（;）で区切る必要があります。

例：（区切り文字は///）：コンピューター///新製品; コンピュータ///デスクトップ

カテゴリーの名前にコロン（:）が含まれている場合（たとえば、プロモーション /// 割引：10％）は、インポートされたファイルで|Promotions///Discount: 10%|のようにエスケープしないと、カテゴリが正しくインポートされません。

複数のセカンダリカテゴリがある場合、次のようになります。Best Products;|Promotions///Discount: 10%|

配送用外箱に収めることのできる商品個数(Items in box)

配送用外箱に収めることのできる商品個数の最小数と最大数。

このフィールドは、送料の自動計算に使用されます。このフィールドのデータの形式は以下のようになります。

min：[number]; max：[number]

例: min:1;max:5

配送用外箱サイズ(Box size)

配送用外箱のサイズ。

このフィールドは、送料の自動計算に使用されます。このフィールドのデータの形式は次のとおりです。

length:[number];width:[number];height:[number]

例: length:10;width:15;height:15

ユーザーグループID(Usergroup IDs)

商品のユーザーグループの数値IDを見ることができます。

CS-Cart と Multi-Vendor がデフォルトで持っているIDは次のとおりです。

  • 0 —すべてのユーザー
  • 1 —ゲスト
  • 2 —登録ユーザー

例：0、1、2、3

提供開始日(Available since)

商品が販売可能になる日付。

在庫切れ/予約注文への対応が、予約注文に設定されている場合に使用され、次の形式を使用する必要があります。

dd mmm yyyy 00:00:00

例：2015年12月25日14:05:00

コンビネーションの設定方法(Exceptions type)

コンビネーションの設定方法。

  • F：すべてのオプションの例外は禁止されています。お客様は、そのようなオプションの組み合わせで商品をカートに追加することはできません。他のすべてのオプションの組み合わせが許可されます。
  • A —オプションの例外のみが許可されます。お客様は、そのようなオプションの組み合わせを持つ商品をカートに追加できます。ただし、他のオプションの組み合わせは禁止されています。

例：F

オプションの指定方法(Options type)

商品ページでお客様がオプションを選択する順序。

  • P：指定順序なし：お客様はオプションのバリエーションを任意の順序で選択できます。各オプションには、デフォルトでいくつかのバリアントが選択されています。
  • S：上から順に指定：お客様は最初のオプションを選択し、次に2番目のオプションを選択する必要があります。デフォルトでは、バリアントは選択されていません。

例：S

ストア(Store)

アイテムが属するECサイト。

このフィールドは、CS-Cartでは必須項目です。

例：サンプルストア

Multi-Vendor には、代わりに出品者フィールドがあります。

SEO用名称(SEO name)

商品のSEO名。

例：my-product

ポイントによる支払を許可(Pay by points)

  • Y：お客様は、ポイントで商品の代金を支払うことができます。
  • N：お客様は、ポイントで商品の代金を支払うことはできません。

例：Y

必要ポイント数を独自に設定(Override points)

  • Y：商品の購入に対して付与されたポイントの金額を上書きします。
  • N：商品の購入に対して付与されるポイントの量を上書きしないでください。

例：Y

ポイント数を独自に設定(Override exchange rate)

  • Y：この商品の価格を独自のポイントで上書きします。
  • N：この商品のポイントでの価格はグローバルポイントを使用します。

例：Y

人気度(Popularity)

商品の人気度。

これは、商品に対する行動（商品が表示された、カートに追加された、カートから削除された、購入された）に応じて変化する整数です。

高いほど、その製品の人気は高くなります。

例：8