Transporter内での注文のCSV列の説明
注文CSVファイルの列の説明。
プラス:Transporterアプリは、Shopify PlusのマーチャントだけがShopify アプリストアで利用できます。
Transporterアプリを使用して注文をShopifyにインポートするには、このレコードタイプのみを含むCSVファイルが必要です。
CSVサンプルファイル
サンプル注文のCSVファイルをダウンロードする。orders.csv
Transporterのコマンドラインツールを使用してこのCSVファイルを生成する、また後述のフォーマットに従って自分で作成することもできます。
列の説明
以下の表では、CSVファイルの列ヘッダーについて説明します。
列 | 説明 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Name (Required) |
管理画面に表示される注文のIDとお客様が見る請求書。このIDはストア内で固有のものである必要があります。たとえば、#1001 、1001-A 、およびSH1001 などです。この列は必須です。 |
||||||||||
お客様のメールアドレス。 | |||||||||||
Financial Status | 注文に関連する支払い状況。有効な値:
|
||||||||||
Fulfillment Status | フルフィルメントされた項目に関する注文ステータス。有効な値:
|
||||||||||
Currency | 支払いに使用された通貨の3文字コード (ISO 4217フォーマット)。たとえば、米ドル またはEUR です。 |
||||||||||
Buyer Accepts Marketing | お客様がマーケティングの受け取りにオプトインしたかどうか。有効な値:
|
||||||||||
Cancel Reason | 注文がキャンセルされた理由。有効な値:
|
||||||||||
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 Name とShipping Last Name を使用することで実行できます。 |
||||||||||
Shipping Phone | 配送先住所に関連付けられた電話番号 (E.164フォーマット)。電話番号はさまざまな形式で入力できますが、各形式は世界中のどこからでもダイヤルできる番号であることが必要です。次のフォーマットはすべて有効です。6135551212 +16135551212 (613) 555-1212 +1 613-555-1212
|
||||||||||
Shipping First Name | 配送先住所に関連付けられた個人の名。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Shipping First Name とShipping Last Name を使用する、またはShipping Name を使用することで実行できます。 |
||||||||||
Shipping Last Name | 配送先住所に関連付けられた個人の姓。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Shipping First Name とShipping Last Name を使用する、またはShipping Name を使用することで実行できます。 |
||||||||||
Shipping Address1 | 配送先住所の最初の住所の行。この列は、住所の必須項目です。例: 150 Elgin St
|
||||||||||
Shipping Address2 | 配送先住所のオプション住所の行。たとえば、ユニット202 。 |
||||||||||
Shipping City | 配送先住所の都市名。この列は、配送先住所の必須項目です。例: Ottawa 、Sydney
|
||||||||||
Shipping Province | お客様が所在する地域 (州、都道府県、または地域など) の名前。この列を含める場合は、Shipping Province Code の列が必要です。たとえば、メキシコシティ 、タスマニア 、ニューサウスウェールズ 、またはニューヨーク 。 |
||||||||||
Shipping Province Code | 国の州、都道府県または地域などの地方の割り当てられた細分コード (ISO 3166-2)。この列は、Shipping Province の列を含める場合に必要です。国の州、都道府県または地域などの地方の割り当てられた細分コード (ISO 3166-2)。ISO3116-2コードには次の部分があります。ISO3116-2コードには次の部分があります。
|
||||||||||
Shipping Zip | お客様住所の郵便番号。たとえば、K2P 1L4 、90210 または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 Name とBilling Last Name を使用することで実行できます。 |
||||||||||
Billing Phone | 請求先住所に関連付けられた電話番号 (E.164フォーマット)。電話番号はさまざまな形式で入力できますが、各形式は世界中のどこからでもダイヤルできる番号であることが必要です。次のフォーマットは有効です。6135551212 +16135551212 (613) 555-1212 +1 613-555-1212
|
||||||||||
Billing First Name | 決済方法に関連付けられている個人の名。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Billing First Name とBilling Last Name を使用する、またはBilling Name を使用することで実行できます。 |
||||||||||
Billing Last Name | 決済方法に関連付けられている個人の姓。住所は、この値に関連した名前を持つ必要があります。このような関連性の構築は、Billing First Name とBilling Last Name を使用する、またはBilling Name を使用することで実行できます。 |
||||||||||
Billing Address1 | 請求先住所の最初の住所の行。例: 150 Elgin St 。この列は、請求先住所の必須項目です。 |
||||||||||
Billing Address2 | 請求先住所のオプション住所の行。たとえば、ユニット202 。 |
||||||||||
Billing City | 請求先住所の都市名。この列は、請求先住所の必須項目です。例: Ottawa 、Delhi 、Auckland
|
||||||||||
Billing Province | 請求先住所がある地域 (州、都道府県、または地域など) の名前。この列を含める場合は、Shipping Province Code の列が必要です。たとえば、メキシコシティ 、ニューヨーク 、ヌナブト 、ニューサウスウェールズ 。 |
||||||||||
Billing Province Code | 国の州、都道府県または地域などの地方の細分コード (ISO 3166-2)。この列は、Billing Province の列を指定する場合に必要です。ISO3116-2コードには次の部分があります。
|
||||||||||
Billing Zip | 請求先住所の郵便番号。たとえばK2P 1L4 。 |
||||||||||
Billing Country | 請求先住所の国名。この列は、請求先住所の必須項目です。例: Canada 、India 、Germany
|
||||||||||
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 | 商品バリエーションの配送が必要かどうか。有効な値は次のとおりです。
|
||||||||||
Lineitem taxable | 商品バリエーションが課税対象だったかどうか。有効な値は次のとおりです。
|
||||||||||
Lineitem fulfillment status | 注文内の個々の項目のフルフィルメント状況。有効な値:
|
||||||||||
Taxes Included | 元の注文額は税込あるいは税別か。有効な値は次のとおりです。
|
||||||||||
Tax 1 Title | 請求された最初の税の名前。たとえばHST やVAT があります。 |
||||||||||
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 | 取引のタイプ。この列は取引の列が含まれている場合に必要です。有効な値:
|
||||||||||
Transaction Status | 取引の状況。有効な値:
|
||||||||||
Transaction Processed At |
取引が他のプラットフォームで最初に実行された日時 (ISO 8601フォーマット)。この値は管理画面の注文に表示され、財務レポートで使用される日付です。デフォルトの値は、注文がインポートされた日時となっています。 注文の作成と同時に決済を受け付けた場合、「 |
||||||||||
Transaction Gateway | 取引が発行されたサービスの名前。サービスのリストは、Shopifyの決済ゲートウェイサービスページにあります。 | ||||||||||
Transaction Location ID | 取引が行われたロケーションのID。このIDは、ストアで設定されているロケーションIDと一致する必要があります。ストア内の取引ロケーションIDと一致しない値はインポートされません。 | ||||||||||
Transaction Source Name | 取引の起点。値の例: ウェブ 、POS 、iPhone および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 1 Price | 配送の項目に課税される税金 (ISO 4217フォーマット)。この列に値がある場合は、Total Tax の列も含める必要があります。たとえば、1.50 。 |
||||||||||
Discount Code | クーポンコード。Discount type の列を含める場合、この列は必須です。 |
||||||||||
Discount Amount |
注文から差引されたディスカウントの値 (ストアの通貨にて)。 入力した値が |
||||||||||
Discount Type |
ディスカウントのタイプ有効な値:
値の大文字と小文字は区別されます。注文内の特定のアイテムにディスカウントを適用することはできません。詳細については、「ディスカウントをインポートする」を参照してください。 |
||||||||||
Metafield Namespace |
メタフィールドセット用のコンテナー。メタフィールドをインポートするには、(Metafield Namespace 、Metafield Key 、Metafield Value 、Metafield Value Type ) の4つのメタフィールド列に値を含める必要があります。メタフィールドに対してカスタムネームスペースを定義して、それらがアプリやShopifyで使用されているネームスペース (デフォルトのglobal を含む) と区別できるようにします。最長: 20文字。 |
||||||||||
Metafield Key | メタフィールドの名前。最長: 30文字。この列は、他のメタフィールド列が含まれている場合に必要です。 | ||||||||||
Metafield Value | メタデータとして保存する情報。この列は、他のメタフィールド列が含まれている場合に必要です。 | ||||||||||
Metafield Value Type | メタフィールドの情報タイプ。有効な値:
|
ファイル名
CSVファイルの名前には、order
という単語 (含まれているオブジェクトタイプの名前) を含める必要があります。たとえば、myorders.csvです。ファイルはUTF-8フォーマットである必要があります。
住所
注文の配送先住所がお客様のデフォルトの住所になります。お客様が関連付けられている注文をインポートすると、TransporterアプリはShopifyストアのお客さまを確認します。
- Transporterがお客様を見つけた場合、注文はお客様に関連付けられ、注文の配送先住所はお客様のデフォルトの住所として設定されます。
- Transporterがお客様を見つけられない場合、お客様が追加され、注文はお客様に関連付けられます。
複数の取引
取引ごとに別々の行を作成することによって、追加の取引を注文に追加することができます。取引を注文にリンクするには、各行にOrder name
を含める必要があります。
注文のフルフィルメント状況
注文のフルフィルメント状況は、その注文を構成する項目のフルフィルメント状況に基づいて決定されます。
- すべての項目が未発送の場合は、注文のフルフィルメント状況が空欄のままになっている必要があります。
- 項目にステータス (
fulfilled
またはunfulfilled
) の組み合わせがある場合は、注文のフルフィルメント状況はpartial
になります。 - すべての項目が発送済みの場合は、注文のフルフィルメント状況は
fulfilled
になります。
ディスカウントをインポートする
ディスカウントは注文レベルでのみ適用でき、注文内の特定のアイテムには適用できません。特定の商品にディスカウントが適用されている注文がある場合は、合計のディスカウント額を決定し、注文全体に適用します。これにより、売上レポートの正確性を保つことができます。