Easy Digital Downloads は、CSV形式で注文をインポートおよびエクスポートする機能があり、他のストアからのインポートや、新しい商品を一括でインポートできます。他のストアから注文をインポートする場合は、こちらのエクスポートガイドをご覧ください。
この記事の内容
インポート
注文のインポートは Downloads > Tools > Import/Export で行います。このページには Import Orders. というラベルのボックスがあります。
フォーマット
CSVはカンマ区切りで、フィールドは二重引用符で囲む必要があります。フィールドの順序は重要ではありません。次のステップでマッピングするためです。
1. CSVファイルのアップロード
Choose File をクリックしてファイルを参照します。次に Import CSV をクリックします。
2. マッピング
ファイルがアップロードされると、コンテンツが必要な注文フィールドのリストと、それぞれのフィールドのマッピング先を指定するためのドロップダウンが表示されます。各ドロップダウンにはCSVからのコンテンツが入力されるため、正確にマッピングできます。
さらに、列を選択すると、下の例のように、データ行の最初の値が右側に表示されます。
注意: 右側の列にデータが表示されない場合でも問題ありません。これは、例として使用されている行にその列のデータが含まれていないことを示しているだけです。
必須フィールド
フィールドが多いほど、サイトのデータはより完全になり、財務諸表や顧客情報の作業に役立ちます。ただし、必須フィールドは顧客のメールアドレス、すべての商品フィールド、およびトランザクションフィールドです。
CSVフィールド
Easy Digital Downloads は、インポートでこの情報を探しています：
| 商品フィールド | 期待されるデータ型 |
|---|---|
| 通貨コード | USD、EUR、GBPのようなISO規格の3文字の略語 |
| 顧客のメールアドレス | 標準的なメール形式が受け入れられ、入力前に検証されます |
| 顧客の名 | 任意のテキスト文字列。 |
| 顧客の姓 | 任意のテキスト文字列。 |
| 顧客ID | これはEDDによって作成された顧客の一意の数値IDです。整数である必要があります。 |
| 割引コード | 任意の有効な割引コード、混合文字、通常はBLACKFRIDAY2015のようなもの |
| IPアドレス | 任意の有効なIPアドレス、数字とドットの混合。 |
| モード | これは、トランザクションがテストモードで行われたか、実際のトランザクションであったかを示します。「Live」または「Test」という単語のみを受け入れます |
| 親注文ID | これは、サブスクリプションの起点となった注文のEDD IDです。これは、定期支払いを使用しており、かつ更新注文をインポートしている場合にのみ必要です。 |
| 注文方法 | 注文が処理された方法の名前を受け入れます。通常は、Stripe、PayPal、Store Paymentなどの支払いゲートウェイの名前です。 |
| 注文番号 | これは一意の連番の数値IDです。注文への特定の参照はありません。単にシーケンスを示します。多くの場合、VATが問題となる場所で使用されます。 |
| 注文日 | 任意の標準日付形式 |
| 注文キー | EDDによって作成された32文字の英数字キー。例: 79e85c15567f7088e47984e112fb81eb 空白のままにした場合、EDDはインポート時に各注文に対して1つ作成します。 |
| 購入した商品 | プレーンテキスト、複数の商品はスラッシュで区切ります。EDDのエクスポートファイルをインポートする場合は、「注文（生）」にマップします。 |
| ステータス | EDDのドキュメントで見つかる任意の有効な注文ステータス です。 |
| 小計 | EDDのエクスポートファイルには見つかりません。税金と割引前の総購入金額です。 |
| 税金 | 合計のうち税金のみの割合です。 |
| 合計 | 税金と割引を含む総購入金額です。 |
| トランザクションID | これは支払いゲートウェイから提供される一意の文字列です。例: ch_18Fv1M4NqFpaKRwYjA8wCv3r 各ゲートウェイには独自の標準フォーマットがあります。 |
| ユーザーID | 支払いを関連付ける既存のWordPressのユーザー名、ID、またはメールアドレス。 |
| 番地1 | 任意のテキスト文字列。 |
| 番地2 | 任意のテキスト文字列。 |
| 市区町村 | 任意のテキスト文字列。 |
| 都道府県 | 任意のテキスト文字列。 |
| 郵便番号 | 任意のテキスト文字列。 |
| 国 | 任意のISO形式の国コード。 |
上記で述べたように、CSVファイル内のフィールド順序は関係ありません。
3. 完全なマッピングレイアウト
以下は、送信直前のマッピングプロセスの例です。一部は無視に設定され、右側にデータが表示されないものがあることに注意してください。これはインポートされるファイルでは想定される動作です。各インポートは少しずつ異なりますが、それは問題ありません。
送信後、次のような確認メッセージが表示されるはずです。
注文（生）フォーマット
注文（生）列は、この名前である必要があります。この名前でないと、インポーターは高度な製品カスタマイズを考慮しません。注文（生）をフォーマットするには、次のフォーマットを使用できます。
ダウンロード名|価格{税金}{価格ID} // 例
// Product with Variable Pricing, costing 199.99, 19.90 in tax, and price option 1
Download Name|199.00{19.90}{1}
// Product without Variable Pricing or tax
Download Name|199.00{0}{0}
// Multiple products on a single purchase record, no tax, all different price IDs
A Music Album|1{0}{0} / One More Sample Product|30{0}{0} / Another Sample Product|20{0}{1}
注文のエクスポート
購入のエクスポートは、ダウンロード > レポート > エクスポートで行います。このページには、「注文のエクスポート」というラベルのボックスがあります。日付範囲を選択でき、開始日と終了日を指定できます。開始日と終了日を空欄にした場合、すべての注文がエクスポートされます。指定した日付より前または後のすべての注文について、[宛先]または[送信元]を空欄にすることもできます。
特定のステータスの注文のみをエクスポートすることもできます。可能なステータスは次のとおりです。
- 保留中
- 完了
- 返金済み
- 失敗
- 放棄済み
- 取り消し済み
- 事前承認済み
- キャンセル済み
- 更新
出力
生成されるCSVファイルにはヘッダー行が含まれます。項目はカンマ区切りで、ASCII二重引用符で囲まれます。例：
"ID","Email","First Name","Last Name","Address","Address (Line 2)","City","State","Country","Zip / Postal Code","Products (Verbose)","Products (Raw)","SKUs","Amount ($)","Tax ($)","Discount Code","Payment Method","Transaction ID","Purchase Key","Date","User","Currency","IP Address","Status" "76","[email protected]","Robert","Joiner","","","","","","","I am Pippin Williamson, and so can YOU - - $18.00","I am Pippin Williamson, and so can YOU","-","18.00","0.00","DISCOUNT1","Test Payment","76","80c256fda75fa759da666177718bb5a6","2016-06-01 17:42:47","topher","USD","73.18.183.49","Complete"
備考
顧客/ユーザー：
– インポート前に注文の顧客が存在しない場合、インポート時に自動的に作成されます。
– 「顧客」はインポート時に作成されますが、対応するWordPressの「ユーザー」は作成されません。あるドメインから別のドメインに移行し、顧客が新しいドメインで古い支払い履歴にログインして表示できるようにしたい場合は、[edd_register]ショートコードを使用して、顧客が新しいサイトに再参加できるようにすることを検討してください。
重複注文：
同じCSVを2回インポートすると、重複注文が作成されます。現時点では重複注文のチェックは行われません。
注文インポート中の商品作成：
支払いインポートは、商品作成ツールとして見なされるべきではありません。支払いインポーターは、購入された商品がまだ存在しない場合に注文の商品を生成しますが、注文インポート中に作成された商品は情報（価格、ファイルURLなど）が不足します。支払いインポートの前に、商品インポーターを使用して、インポートされた商品が本来持つべきすべての情報を含んでいることを確認してください。
