Transporter 应用的问题排查

Transporter 应用在处理和导入对象时可能会出错。

如果导入状态为已失败,则表明您的 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 出现 bug,无法保存

    许多场景中都可能生成此错误,请首先检查是否有某个元字段在一条记录中出现了多次。Transporter 应用不支持具有重复元字段的记录。

  • 失败。响应代码 = 400。响应消息 = 错误请求

    由于数据中存在错误,因此 Transporter 无法在 Shopify 中创建对象。常见错误包括:

    • 货币值必须以 ISO 4217 格式指定(例如,美元)
    • 国家/地区代码、省/州和邮政编码必须有效
    • 电话号码无论在格式方面还是在国家/地区代码和区号方面都必须有效。
    • 电子邮件地址必须包含有效的域名。
    • 财务状态必须是允许的值之一。
    • 发货状态必须是一个允许的值。
    • 布尔值必须指定为 truefalse
    • 如果输入小数值,则不会导入任何要求整数的列(例如,产品 CSV 中的产品多属性库存数量或订单 CSV 中的订单产品数量)。例如,输入 5(而非 5.0)。某些电子表格软件(如 Numbers)可以将小数或浮点值显示为整数。请在文本编辑器中仔细检查您的值。
    • 如果您输入非数字值(如字母),则需要整数的任何列(例如订单 CSV 文件中的总重量交易地点 ID)都将不会导入。
  • 值类型未包含在列表中 检查元字段列中的值。若要导入元字段,您需要在以下 4 个元字段列中包含值:元字段命名空间元字段密钥元字段值元字段值类型。出现此错误的常见原因是其中一个或多个列中为空或包含无效的值。

  • Column-name 无效 许多场景中都可能生成此错误。例如,可能因为列区分大小写而出现此错误。对于接受值列表的列,您需要遵循列描述中使用的大小写。例如,在订单 CSV 中,财务状态列中的值区分大小写。这意味着,如果您输入 Paid 而不是 paid,则将出现财务状态无效错误。

导入流程的作用原理

在排除错误时,了解 Transporter 应用如何上传和导入数据以及在这些过程中可能发生的常见错误非常有用。

将对象导入 Shopify 商店时,Transporter 应用会执行以下操作:

显示了一些导入错误的 Transporter 应用

  1. 将文件上传到 Shopify 托管的安全暂存位置。若要详细了解 Shopify 如何保护您上传的信息,请参阅 Shopify 的隐私政策

  2. 通过检查结构和内容格式是否存在错误来准备好文件。如果 Transporter 应用发现任何错误,您的导入则将失败,并且导入状态将为已失败

  3. 通过导入对象来处理文件。导入的时间取决于要处理的对象数(平均处理速率为 40 个对象/秒)。导入完成时,其状态为已完成。如果存在 Transporter 应用无法导入的记录,则表中将出现导出错误链接。

您可以通过单击 Stop import(停止导入)随时停止导入其他对象。在您停止导入之前已导入的对象将保留在您的 Shopify 商店中。停止导入时,导入状态为已停止

相关链接

准备好开始使用 Shopify 进行销售了吗?

免费试用