Transporter内での注文のCSV列の説明

注文CSVファイルの列の説明。

プラス: Transporterアプリは、Shopify PlusのマーチャントだけがShopify アプリストアで利用できます。

Transporterアプリを使用して注文をShopifyにインポートするには、このレコードタイプのみを含むCSVファイルが必要です。

CSVサンプルファイル

サンプル注文のCSVファイルをダウンロードする。orders.csv

Transporterのコマンドラインツールを使用してこのCSVファイルを生成する、また後述のフォーマットに従って自分で作成することもできます。

列の説明

以下の表では、CSVファイルの列ヘッダーについて説明します。

CSVの列ヘッダーの注文
説明
Name (Required)
管理画面に表示される注文のIDとお客様が見る請求書。このIDはストア内で固有のものである必要があります。たとえば、#10011001-A、およびSH1001などです。この列は必須です。
Email お客様のメールアドレス。
Financial Status 注文に関連する支払い状況。有効な値:
  • pending - 決済が保留中です。この状態では支払いが失敗する可能性があります。支払いが正常に行われたかどうか再度確認してください。
  • authorized - 決済がオーソリされました。
  • partially_paid - 注文の決済が部分的に完了しています。
  • paid - 決済が行われました。
  • partially_refunded - 決済の一部が返金されました。
  • refunded - 決済が返金されました。
  • voided - 決済が無効となりました。
それぞれの値は、大文字と小文字が区別されます
Fulfillment Status フルフィルメントされた項目に関する注文ステータス。有効な値:
  • fulfilled - 注文のすべての項目がフルフィルメントされました。
  • partial - 注文の少なくとも1つの項目がフルフィルメントされました。
  • restocked - 注文のすべての項目の在庫が補充され、注文がキャンセルされました。
  • この列を空白のままにすると、未発送の注文状況になります。
それぞれの値は、大文字と小文字が区別されます。注文のフルフィルメント状況は、個々の項目のステータスに基づいている必要があります。詳細については、以下の注文のフルフィルメント状況を参照してください。
Currency 支払いに使用された通貨の3文字コード (ISO 4217フォーマット)。たとえば、米ドルまたはEURです。
Buyer Accepts Marketing お客様がマーケティングの受け取りにオプトインしたかどうか。有効な値:
  • TRUE - お客様がマーケティングの受け取りにオプトインする。
  • FALSE - お客様がマーケティングの受け取りからオプトアウトする。
Cancel Reason 注文がキャンセルされた理由。有効な値:
  • customer - お客様が注文をキャンセルしました。
  • fraud - 不正注文でした。
  • inventory - 注文の商品が在庫にありませんでした。
  • declined - 決済が拒否されました。
  • other - このリストに含まれていない理由。
それぞれの値は、大文字と小文字が区別されます
Cancelled At 注文がキャンセルされた日時 (ISO 8601フォーマット)。
Closed At 注文が終了した日時 (ISO 8601フォーマット)。
Tags 絞り込みと検索に使用されるカンマで区切られたタグの文字列。カンマで区切られた各タグに255文字まで使用できます。たとえば、「レビュー済, 梱包済, 配達済」などです。
Note 注文に添付されたオプションのメモ。このメモは、お客様が閲覧可能です。たとえば、「お客様の気が変わった」
Phone お客様の一意の電話番号です (E.164形式)。電話番号はさまざまな形式で入力できますが、各形式は世界中のどこからでもダイヤルできる番号であることが必要です。次のフォーマットはすべて有効です。
6135551212
+16135551212
(613) 555-1212
+1 613-555-1212
Referring Site お客様がストアにつながるリンクをクリックしたウェブサイト。たとえば、"http://www.anexample.com"
Processed At

注文が他のプラットフォームで最初に作成された日時 (ISO 8601フォーマット)。この値は管理画面の注文に表示され、販売レポートで使用される日付です。デフォルトの値は、注文がインポートされた日時となっています。

財務と決済の分析に影響を与える値については、「取引の処理日時」を参照してください。

