Transporter App 疑難排解

Transporter 應用程式在處理您的紀錄並將其匯出為物件時,有時會發生錯誤。

匯入程序的運作方式

您在對 Transporter 應用程式進行疑難排解時,應瞭解此應用程式如何上傳、匯入您的資料,這些過程中可能發生哪些常見錯誤,以及這些錯誤發生的原因。您可以從 Shopify 管理員介面前往「應用程式」>「Transporter」,即可找到匯入作業的狀態。

將物件匯入 Shopify 商店時,Transporter 應用程式會執行下列動作:

  1. 將檔案上傳到 Shopify 代管的安全預備位置。若要瞭解 Shopify 如何保護您上傳的資訊,請參閱 Shopify 的隱私權政策

  2. 檢查檔案有無結構與內容格式錯誤。如果 Transporter 應用程式發現任何錯誤,然後匯入失敗,其狀態會變更為「失敗」。

  3. 匯入物件。匯入的時間取決於須處理的物件數量 (平均處理速率為每秒 40 個物件)。匯入結束時,狀態會變更為「已完成」。如果有 Transporter 應用程式無法匯入的記錄,表格中會顯示「匯出錯誤」連結。

您隨時都可以按一下「停止匯入」來停止匯入其他物件。而在您停止匯入之前已經匯入的物件,則會保留在 Shopify 商店中。匯入停止後,狀態會變更為「已停止」。

匯出及修正錯誤

如果您匯入時發生問題,您可以按一下「匯出錯誤」,瞭解如何修正這些錯誤。如需有關錯誤代碼的詳細資訊,請參閱下方的常見錯誤代碼清單。

顯示「匯出連結」連結的 Transporter 表格

修正錯誤的程序會些微差異,需視匯入作業的狀態是「失敗」還是「已完成」而定。

失敗

若匯入狀態為「失敗」,就表示 CSV 檔案本身有問題,而不是檔案內容。在您檢閱過錯誤文字檔案後,請修正原本上傳檔案中的錯誤,然後再重新上傳檔案。

已完成

如果「已完成」的匯入作業發生錯誤,則代表個別紀錄有誤,而不是 CSV 檔案結構的問題。在此情況下,Shopify 只會建立沒有錯誤的記錄,不會建立有錯誤的記錄,但會將有錯誤的紀錄新增至匯出錯誤 CSV 檔案。在匯入作業完成且狀態顯示「已完成」前,您不會看到匯出錯誤 CSV 檔案。匯入作業完成後,「匯出錯誤」連結會顯示在表格中。

在錯誤 CSV 檔案中每一列的最後一欄會說明該記錄的錯誤。您下載檔案後,請在此檔案中修正錯誤,再重新上傳,上傳前不必刪除錯誤欄。

在以下範例中,有三位客戶已經存在於商店中,因此您無法將他們匯入

First Name,Last Name,Email,Error(s)
 Jane,Doe,jane.doe01520022060@example.com,...,Email has already been taken
 Jane,Doe,jane.doe11520022060@example.com,...,Email has already been taken
 Jane,Doe,jane.doe21520022060@example.com,...,Email has already been taken

Shopify 會根據客戶的專屬電子郵件地址來識別客戶,而以下這三筆電子郵件地址歸 Shopify 商店中現有客戶所有。

常見錯誤代碼

常見檔案錯誤包括:

  • Shopify API 發生問題,因此無法儲存

    幾個不同的原因可能造成此錯誤,最常見的原因是單一中繼欄位在紀錄中重複出現。Transporter 應用程式不支援含有重複中繼欄位的紀錄。如果移除重複中繼欄位還是不能解決此問題,請聯絡 Shopify 支援服務。

  • 失敗。回應碼 = 400;回應內容 = 錯誤的要求

    由於資料發生錯誤,Transporter 應用程式無法在 Shopify 中建立物件,這通常是因為資料格式錯誤所造成的。請確認您的資料符合以下條件:

    • 貨幣值必須指定為 ISO 4217 格式 (例如 USD)。
    • 國家/地區、省/州和郵遞區號須為有效。
    • 電話號碼必須為有效的格式,並包含國家/地區代碼和地區代碼。
    • 電子郵件地址必須包含有效網域。
    • Financial Status」必須為允許的值之一。
    • Fulfillment Status」必須為允許的值之一。
    • 布林值必須指定為 truefalse
    • 所有需要使用整數的欄如果輸入包含小數點的值,就無法匯入 (例如產品 CSV 中的「產品子類選項庫存數量」或訂單 CSV 中的「明細項目數量」)。舉例來說,應輸入「5」,而非「5.0」。某些試算表軟體 (例如 Numbers) 可將包含小數點的值或浮點數顯示為整數。請再三檢查文字編輯器中的值。
    • 所有必須使用整數的欄如果輸入非數字的值 (例如字母),則無法匯入 (例如訂單 CSV 中的「總重量」或「交易地點 ID」)。
  • 值類型不包括在清單中

    請檢查中繼欄位中的值。若要匯入中繼欄位,您必須納入以下欄位:「中繼欄位命名空間」、「中繼欄位金鑰」、「中繼欄位值」和「中繼欄位值類型」。這項錯誤經常在這些欄位其中一或多個的值空白或無效時發生。

  • 「欄名稱」``無效

    幾個不同的原因可能造成此錯誤,舉例而言,其中一個原因可能是因為某欄需區分大小寫。某些欄位只接受清單中的值,您必須按照欄說明中使用的大小寫。例如在訂單 CSV 中,「Financial Status」欄位的值須區分大小寫。這表示如果您輸入 Paid 而非 paid,就會發生「Financial Status 無效」的錯誤。請檢查其他欄位的值是否已按照正確格式輸入。

  • 無效的訂單狀態 - 不能同時為「已出貨」和「取消」

    Shopify 無法建立狀態同時為「已出貨」和「取消」的訂單。若下列情況同時出現,會發生此錯誤:

    • 訂單有 cancelled_at 時間戳記。
    • 訂單的 fulfillment_status 設為「已出貨」或「部分」。

    financial_status 顯示為「已退款」,則可成功建立有 cancelled_at 時間戳記且 fulfillment_status 設為「已出貨」或「部分」的訂單。

如果您遇到未列於此處的錯誤代碼,請聯絡 Shopify 支援服務。

相關連結

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

免費試用