Tutorial

注文にラインアイテムを一括追加する

多くの既存注文に新しいラインアイテムを手動で追加するのは非常に時間がかかります。DataEaseを使用すると簡単です:注文をエクスポートし、itemCommand=CREATEを使用してライン行を準備し、それらをShopifyにインポートします—すべて検証付きで。

🎯 目標

CSV/ExcelとDataEaseを使用して、多くの既存のShopify注文に一度に新しいラインアイテムを追加します。


📋 手順

1. 注文をエクスポートする(オプション、ID用)

DataEaseで、新しいエクスポート → Ordersに移動します。少なくとも以下を含めます:

  • id(注文ID)
  • 参考のために役立つ場合:name(注文番号)、顧客フィールド、および現在のラインアイテム

フィルターを適用(日付範囲、財務/履行ステータス)して、編集可能な注文のみを対象にします。


2. アイテムを追加するファイルを準備する

エクスポートされたファイルをExcelまたはGoogle Sheetsで開きます。編集する各注文について、1つ以上のライン行を作成します:

  • 注文のメインラインにtopRow = TRUEを設定します(注文レベルのフィールドは変更せずにそのままにするか、command=UPDATEを設定できます)
  • 新しいアイテムを追加するには、topRow = FALSEおよびitemCommand = CREATEを設定します
  • 次のいずれかを提供します:variantId(推奨)またはvariantSKU
  • itemQuantity(整数)を設定します
  • (オプション) 注文行の価格を上書きするためにitemPriceを設定します。設定しない場合、Shopifyはバリアント価格を使用します
  • (オプション) itemProperties(例:key=value; color=red)
  • エクスポートテンプレートの列名を正確に保持します

完了したら、ファイルを.xlsxまたは.csvとして保存します。


3. インポートと検証

  1. DataEaseで、新しいインポート → Ordersを開始します
  2. 編集したファイルをアップロードします
  3. 列をマッピングします(注文ID、ラインアイテムフィールド)
  4. 検証を実行します

検証レポートを開き、問題を修正します(variantId/SKUの欠落、無効な数量、編集不可の注文)。


4. インポートを実行し、結果をダウンロードする

検証が通過したら、インポートを実行をクリックして、ラインアイテムをShopifyに追加します。

完了したら、結果ファイルをダウンロードし、Shopify Adminで編集された注文をスポットチェックします:新しいラインアイテムが表示され、合計/小計が適切に更新されているはずです。


📝 重要な注意事項

  • 編集可能な注文のみ: キャンセル済み/全額返金済み/ロックされた注文は編集できません。必要に応じてアーカイブ解除またはステータスを元に戻します
  • 在庫と履行: アイテムを追加すると履行するアイテムが増えます。在庫が存在することを確認し、その後に履行を調整します
  • 価格と税金: itemPriceを設定した場合、税金/割引はその値から再計算されます。設定しない場合、Shopifyはバリアントの現在の価格を使用します
  • 識別子: 信頼性のあるマッチングにはvariantIdを使用します。カタログ全体で一意である場合のみvariantSKUを使用します

💡 最小限のCSV例

注文に1つのアイテムを追加する(バリアントIDによる):

id,topRow,command,itemCommand,variantId,itemQuantity,itemPrice
gid://shopify/Order/123,TRUE,UPDATE,,,,
gid://shopify/Order/123,FALSE,,CREATE,gid://shopify/ProductVariant/111,2,24.99

同じ注文に2つの異なるアイテムを追加する(別々のライン行を使用):

id,topRow,command,itemCommand,variantId,itemQuantity
gid://shopify/Order/456,TRUE,UPDATE,,,
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/222,1
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/333,3

SKUによるアイテムを追加する(バリアントからの価格):

id,topRow,command,itemCommand,variantSKU,itemQuantity
gid://shopify/Order/789,TRUE,UPDATE,,,
gid://shopify/Order/789,FALSE,,CREATE,SKU-RED-M,2

🎉 以上です!

ラインアイテムが注文に一括で追加されました。
問題が発生した場合や質問がある場合は、サポートチームにお気軽にお問い合わせください。