Source name 注文の発行元 (たとえば、プラットフォーム名)。この値はインポート後に編集できません。たとえば、Transporter
Total weight グラム単位のすべての項目の重み (整数としてフォーマットされたもの) の合計。たとえば11
Total Tax 注文に適用されたすべての税 (税金1価格、...、配送1税率) の合計 (正数でなければなりません)。この列は、税が注文の一部として請求された場合 (たとえば、税金1の列に値がある場合など) に必要となります。この列に値を入力しないと、注文の合計金額に税の請求が含まれません。
Shipping Company 存在する場合、配送先住所に関連付けられている会社名。
Shipping Name 配送先住所に関連付けられた個人のフルネーム。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Shipping Nameを使用する、またはShipping First NameShipping Last Nameを使用することで実行できます。
Shipping Phone 配送先住所に関連付けられた電話番号 (E.164フォーマット)。電話番号はさまざまな形式で入力できますが、各形式は世界中のどこからでもダイヤルできる番号であることが必要です。次のフォーマットはすべて有効です。
6135551212
+16135551212
(613) 555-1212
+1 613-555-1212
Shipping First Name 配送先住所に関連付けられた個人の名。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Shipping First NameShipping Last Nameを使用する、またはShipping Nameを使用することで実行できます。
Shipping Last Name 配送先住所に関連付けられた個人の姓。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Shipping First NameShipping Last Nameを使用する、またはShipping Nameを使用することで実行できます。
Shipping Address1 配送先住所の最初の住所の行。この列は、住所の必須項目です。例: 150 Elgin St
Shipping Address2 配送先住所のオプション住所の行。たとえば、ユニット202
Shipping City 配送先住所の都市名。この列は、配送先住所の必須項目です。例: OttawaSydney
Shipping Province お客様が所在する地域 (州、都道府県、または地域など) の名前。この列を含める場合は、Shipping Province Codeの列が必要です。たとえば、メキシコシティタスマニアニューサウスウェールズ、またはニューヨーク
Shipping Province Code 国の州、都道府県または地域などの地方の割り当てられた細分コード (ISO 3166-2)。この列は、Shipping Provinceの列を含める場合に必要です。国の州、都道府県または地域などの地方の割り当てられた細分コード (ISO 3166-2)。ISO3116-2コードには次の部分があります。ISO3116-2コードには次の部分があります。
  • 2文字の国コード - この部分は含めないでください。
  • コードの2つの部分を区切るハイフン (-) - ハイフンを含みません。
  • 1から3文字の細分コード - この部分のみを含みます。
細分化コード
ISO 3166-2の細分コード 州コード
MX-MEX (メキシコシティ、メキシコ) MEX
NY-US (ニューヨーク、アメリカ) NY
Ar-B (ブエノスアイレス、アルゼンチン) B
FR-21 (コート=ドール、フランス) 21
Shipping Zip お客様住所の郵便番号。たとえば、K2P 1L490210または110 012
Shipping Country 配送先住所の国名。この列は、住所の必須項目です。例: Canada、India、Australia
Shipping Country Code お客様住所の国を示す2文字 (ISO 3166-1 alpha-2コード)。たとえば、カナダのCAなど。Shipping Countryを指定するときにShipping Country codeを指定することをおすすめします。
Billing Company 請求先住所に関連付けられた個人の会社。
Billing Name 決済に関連付けられたお客様のフルネーム。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Billing Nameを使用する、またはBilling First NameBilling Last Nameを使用することで実行できます。
Billing Phone 請求先住所に関連付けられた電話番号 (E.164フォーマット)。電話番号はさまざまな形式で入力できますが、各形式は世界中のどこからでもダイヤルできる番号であることが必要です。次のフォーマットは有効です。
6135551212
+16135551212
(613) 555-1212
+1 613-555-1212
Billing First Name 決済方法に関連付けられている個人の名。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Billing First NameBilling Last Nameを使用する、またはBilling Nameを使用することで実行できます。
Billing Last Name 決済方法に関連付けられている個人の姓。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Billing First NameBilling Last Nameを使用する、またはBilling Nameを使用することで実行できます。
Billing Address1 請求先住所の最初の住所の行。例: 150 Elgin St。この列は、請求先住所の必須項目です。
Billing Address2 請求先住所のオプション住所の行。たとえば、ユニット202
Billing City 請求先住所の都市名。この列は、請求先住所の必須項目です。例: OttawaDelhiAuckland
Billing Province 請求先住所がある地域 (州、都道府県、または地域など) の名前。この列を含める場合は、Shipping Province Codeの列が必要です。たとえば、メキシコシティニューヨークヌナブトニューサウスウェールズ
Billing Province Code 国の州、都道府県または地域などの地方の細分コード (ISO 3166-2)。この列は、Billing Provinceの列を指定する場合に必要です。ISO3116-2コードには次の部分があります。
  • 2文字の国コード - この部分は含めないでください。
  • コードの2つの部分を区切るハイフン (-) - ハイフンを含みません。
  • 1から3文字の細分コード - この部分のみを含みます。
