匯入和匯出合約 CSV 檔
您可以使用 CSV (逗號分隔值) 檔案將合約從第三方訂閱應用程式匯入 Shopify Subscriptions 應用程式，或者從 Shopify Subscriptions 應用程式匯出合約。
若要深入瞭解如何使用 CSV 檔案，請參閱開啟並編輯 CSV 檔案。
下載範例 CSV 檔案
您可以下載並檢視「合約 CSV 檔案範本」，然後作為範本使用。
合約 CSV 檔案的考量事項
使用合約 CSV 檔匯入合約前，請檢視以下考量事項。
設定 CSV 檔格式
若要正確匯入合約 CSV 檔，請驗證該檔案是否符合以下條件：
- 合約 CSV 檔案的第一行必須為「合約 CSV 說明表」中所指定的欄標頭。
- 每一欄必須使用逗號分隔。
- CSV 檔案大小上限為 10 MB。
瞭解控制代碼欄
控制代碼是每個合約的唯一識別碼。您可透過以下方式使用控制代碼來管理資料：
- 將合約與多個商品項目分組：系統會依共用控制代碼將包含多個商品項目的合約進行分組。
- 避免重複的合約：匯入時會忽略重複的合約。如果之前已成功匯入控制代碼相同的列，則新匯入過程中會跳過該列。此機制有助於避免重複資料。
多個商品項目合約
包含多個商品項目的合約需要每個商品項目單獨的一列，並且與控制代碼欄分為同一組。
舉例來說，如果合約有三個商品項目，則每個商品項目必須新增為單獨一列。第一列包含所有合約資訊，後兩列僅包含下列欄中的值：
- handle
- line_variant_id
- line_quantity
- line_current_price
- 選用：line_selling_plan_id
- 選用：line_selling_plan_name
三欄的控制代碼必須全部相同。第二列和第三列的所有其他欄必須空白。您可以下載範例 CSV 範本，以檢視多個商品項目合約的範例。
CSV 檔案說明
合約 CSV 使用的資訊分為以下類別：* 合約名稱 * 顧客和帳單資訊 * 配送方式和資訊 * 訂閱方案包含的商品
必須將所有欄新增到 CSV 檔才能正確匯入，若無特別註明，否則所有欄位皆為必填。
| 欄 | 說明 |
|---|---|
| Handle | 控制代碼是每份合約的唯一識別碼。例如 red-shirt。控制代碼可以包含字母和數字，並且通常是字母及/或數字的組合字串。每份合約必須具有唯一的控制代碼。 |
| upcoming_billing_date | 合約的下一期結帳日期。 時間以 UTC (世界協調時間) 為準，格式必須為 YYYY-MM-DDTHH:MM:SSZ。 例如，UTC (世界協調時間) 時區 2019 年 9 月 7 日下午 3:50 會顯示為 2019-09-07T15:50:00Z。 下一期結帳日期值的日期和時間不得設在 CSV 檔案匯入日期和時間後的 24 小時內。 |
| customer_id | 顧客 ID。ID 必須與 Shopify 管理介面中現有顧客的 ID 相符，且應該是數字組成的字串。例如 6320530986896。 |
| currency_code | 合約的幣別代碼。幣別代碼必須與商店已啟用的幣別相符。 |
| status | 合約狀態。合約可具有以下其中一個狀態：
|
| cadence_interval | 訂閱的配送頻率。合約可使用以下任一配送頻率：
|
| cadence_interval_count | 訂閱在整體時間間隔內的配送頻率。例如，每月的配送頻率計數是 1，而每兩週的配送頻率則是 2。 |
| customer_payment_method_id | 顧客用於合約付款方式的 ID。ID 是不重複的英數字元代碼。例如，24e8c839c47ef47d30ad28346d130e74。 |
| delivery_price | 採用正確幣別格式的配送價格。 |
| delivery_method_type | 訂閱項目的配送方式。配送方式必須為以下其中一種：
|
| delivery_address_first_name | 配送地址上收件人的名字。只有配送方式為「運送」或「當地配送」時，才需要加入此欄位。 |
| delivery_address_last_name | 配送地址上的收件人姓氏。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_address1 | 配送地址的第一行。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_address2 | 配送地址的第二行。 只有地址有第二個欄位且配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_city | 配送地址的所在城市。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_province_code | 配送地址所在省分或州的 ISO 代碼。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_country_code | 配送地址的國家/地區 ISO 代碼。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_company | 配送地址的公司名稱。 只有商家訂單且配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_zip | 配送地址所屬郵遞區號。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_address_phone | 配送地址對應的聯絡電話，例如 +1 (613) 555-5555。 只有配送方式為「運送」或「當地配送」時，此欄位才為必填。 |
| delivery_local_delivery_phone | 配送地址的電話號碼。 若訂閱項目的配送方式為「當地配送」，此欄位為必填。 |
| delivery_local_delivery_instructions | 當地配送說明。 只有為使用「當地配送」方式的訂閱項目提供說明時，此欄位才為必填。 |
| delivery_pickup_method_location_id | 取貨方式的地點 ID。 只有訂閱項目的配送方式為「到店取貨」，此欄位才為必填。 |
| line_variant_id | 訂閱方案包含的每個商品項目的 ID，例如 53154087005812。 若訂閱方案包含多個商品項目，則每個商品項目必須新增為具有唯一子類 ID 的新資料行。 |
| line_quantity | 訂閱方案包含的每個商品項目的數量。 若訂閱方案包含多個商品項目，則新增的數量應為該特定品項的數量，而不是包含所有品項的總數量。 |
| line_current_price | 以正確幣別格式顯示的訂閱商品項目價格。 |
| line_selling_plan_id | 訂閱方案的 ID，例如 3607724288。 此欄位為選填。 |
| line_selling_plan_name | 訂閱方案的名稱。 此欄位為選填。 |
使用 CSV 檔案匯入合約
您可以使用 CSV 檔案，從 Shopify App Store 中的合格第三方訂閱應用程式匯入現有合約，或是從其他商店使用 Shopify Subscriptions 應用程式匯入現有合約。
CSV 檔案不能用於編輯或覆寫現有合約。匯入過程會忽略現有的重複合約。
從第三方訂閱應用程式匯入合約
您可能能夠從第三方訂閱應用程式匯入合約。從第三方應用程式匯入時，請考量下列行為：
- 如果您的第三方訂閱應用程式未整合 Shopify Checkout，則無法匯入合約。
- 您無法直接從第三方應用程式匯入資料。若要匯入資料，您必須將第三方應用程式中的合約資料以正確格式加到與 Shopify Subscriptions 應用程式相容的 CSV 檔。
- 如果第三方訂閱應用程式沒有匯出功能，或者匯出的資料不包含所有必要資料，請聯絡應用程式開發人員以尋求支援。
步驟如下：
- 在 Shopify 管理介面中，前往「訂閱」>「合約」。
- 按一下「匯入」。
- 點擊「新增檔案」，然後選取要匯入的 CSV 檔案。
- 按一下「上傳檔案」。
上傳 CSV 檔案後，您將透過用於開設 Shopify 商店的電子郵件帳號收到 Shopify 的確認電子郵件。請參閱常見匯入錯誤的解決方案，協助您解決任何匯入問題。
使用 CSV 檔案匯出合約。
您可以匯出合約以進行記錄，或匯入已安裝 Shopify Subscriptions 應用程式的其他 Shopify 商店。
步驟如下：
- 在 Shopify 管理介面中，前往「訂閱」>「合約」。
- 按一下「Export」(匯出)。