Transporter 应用的问题排查

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 出现 bug,无法保存

    此错误可能由几个不同的原因导致。最常见原因是某个元字段在一条记录中多次出现。Transporter 应用不支持包含重复元字段的记录。如果删除重复的元字段无法解决此问题,请联系 Shopify 客服。

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

    Transporter 应用无法在 Shopify 中创建对象,因为数据中存在错误。此错误通常由数据格式不正确导致。请确保您的数据符合以下要求:

    • 货币值必须以 ISO 4217 格式指定(例如,美元)。
    • 国家/地区、省/州和邮政编码必须有效。
    • 电话号码必须采用有效的格式、国家/地区代码和区号。
    • 邮箱必须包含有效的域名。
    • 财务状态必须是允许的值之一。
    • 发货状态必须是允许的值之一。
    • 布尔值必须指定为 truefalse
    • 如果输入小数值,则任何要求整数的列(例如,产品 CSV 中的产品多属性库存数量或订单 CSV 中的订单产品数量)都将不会导入。例如,输入 5,而非 5.0。某些电子表格软件(如 Numbers)可以将小数或浮点值显示为整数。请在文本编辑器中检查您的值。
    • 如果您输入非数字值(如字母),则需要整数的任何列(例如订单 CSV 文件中的总重量交易地点 ID)都将不会导入。
  • 值类型未包含在列表中

    检查元字段列中的值。若要导入元字段,您需要在以下所有列中包含值:元字段命名空间元字段密钥元字段值元字段值类型。出现此错误的常见原因是其中一个或多个列中为空或包含无效的值。

  • Column-name 无效

    此错误可能由几个不同的原因导致。例如,此错误可能由列中区分大小写导致。对于接受值列表的列,您需要遵循列描述中使用的大小写。例如,在订单 CSV 中,Financial Status(财务状态)列中的值区分大小写。这意味着如果您输入 Paid(已支付)而不是 paid(已支付),则会出现 Financial Status is invalid(财务状态无效)错误。检查其余列,确保您输入的值遵循正确的格式。

  • 订单状态无效 - 无法同时具有“已发货”和“已取消”状态

    Shopify 无法创建同时具有“已发货”和“已取消”状态的订单。如果满足以下两个条件,则会出现此错误:

    • 订单具有 cancelled_at 时间戳。
    • 订单的 fulfillment_status 设置为已发货部分发货

    如果财务状态设置为已退款,则可以成功创建具有 cancelled_at 时间戳且 fulfillment_status 设置为已发货部分发货的订单。

如果您遇到此处未列出的错误代码,请联系 Shopify 客服。

相关链接

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

免费试用