細分化コード
ISO 3166-2の細分コード 州コード
MX-MEX (メキシコシティ、メキシコ) MEX
US-NY (ニューヨーク、アメリカ) NY
AR-B (ブエノスアイレス、アルゼンチン) B
FR-21 (コート=ドール、フランス) 21
Billing Zip 請求先住所の郵便番号。たとえばK2P 1L4
Billing Country 請求先住所の国名。この列は、請求先住所の必須項目です。例: CanadaIndiaGermany
Billing Country Code 請求先住所の国を示す2文字 (ISO 3166-1 alpha-2コード)。たとえば、カナダのCAなど。Countryを指定するときにCountry codeを指定することをおすすめします。
Lineitem name (Required)
注文された商品バリエーションの名前。例: Blue Shirtこの列は必須です。
Lineitem variant ID 注文された商品バリエーションのID。この列を使用して、この注文のアイテムをストアに存在する商品バリエーションと結びつけます。たとえば、7513594です。この列のIDがストアの商品バリエーションIDと一致していることを確認するか、この列を空白のままにしておく必要があります。この列のIDと一致するストアの商品バリエーションがTransporterアプリで見つからない場合、そのインポートは影響を受けません。商品は引き続き注文に追加されますが、ストア内の商品とストア分析の目的では一致しません。
Lineitem quantity 注文された商品バリエーションの個数です。この列は、正の整数のみを受け付けます。デフォルトでは1となります。たとえば、3
Lineitem price (Required)
ディスカウントが適用される前の商品バリエーションの価格。たとえば10.50 .25および30です。この列は必須です。
Lineitem variant title 特定の商品バリエーション。たとえば、Small
Lineitem compare at price 商品バリエーションの比較または推奨価格。 たとえば15
Lineitem sku アイテムの (商品バリエーション) のSKU (最小管理単位) 番号。
Lineitem requires shipping 商品バリエーションの配送が必要かどうか。有効な値は次のとおりです。
  • true - アイテムに配送が必要です。
  • false - アイテムに配送は必要ありません
それぞれの値は、大文字と小文字が区別されます
Lineitem taxable 商品バリエーションが課税対象だったかどうか。有効な値は次のとおりです。
  • true - アイテムは課税対象です。
  • false - アイテムは課税対象外です。
それぞれの値は、大文字と小文字が区別されます
Lineitem fulfillment status 注文内の個々の項目のフルフィルメント状況。有効な値:
  • fulfilled - 項目内のすべての商品が発送済みです。
  • この列を空白のままにすると、未発送の項目ステータスになります。
それぞれの値は、大文字と小文字が区別されます。注文のステータスを全体として判断するには、個々の項目のフルフィルメント状況を使用する必要があります。詳細については、以下の注文のフルフィルメント状況を参照してください。
Taxes Included 元の注文額は税込あるいは税別か。有効な値は次のとおりです。
  • true - 小計は税込です。この値がtrueに設定されていると、項目の税や配送料に対する税などすべての税が価格に含まれます。
  • false - 小計は税込別です。この値はデフォルトです。
