匯入和匯出合約 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 控制代碼是每個合約的唯一識別碼。控制代碼可以包含字母和數字,並且通常是字母及/或數字的組合字串。每個合約必須具有唯一的控制代碼。
upcoming_billing_date 合約的下一期結帳日期。時間以 UTC (世界協調時間) 為準,格式必須為 YYYY-MM-DDTHH:MM:SSZ。例如,UTC (世界協調時間) 時區 2019 年 9 月 7 日下午 3:50 會顯示為 2019-09-07T15:50:00Z
customer_id 顧客 ID。ID 必須與 Shopify 管理介面中現有顧客的 ID 相符。
currency_code 合約的幣別代碼。幣別代碼必須與商店已啟用的幣別相符。
status 合約狀態。合約可具有以下其中一個狀態:
  • 啟用中
  • 已暫停
cadence_interval 訂閱的配送頻率。合約可使用以下任一配送頻率:
cadence_interval_count 訂閱在整體時間間隔內的配送頻率。例如,每月的配送頻率計數是 1,而每兩週的配送頻率則是 2。
customer_payment_method_id 顧客用於合約付款方式的 ID。
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 配送地址所在省分或州別。只有使用運送當地配送時才需要填寫此欄位。
delivery_address_country_code 配送地址的國家/地區代碼。只有配送方式為「運送」或「當地配送」時,才需要加入此欄位。
delivery_address_company 配送地址的公司名稱。只有商家訂單且配送方式為「運送」或「當地配送」時,才需要加入此欄位。
delivery_address_zip 配送地址所屬郵遞區號。只有使用運送當地配送時才需要填寫此欄位。
delivery_address_phone 配送地址對應的聯絡電話。只有使用運送當地配送時才需要填寫此欄位。
delivery_local_delivery_phone 配送地址的電話號碼。若訂閱項目的配送方式為當地配送,此欄位為必填。
delivery_local_delivery_instructions 當地配送說明。只有為使用「當地配送」方式的訂閱項目提供說明時,才需要加入此欄位。
delivery_pickup_method_location_id 取貨方式的地點 ID。只有使用到店取貨方式的訂閱項目,此欄位才為必填。
line_variant_id 訂閱方案包含的每個商品項目的 ID。若訂閱方案包含多個商品項目,則每個商品項目必須新增為具有唯一子類 ID 的新行。
line_quantity 訂閱方案包含的每個商品項目的數量。若訂閱方案包含多個商品項目,則新增的數量應為該特定商品項目的數量,而不是包含所有商品項目的總數量。
line_current_price 以正確幣別格式顯示的訂閱商品項目價格。
line_selling_plan_id 訂閱方案 ID。此欄位為選填。
line_selling_plan_name 訂閱方案的名稱。此欄位為選填。

使用 CSV 檔案匯入合約

您可以使用 CSV 檔案,將現有合約從 Shopify App Store 或其他 Shopify 商店的第三方訂閱應用程式匯入 Shopify Subscription 應用程式。CSV 檔案不能用於編輯或覆寫現有合約。匯入過程會忽略現有的重複合約。

步驟如下:

  1. 在 Shopify 管理介面中,前往「訂閱」>「合約」。
  2. 按一下「匯入」。
  3. 點擊「新增檔案」,然後選取要匯入的 CSV 檔案。
  4. 按一下「上傳檔案」

上傳 CSV 檔案後,您將透過用於開設 Shopify 商店的電子郵件帳號收到 Shopify 的確認電子郵件。請參閱常見匯入錯誤的解決方案,協助您解決任何匯入問題。

使用 CSV 檔案匯出合約。

您可以匯出合約以進行記錄,或匯入已安裝 Shopify Subscriptions 應用程式的其他 Shopify 商店。

步驟如下:

  1. 在 Shopify 管理介面中,前往「訂閱」>「合約」。
  2. 按一下「Export」(匯出)。

準備好開始透過 Shopify 銷售商品了嗎?

免費試用