製品、顧客、および注文をインポートするための必須フィールドの最小セットは何ですか?
公開: 2022-07-08あらゆるタイプのデータを Magento にインポートできますが、データベースに新しいレコードを作成するには、特定の情報を提供する必要があります。 インポート ファイルには、必須フィールドの最小セットが含まれている必要があります。 たとえば、製品を指定せずに注文をインポートしたり、名前を指定せずに顧客をインポートしたりすることはできません。
今日は、製品、顧客、および注文をインポートするために必要な必須フィールドの最小セットについて説明します。
仕組みをよりよく理解するために、ガイドを読みながら入力できるサンプル ファイルを次に示します。
輸入注文 →
商品の輸入 →
顧客のインポート →
必要なデータ範囲は何に依存しますか?
Magento には、いくつかのタイプのインポート動作があります — 追加/更新、置換、削除 (拡張機能を使用して、追加のみ/更新のみを選択することもできます)。 既存のレコードのデータを更新する場合(たとえば、新しい価格のファイルがあり、各製品を手動で更新するには時間がかかりすぎるため、このファイルをインポートする場合)、必須フィールドの数は次のようになります。記録がすでに存在するため、はるかに低くなります。 [追加] 動作を選択した場合 (新しいファイルを作成する場合)、さらに多くの情報を指定する必要があります。
また、正確に何をインポートしているかにも大きく依存します。 注文のインポートには、製品のインポートとは異なり、独自のフィールドのセットが必要です。
Amasty Import/Export エクステンションではどのように機能しますか?
この拡張機能にはツリー構造があります。メイン エンティティとそのフィールドを選択し、Magento にインポートする必要があるファイルのデータに応じて、小さなサブエンティティを含めます。
拡張機能には、インポートに必要なセクションとフィールドを自動的にアクティブにする特別な設定があり、どのブロックに入力する必要があるかを理解できます。
製品をインポートする例を使用して、これがどのように機能するかを見てみましょう。
1.プロファイルのインポート→新しいプロファイルの追加→設定のインポートに移動します
2.ここで [インポート動作] を選択します。
- 追加/更新— 拡張機能は、インポート ファイルの製品 ID を Magento インスタンス内の既存の製品と比較します。 商品 ID が一意の場合、新しい商品が作成されます。 この ID を持つ製品が既に存在する場合、拡張子はインポート ファイルで指定されたデータを変更/追加します。
- 追加のみ— 拡張機能は新しい ID を持つ製品をインポートし、既存の製品をスキップします。
- 更新のみ— 拡張機能は既存の製品の情報を更新し、存在しない製品をスキップします。
- 削除— 拡張機能は、インポート ファイルで指定された製品を Magento から削除します。
3. [一般的なユース ケースの自動入力を有効にする] オプションでトグルを[はい] に移動します。
このオプションは、すべての必須フィールドを [フィールド構成] タブに追加します。 この機能は、新しいプロファイルを作成する場合にのみ使用できることに注意してください。
最後に、追加されたフィールドがファイルにあることを確認します。 すべて問題なければ、フィールド マッピングを設定して検証します。
エンティティとフィールドのセット
インポートは、さまざまなデータを指定する必要があるいくつかのステップで構成されています。
主なエンティティ、それらが持つ必須フィールド、およびそれぞれに格納する必要があるデータを確認しましょう。
輸入注文 →
顧客のインポート →
商品の輸入 →
注文
次のフィールド ブロックを指定する必要があります。
- オーダー (ルート エンティティ)
- 注文品
- 注文の支払い
- 注文の配送先住所
- 注文請求先住所
各ブロックには、最低限必要なフィールドの独自のセットがあります。 それぞれに指定する必要があるのは次のとおりです。
オーダー (ルート エンティティ)
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルの注文の一意の識別子。 |
州 | Magento によって事前定義された注文状態 (新規、処理中、完了、支払い保留中、キャンセル済み、クローズ済み、支払いレビュー中、保留中)。 |
状態 | 個人のワークフローで使用する注文ステータス (Magento と同じか、カスタム ステータスを含む場合があります)。 |
is_virtual | カートに仮想製品のみが含まれているかどうかを示します。 はい/いいえのブール値を使用します。 「1」は「はい」、「0」は「いいえ」を意味します。 |
store_id | ストア テーブルに関連付けられた外部キー。 注文に関連付けられている Magento ストア ビューを決定します。 |
顧客ID | 注文に関連付けられた顧客属性を決定します。 注文がゲスト チェックアウトを通じて行われた場合、このフィールドは NULL になります。 |
customer_group_id | 注文に関連付けられた顧客グループを決定します。 |
顧客名 | 顧客の名を示します。 |
顧客の姓 | 顧客の姓を示します。 |
base_grand_total | すべての税金、配送料、および割引が適用された後の、注文に対して顧客が支払う基本通貨での最終価格。 |
base_shipping_mount | 注文に適用される基本通貨での配送料。 |
base_subtotal | 基本通貨での注文に含まれるすべての商品の総商品価値。 税金、送料、割引などは含まれていません。 |
base_tax_amount | 基本通貨で注文に適用される税額。 |
総計 | すべての税金、配送料、および割引が適用された後の注文に対して顧客が支払う最終価格。 |
shipping_amount | 注文に適用される配送料。 |
小計 | 注文に含まれるすべての商品の総商品価値。 税金、送料、割引などは含まれていません。 |
課税額 | 注文に適用される税額。 |
base_to_global_rate | 複数通貨をサポートするストアの基本通貨からグローバル レートへの係数 (例: 商品の価格がグローバル レベルで 50 米ドル、特定のストア ビューで 40 ユーロの場合、ファイルで指定する必要がある係数は、 0.8 である)。 |
base_to_order_rate | 複数通貨をサポートするストアの基本通貨とグローバル レートの係数 (例: アイテムの価格がグローバル レベルで 50 米ドル、特定の注文で 40 ユーロの場合、ファイルで指定する必要がある係数は次のようになります。 0.8)。 |
total_qty_ordered | 注文に含まれる商品の合計数量。 |
shipping_address_id | 注文に関連付けられた配送先住所の詳細を決定します。 |
請求先住所 ID | 注文に関連付けられた請求先住所の詳細を決定します。 |
quote_id | カート項目に関連付けられたカート属性を決定します。 |
インクリメント_id | 注文の一意の識別子であり、一般に Magento 内でorder_idと呼ばれます。 increment_idは、 Google ecommerce などの外部ソースとの接続に最もよく使用されます。 |
customer_email | ご注文のお客様のメールアドレス。 このオプションは、ゲスト チェックアウトによる注文を含め、すべての状況で入力されます。 |
created_at | 注文の作成タイムスタンプ。通常は UTC でローカルに保存されます。 MBI の構成によっては、このタイムスタンプが、データベースのタイム ゾーンとは異なる MBI のレポート タイム ゾーンに変換される場合があります。 |
updated_at | 注文のタイムスタンプを更新します。通常は UTC でローカルに保存されます。 |
注文品
有効にする Magento フィールド | 指定するデータ |
item_id | 商品の一意の識別子。 |
親アイテム ID | 単純な製品をその親バンドルまたは構成可能な製品に関連付ける外部キー。 単純な製品に関連付けられた親製品の属性を決定します。 親注文アイテム (つまり、バンドルまたは構成可能な製品タイプ) の場合、 parent_item_idは NULL になります。 |
order_id | 注文項目に関連付けられた注文属性を決定します。 |
store_id | 注文アイテムに関連付けられている Magento ストア ビューを特定します。 |
製品番号 | 注文項目に関連付けられた製品属性を決定します。 |
製品タイプ | 販売された製品のタイプ。 シンプル、構成可能、グループ化、仮想、バンドル、またはダウンロード可能な製品にすることができます。 |
重さ | 個々の製品の重量。 実際の製品の重量は、出荷時に運送業者によって決定されます。 |
is_virtual | カートに仮想製品のみが含まれているかどうかを示します。 はい/いいえのブール値を使用します。 「1」は「はい」、「0」は「いいえ」を意味します。 |
スク | 購入された注文アイテムの一意の識別子。 |
名前 | 注文アイテムのテキスト名。 |
qty_ordered | この特定の注文に含まれる製品のユニット数。 |
価格 | 注文商品の 1 単位の価格。 |
本体価格 | カタログ価格ルール、段階的割引、および特別価格が適用された後、税金、配送料、またはカートの割引が適用される前の販売時の製品の個々のユニットの価格で、ストアの基本通貨で表示されます。 |
行合計 | 行の合計は、注文項目ごとに計算されます。 式は次のとおりです。 行の合計 = ((注文した商品の価格 * 注文した商品の数量) + 税) - 割引 |
base_row_total | 基本通貨で指定された行の合計。 |
行の重み | 親行に表示される簡易商品の重量です。 |
created_at | 注文商品の作成タイムスタンプ。通常は UTC でローカルに保存されます。 MBI の設定によっては、このタイムスタンプが、データベースのタイム ゾーンとは異なる MBI のレポート タイム ゾーンに変換される場合があります。 |
updated_at | 注文のタイムスタンプを更新します。通常は UTC でローカルに保存されます。 |
製品オプション | 商品オプションとカスタム値が含まれます。 通常、 info_buyRequest関数が使用されます。 |
注文の支払い
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルの注文の一意の識別子。 |
親ID | バックエンドから編集された場合の元の注文の識別子。 |
方法 | 適用された支払い方法。 |
base_amount_ordered | 基本通貨での合計金額。 |
amount_ordered | 支払いに使用された通貨での合計金額。 |
注文の配送先住所
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルの注文の一意の識別子。 |
親ID | バックエンドから編集された場合の元の注文の識別子。 |
quote_address_id | 注文と見積もりを照合するためにquote_addressテーブルに関連付けられる一意の識別子。 |
region_id | 注文の地域 (ほとんどの場合、州または県) の ID。 |
領域 | 注文の地域 (ほとんどの場合州または県) のテキスト値。 |
苗字 | 顧客の姓を示します。 |
街 | 配送先住所に指定された通り。 |
街 | 配送先住所に指定された都市。 |
Eメール | アカウントに関連付けられている電子メール アドレス。  |
電話 | お客様の電話番号を示します。 |
ファーストネーム | 顧客の名を示します。 |
address_type | 配送先住所または請求先住所のタイプを示します。 |
country_id | 注文の配送国の ID。 |
注文請求先住所
注: 注文の配送先住所と同じフィールド
有効にするMagentoフィールド | 指定するデータ |
entity_id | テーブルの注文の一意の識別子。 |
親ID | バックエンドから編集された場合の元の注文の識別子。 |
quote_address_id | 注文と見積もりを照合するためにquote_addressテーブルに関連付けられる一意の識別子。 |
region_id | 注文の地域 (ほとんどの場合、州または県) の ID。 |
領域 | 注文の地域 (ほとんどの場合州または県) のテキスト値。 |
苗字 | 顧客の姓を示します。 |
街 | 請求先住所で指定された番地。 |
街 | 請求先住所で指定された都市。 |
Eメール | アカウントに関連付けられている電子メール アドレス。 |
電話 | お客様の電話番号を示します。 |
ファーストネーム | 顧客の名を示します。 |
address_type | 配送先住所または請求先住所のタイプを示します。 |
country_id | 注文の請求国の ID。 |
お客様
顧客をインポートするときは、正しいインポートのためにルート エンティティを指定するだけで済みます。 その他はオプションです。
顧客 (ルート エンティティ)
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルの顧客の一意の識別子。 |
Eメール | 顧客の電子メール アドレス。 |
website_id | 複数の Web サイトを持つインストール用の特定の Web サイトを識別します。 |
group_id | 登録されたアカウントに関連付けられた顧客グループを決定します。 |
store_id | アカウントに関連付けられている Magento ストア ビューを決定します。 |
ファーストネーム | 顧客の名を示します。 |
苗字 | 顧客の姓を示します。 |
顧客グループをインポートする場合、ファイルには次のフィールドが含まれている必要があります。
有効にする Magento フィールド | 指定するデータ |
customer_group_id | テーブルの顧客グループの一意の識別子。 |
tax_class_id | グループに割り当てられる税クラス属性の識別子。 |
customer_group_code | 顧客グループのテキスト値 (例: 一般) |
製品
製品のインポートは、さまざまな種類の製品があり、さまざまな方法でインポートする必要があるため、最も複雑です。 Configurable Productsをインポートするには、最初に単純なものを移行する必要があります。 すべての単純な製品がインポートされた場合にのみ、構成可能な製品のインポートを開始できます。
シンプルな製品
Simple Productsをインポートするために必要なのは、ルート ブロックを指定することだけです。
製品 (ルート エンティティ)
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルの製品の一意の識別子。 |
attribute_set_id | 製品タイプに従って、製品を特定の属性セットまたは製品テンプレートに割り当てます。 |
type_id | 製品の種類を示します。 値は次のとおりです。
|
スク | Stock-Keeping Unit は、在庫を追跡するために使用される一意の英数字の識別子です。 SKU の長さは最大 64 文字です。 例: sku123 SKU が 64 文字を超えると、インポートに失敗することに注意してください。 |
has_options | 1 — 製品にオプションがある場合 (たとえば、構成可能な製品には 1 を指定します)/ 0 — 製品にはオプションがありません。 |
必須オプション | 1 — 製品に必要なオプションがある場合。 0 — 製品には必要なオプションがありません。 |
コンフィギュラブル製品
シンプルプロダクトが正常に追加されたら、コンフィギュレーション可能プロダクトをインポートできます。 これを行うには、次のブロックを指定する必要があります。
- 製品 (ルート エンティティ)
- 構成可能な製品スーパー属性
- 構成可能製品のスーパー属性リンク
したがって、このステップでは、次のフィールドを含めて、以下に示すデータを指定する必要があります。
製品 (ルート エンティティ)
有効にする Magento フィールド | 指定するデータ |
attribute_set_id | テーブルの属性セットの一意の識別子。 |
type_id | 製品の種類を示します。 値は次のとおりです。
|
スク | Stock-Keeping Unit は、在庫を追跡するために使用される一意の英数字の識別子です。 SKU の長さは最大 64 文字です。 例: sku123 SKU が 64 文字を超えると、インポートに失敗することに注意してください。 |
has_options | 1 — 製品にオプションがある場合 (たとえば、構成可能な製品には 1 を指定します)/ 0 — 製品にはオプションがありません。 |
構成可能な製品スーパー属性
有効にする Magento フィールド | 指定するデータ |
product_super_ attribute_id | 構成可能な製品バリエーションの属性 ID。 |
製品番号 | 構成可能製品の ID。 |
attribute_id | リンクされた属性の ID。 |
位置 | 他の関連商品と一緒にリストされた場合の関連商品の位置を決定します。 |
構成可能製品のスーパー属性リンク
有効にする Magento フィールド | 指定するデータ |
製品番号 | シンプルな商品の ID。 |
親ID | 構成可能製品の ID。 |
スク | 単一の製品の SKU。 |
価格
価格設定に進みましょう。 顧客グループ価格ブロックを使用して、価格をインポートできます。
価格設定の場合、次のフィールドに入力する必要があります。
有効にする Magento フィールド | 指定するデータ |
value_id | テーブルの価格グループの一意の識別子。 |
すべてのグループ | 1 - 価格グループがすべての顧客グループに適用される場合。 0 - 価格グループが特定の顧客グループに適用される場合。 |
customer_group_id | 価格設定を適用する顧客グループ ID を決定します。 0 - すべてのグループ。 特定のグループで必要な場合は、目的のグループの ID を指定します。 |
数量 | 指定された価格を適用するために注文する必要がある製品の数量。 |
価値 | 必要な数量が注文された場合に適用される価格。 |
website_id | 製品を入手できる特定の Web サイトを識別します (複数の Web サイトへのインストールの場合)。 空白の場合、製品はすべての Web サイトで入手できます。 |
製品カテゴリ
次にインポートできるエンティティは製品カテゴリです。 カテゴリをインポートするには、次のエンティティを有効にする必要があります。
- 製品カテゴリ
- 商品カテゴリ属性
その後、以下のデータをフィールドに入力します。
製品カテゴリ
有効にする Magento フィールド | 指定するデータ |
entity_id | テーブルのカテゴリの一意の識別子。 |
道 | カテゴリツリーによるパス。 例: 1/2/20/22 |
位置 | カテゴリの位置 (並べ替え順) を決定します。 |
children_count | 親カテゴリに含まれるサブカテゴリの数。 |
商品カテゴリ属性
有効にする Magento フィールド | 指定するデータ |
名前 | カテゴリのタイトル。 |
available_sort_by | カテゴリでの並べ替えに使用するパラメータ (位置、製品名、価格など)。 |
default_sort_by | カテゴリでの並べ替えに使用するデフォルトのパラメータ (位置、製品名、価格など)。 |
filter_price_range | パラメータは、階層化されたナビゲーションの価格ステップとして指定されます。 |
インポートは複雑なプロセスであり、少しでも簡単かつ明確にすることができれば幸いです。
まだ質問がある場合は、下のコメントで遠慮なく質問してください。
インポート/エクスポートに関する以下の有用な記事に既に取り組んでいます!
記事の作成に協力してくれた Pavel Gabrusevich に感謝します。