それぞれの値は、大文字と小文字が区別されます
Tax 1 Title 請求された最初の税の名前。たとえばHSTVATがあります。
Tax 1 Price その項目に請求される税金 (ISO 4217)。たとえば、1.50。この列に値がある場合は、Total Taxの列も含める必要があります。
Tax 1 Rate その項目に請求される税率 (小数点)。たとえば、税率7%の場合は.07
Tax 2 Title 請求された2番目の税の名前。
Tax 2 Price 請求される税金 (ISO 4217)。この列に値がある場合は、Total Taxの列も含める必要があります。
Tax 2 Rate その項目に請求される税率。
Tax 3 Title 請求された3番目の税の名前。
Tax 3 Price その項目に請求される税金 (ISO 4217)。この列に値がある場合は、Total Taxの列も含める必要があります。
Tax 3 Rate その項目に請求される税率。
Transaction Amount 取引された金額 (小数点)。たとえば、50.00。この列は一部決済または一部返金を行うときに必要です。
Transaction Kind 取引のタイプ。この列は取引の列が含まれている場合に必要です。有効な値:
  • authorization - お客様が支払うことに同意した金額はオーソリされていますが、確定はされていません。承認期間は7日から30日の間 (決済サービスに応じて) ですが、ストアは決済が確定されるまで待機します。
  • capture - 承認中に予約された資金の送金。
  • sale - 1回のステップで実行される決済の承認と確定。
  • void - 保留中の承認または確定のキャンセル。
  • refund - お客様に返却する確定された金額の一部または全額。
それぞれの値は、大文字と小文字が区別されます
Transaction Status 取引の状況。有効な値:
  • success - 決済サービスによって取引が正常に完了しました。これはデフォルト値です。
  • pending - ゲートウェイは取引情報を受信しましたが、完了するまでに時間がかかることを示す応答を返しました。
  • failure - ゲートウェイは取引が失敗したという応答を送信しました (たとえばカードが拒否されたか、ストアで決済サービスの設定が正しく行われなかったなど)。
  • error - 通信エラーが発生しました (たとえばゲートウェイからの応答が受信されなかったか、またはゲートウェイが要求を受信しなかったなど)。
それぞれの値は、大文字と小文字が区別されます
Transaction Processed At

取引が他のプラットフォームで最初に実行された日時 (ISO 8601フォーマット)。この値は管理画面の注文に表示され、財務レポートで使用される日付です。デフォルトの値は、注文がインポートされた日時となっています。

注文の作成と同時に決済を受け付けた場合、「取引の処理日時」および「処理日時」の値が同じである必要があります。

Transaction Gateway 取引が発行されたサービスの名前。サービスのリストは、Shopifyの決済サービスページにあります。
Transaction Location ID 取引が行われたロケーションのID。このIDは、ストアで設定されているロケーションIDと一致する必要があります。ストア内の取引ロケーションIDと一致しない値はインポートされません。
Transaction Source Name 取引の起点。値の例: ウェブPOSiPhoneおよびAndroid
Shipping Line Code 配送方法への参照。デフォルト値はShipping line titleです。
Shipping Line Price 配送方法の価格。この列は、Shipping line titleの列が含まれている場合に必要です。
Shipping Line Source 配送の起点。
Shipping Line Title 配送方法のタイトル。この列は、Shipping line priceの列が含まれている場合に必要です。
Shipping Line Carrier Identifier 配送料を提供した運送業者のサービスのID。外部の配送業者のサービスを使用する場合、通常は値が必要です。
Shipping Line Requested Fulfillment Service ID 配送方法を要求したフルフィルメントサービスのID。配送方法に外部のフルフィルメントサービスによる処理が必要な場合、通常は値が必要です。
Shipping Tax 1 Title 配送の項目に課税される税の名前。例えば、HST
Shipping Tax 1 Rate 配送の項目に課税される税率 (小数点)。たとえば、配送税率15% (パーセント) の場合は0.15
Shipping Tax Price 配送の項目に課税される税金 (ISO 4217フォーマット)。この列に値がある場合は、Total Taxの列も含める必要があります。たとえば、1.50
Discount Code クーポンコード。Discount typeの列を含める場合、この列は必須です。
Discount Amount

