Transporter App 疑難排解

Transporter App 在處理與匯出物件時有時會發生錯誤。

如果匯出狀態為「失敗」,表示您的 CSV 檔案有問題 (並非記錄層級的錯誤)。若要檢視這些檔案錯誤,請按一下表格中的「匯出錯誤」連結,下載匯出錯誤檔案並檢查錯誤。修正上傳檔案中的錯誤後,請再重新上傳檔案。

如果 Transporter 在嘗試匯入物件時發生錯誤,Shopify 就不會建立這些記錄。相反地,這些記錄會加入匯出錯誤 CSV 檔案,而匯入作業會繼續進行下一筆記錄。匯入作業完成後 (狀態為「已完成」),您才能查看匯出錯誤 CSV 檔案。此時,表格中就會顯示「匯出錯誤」連結:

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

請下載 CSV 錯誤檔案。每個列的最後一項 (欄) 說明的是記錄的錯誤。請在此檔案中修正錯誤,然後加以上傳。不必刪除錯誤欄即可上傳這份檔案。

在以下範例中,有三位客戶已經存在於商店中,因此您無法將他們匯入 (Shopify 會根據客戶的專屬電子郵件地址來識別客戶,而以下這三筆電子郵件地址歸 Shopify 商店中現有客戶所有)。

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 API 發生問題,因此無法儲存

    有數種狀況可能導致這種錯誤,請先確認是否有某個中繼欄位在一筆紀錄中出現多次。Transporter App 不支援含有重複中繼欄位的記錄。

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

    由於資料中有錯誤,Transporter 無法在 Shopify 建立物件。常見的錯誤包括:

    • 貨幣值必須指定為 ISO 4217 格式 (例如 USD)。
    • 國家/地區代碼、省/州和郵遞區號必須有效。
    • 電話號碼的格式、國家/地區代碼和地區代碼皆必須有效。
    • 電子郵件地址必須包含有效網域。
    • 「財務狀態」``必須為允許的值之一。
    • 「訂單出貨狀態」``必須為允許的值之一。
    • 布林值必須指定為 truefalse
    • 所有需要使用整數的欄如果輸入包含小數點的值 (例如產品 CSV 中的「產品子類選項庫存數量」或訂單 CSV 中的「明細項目數量」),就無法匯入。舉例來說,應輸入「5」,而非「5.0」。某些試算表軟體 (例如 Numbers) 可將小數點或浮點值顯示為整數。請再三檢查文字編輯器中的值。
    • 所有必須使用整數的欄 (例如訂單 CSV 中的「總重量」或「交易地點 ID」如果指定了非數字的值 (例如字母),則無法匯入)。
  • 值類型不包括在清單中 請檢查中繼欄位欄中的值。若要匯入中繼欄位,您必須納入「中繼欄位命名空間」、「中繼欄位金鑰」、「中繼欄位值」和「中繼欄位值類型」這 4 個中繼欄位欄的值。這項錯誤經常在這些欄其中一或多個的值空白或無效時發生。

  • 「欄名稱」``無效 有數種狀況可能導致這項錯誤,比如說,如果某欄需區分大小寫,就可能發生這項錯誤。欄如果可接受值清單,即必須按照欄說明中使用的大小寫。舉例來說,在訂單 CSV 中,「財務狀態」欄的值需區分大小寫。也就是說,如果您輸入「`Paid`」,而不是「`paid`」,就會發生「財務狀態無效」的錯誤。

匯入程序的運作方式

對錯誤進行疑難排解時,建議先行瞭解 Transporter App 上傳並匯入資料的方式,以及這段過程中可能發生的常見錯誤。

將物件匯入 Shopify 商店時,Transporter App 會執行下列動作:

顯示部分匯入錯誤的 Transporter App

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

  2. 檢查是否有結構與內容格式錯誤,藉此備妥檔案。如果 Transporter App 發現任何錯誤,則匯入作業會失敗,且狀態將顯示為「已失敗」

  3. 匯入物件,藉此處理檔案。匯入作業的時間長度視要處理的物件數量而定 (平均處理速率為每秒 40 個物件)。匯入完成後,狀態會顯示為「已完成」。如果存在 Transporter App 無法匯入的記錄,表格中會顯示「匯出錯誤」連結。

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

相關連結

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

免費試用