注文から控除されたディスカウントの値 (ストアの通貨にて)。Discount typeの列を含める場合、この列は必須です。

入力した値がDiscount typeと一致していることを確認します。タイプがpercentageの場合、ディスカウントの割合値を入力します。タイプがfixed_amountの場合、ディスカウントの合計ドル額を入力します。

Discount Type

ディスカウントのタイプ有効な値:

  • fixed_amount - 特定の金額のクーポンコード。これはデフォルト値です。
  • percentage - クーポンコードは割合額でした。
  • shipping - ディスカウントが提供された場合、送料がamountに設定された値よりも小さい限り無料配送。たとえば、Discount amountが30で、送料が30ドルの場合、ディスカウントは30ドルです。Discount amountが30で、送料が100ドルの場合、ディスカウントはありません。

値の大文字と小文字は区別されます。注文内の特定のアイテムにディスカウントを適用することはできません。詳細については、「ディスカウントをインポートする」を参照してください。

Metafield Namespace メタフィールドセット用のコンテナー。メタフィールドをインポートするには、(Metafield NamespaceMetafield KeyMetafield ValueMetafield Value Type) の4つのメタフィールド列に値を含める必要があります。メタフィールドに対してカスタムネームスペースを定義して、それらがアプリやShopifyで使用されているネームスペース (デフォルトのglobalを含む) と区別できるようにします。最長: 20文字。
Metafield Key メタフィールドの名前。最長: 30文字。この列は、他のメタフィールド列が含まれている場合に必要です。
Metafield Value メタデータとして保存する情報。この列は、他のメタフィールド列が含まれている場合に必要です。
Metafield Value Type メタフィールドの情報タイプ。有効な値:
  • string
  • integer
  • json_string
それぞれの値は、大文字と小文字が区別されますこの列は、他のメタフィールド列が含まれている場合に必要です。

ファイル名

CSVファイルの名前には、orderという単語 (含まれているオブジェクトタイプの名前) を含める必要があります。たとえば、myorders.csvです。ファイルはUTF-8フォーマットである必要があります。

住所

注文の配送先住所がお客様のデフォルトの住所になります。お客様が関連付けられている注文をインポートすると、TransporterアプリはShopifyストアのお客さまを確認します。

  • Transporterがお客様を見つけた場合、注文はお客様に関連付けられ、注文の配送先住所はお客様のデフォルトの住所として設定されます。
  • Transporterがお客様を見つけられない場合、お客様が追加され、注文はお客様に関連付けられます。

複数の取引

取引ごとに別々の行を作成することによって、追加の取引を注文に追加することができます。取引を注文にリンクするには、各行にOrder nameを含める必要があります。

注文のフルフィルメント状況

注文のフルフィルメント状況は、その注文を構成する項目のフルフィルメント状況に基づいて決定されます。

  • すべての項目が未発送の場合は、注文のフルフィルメント状況が空欄のままになっている必要があります。
  • 項目にステータス (fulfilledまたはunfulfilled) の組み合わせがある場合は、注文のフルフィルメント状況はpartialになります。
  • すべての項目が発送済みの場合は、注文のフルフィルメント状況はfulfilledになります。

ディスカウントをインポートする

ディスカウントは注文レベルでのみ適用でき、注文内の特定のアイテムには適用できません。特定の商品にディスカウントが適用されている注文がある場合は、合計のディスカウント額を決定し、注文全体に適用します。これにより、販売レポートの正確性を保つことができます。

詳しくはこちら

Shopifyで販売を開始する準備はできていますか?

無料体験を試す