Start Strong
Sell Smart
Manage with Ease
Market to Success

店铺搬迁失败常见问题排查

店铺搬迁可以帮助您将原平台的业务数据迁移到 SHOPLINE，但当必填数据缺失、数据暂不支持、数据重复，或与 SHOPLINE 店铺设置不一致时，部分记录可能搬迁失败。

本文将说明如何查看原始搬迁报错、修正常见源数据问题、操作重试失败项目，以及判断何时联系 SHOPLINE 支持团队。

 

 

商品和商品分类搬迁报错

当商品、库存或商品分类数据搬迁失败时，请参考下表：

数据类型搬迁结果中提供的信息如何查看和使用
商品商品Handle（Product handle）可使用商品 handle 在原平台找到对应的商品。店匠修改商品名称可能会导致Handle变更。
商品分类商品分类Handle（Collection handle）可使用 collection handle 在原平台找到对应分类或智能分类
原始报错信息代表含义处理建议
column:product_category_id unsupport / product_category_id_with_descendants unsupport智能分类使用了暂不支持的标准商品类型条件。请先在原平台修改智能分类条件，然后操作重试。
body.smart_collection: The required property 'rules' is missing from the object智能分类没有设置任何条件。请在原平台检查该智能分类的条件是否为空。补充有效条件后再操作重试。
SORTATION_CONDITION_INVALID商品分类的排序类型暂不支持。此类排序规则暂不支持，可联系 SHOPLINE 支持团队。
The product or category relocation failed, resulting in the inability to bind the category relationship. Please try again.部分商品或分类搬迁失败，导致分类关系无法绑定。请重试该失败数据。如果仍然失败，请先确认相关商品是否已成功搬迁。
Failed to add product[At least one of the image ID or src should be valued.];商品没有可用图片。请在原平台至少添加一张商品图片，然后操作重试。
Failed to update product[You need to add option values for color_family];商品规格项 color_family 缺少规格值。请在原平台补充缺失的规格值，然后操作重试。
activation inventory Error[System error, please try again.];库存激活失败，通常与相关库存地点未成功搬迁有关。请先检查库存地点是否已成功搬迁，然后操作重试。

 

 

弃单和订单搬迁报错

当弃单或订单搬迁失败时，请参考下表：

数据类型搬迁结果中提供的信息如何查看和使用
弃单弃单ID（Checkout ID）可使用弃单ID在原平台找到对应弃单
订单订单ID（Order  ID）可使用订单 ID 在原平台找到对应订单
原始报错信息代表含义处理建议
Item in abandoned order is invalid.弃单中的商品在 SHOPLINE 中不存在。该商品可能搬迁失败，或已在原平台被删除。如果商品搬迁失败，请先完成商品搬迁。如果商品已在原平台删除，该弃单无法在本次批次中搬迁。
buyerinfo must contain userId, email or phone弃单缺少足够的顾客联系方式。请确认原平台中的弃单是否包含邮箱或手机号。如果两者都没有，该弃单无法召回，也不支持搬迁。
presentmentCurrency does not match market currency弃单使用的交易币种不存在于当前 SHOPLINE 市场设置中。请检查 SHOPLINE 的市场和货币设置，并确保与原平台一致。
Creation failed: A-INVALID_ARGUMENT: Market CA not find弃单对应的市场在 SHOPLINE 中不存在。请检查 SHOPLINE 的市场设置，并确保已创建所需市场。
Creation failed: A-INVALID_ARGUMENT: invalid RelocateAbandonedOrderRequest.AbandonedOrder: embedded message failed validation | caused by: invalid AbandonedOrderRelocationDTO.SellerNote: value length must be at most 1000 runes卖家备注超过字符限制。请在原平台缩短卖家备注，然后操作重试。
Creation failed: A-INVALID_ARGUMENT: duplicate discount code: BOGOS-BPuyW55同一笔订单重复使用了相同折扣码。请在原平台修正该折扣数据。若未修正，此类异常数据不支持搬迁。
create refund order: ["SYSTEM_ERROR","OFC_123686_B1002"]订单退款金额超过实际支付金额。请在原平台核对订单。如果退款金额高于支付金额，该订单不支持搬迁。

 

 

客户搬迁报错

当客户资料搬迁失败时，请参考下表：

数据类型搬迁结果中提供的信息如何查看和使用
客户客户邮箱Email、手机号Phone和客户 ID（Customer id）若客户创建失败，会提供客户邮箱或手机号，用于在原平台找到对应的客户；若客户已创建但数据异常，会提供客户ID
原始报错信息代表含义处理建议
email is illegal argument客户邮箱格式不正确。请在原平台修正客户邮箱格式，然后操作重试。
code=DATA_NOT_EXIST, alertMessage=data does not exist, debugMessage=data does not exist, suppressedErrors=[]服务请求失败，或所需数据不存在。请稍后重试。如果多次重试仍失败，请联系您的 SHOPLINE 客户经理或 SHOPLINE 支持团队。
code=0003, alertMessage=There are different accounts registered with email and mobile phone, debugMessage=There are different accounts registered with email and mobile phone, suppressedErrors=[]不同客户账号使用了相同邮箱或手机号。请在原平台修正重复客户资料。若未修正，此类异常数据不支持搬迁。
Email consent state is 'Subscribed' or 'Pending', email cannot be empty客户被标记为已订阅或待确认邮件营销，但邮箱为空。请在原平台补充客户邮箱，或修改邮件营销状态，然后操作重试。
Verified_email is yes, email cannot be empty客户被标记为邮箱已验证，但邮箱为空。请在原平台修正客户邮箱数据。若未修正，此类异常数据不支持搬迁。

 

 

折扣、礼品卡、元字段和元对象搬迁报错

当促销数据或自定义数据搬迁失败时，请参考下表：

数据类型搬迁结果中提供的信息如何查看和使用
折扣折扣活动 ID （discount rule id）和折扣码Code（Discount Code）若折扣活动创建失败，会提供活动 ID；若折扣码创建失败，会提供折扣码Code
礼品卡礼品卡 ID（gift card id）可使用礼品卡 ID 在原平台找到对应礼品卡
元字段所属资源（ownerResource）、资源 ID（ownerId）、命名空间（namespace）、Key、元字段 ID 和元字段类型(type）

若元字段定义创建失败，可通过所属资源、namespace、Key 或元字段 ID 定位具体元字段；


 

若某个数据的元字段创建失败，需额外关注资源 ID，用于定位所属资源，例如商品的元字段，资源ID就是商品ID

元对象条目和定义

定义名称（Metaobject name）、定义ID、定义类型(type）


 

条目 handle（Entry handle）、条目 ID

若元对象定义创建失败，可通过元对象名称或定义ID定位具体定义；


 

若元对象条目创建失败，可通过条目 handle 或条目 ID 找到具体条目；

原始报错信息代表含义处理建议
graphql: Service call fail.临时服务请求失败。请稍后重试。如果多次重试仍失败，请联系您的 SHOPLINE 客户经理或 SHOPLINE 支持团队。
Only one specified activity can be effective for a product in the same channel at the same time.同一渠道下，同一商品在同一时间内存在多个自动折扣活动。请在原平台检查并修正冲突的折扣设置，然后操作重试。
Items must be defined in 'customer get' when the 'customer get item all' is false折扣设置为指定商品可享受优惠，但未指定商品。若为买 X 送 Y，可能是赠品未设置。请检查原平台折扣是否已指定商品。如果已指定商品，请确认相关商品已成功搬迁。
customers and customerSegments can not be empty at the same time折扣指定了客户或客户细分，但目标列表为空，或目标客户/细分未成功搬迁。请检查原平台中的指定客户或客户细分设置。如果已设置，请确认相关客户或细分已成功搬迁。
Percentage must be between 0.00 - 1.00折扣百分比超出支持范围。请在原平台修改折扣百分比，然后操作重试。
The discount amount value must be between 0.01 - 99999999999.00优惠金额超出支持范围，或金额为 0。请在原平台修改优惠金额，然后操作重试。
The input value is already present.折扣活动规则已存在。请确认该折扣是否已经成功搬迁。如果折扣规则正确，可以忽略此报错。
Discount type is not supported.该折扣类型暂不支持搬迁。目前支持的折扣类型包括订单折扣、商品折扣、买 X 送 Y 和免运费。
Currently, it is not supported to set discount rules for both product and product variants折扣同时设置在商品层级和 SKU/变体层级。此类设置目前暂不支持。如需协助重建折扣，请联系 SHOPLINE 支持团队。
REQUEST_LIMIT_EXCEEDED搬迁数据量较大，触发请求限制。请稍后重试，或联系您的 SHOPLINE 客户经理申请提高限制。
discount code repeat该折扣码已存在。请确认该折扣码是否已经成功搬迁。如果已正确搬迁，可以忽略此报错。
invalid GiftCardCreateOpenRequest.Note: value length must be at most 500 runes礼品卡备注超过字符限制。请在原平台缩短礼品卡备注，然后操作重试。
Metafield type is not supported. / type invalid.该元字段类型暂不支持。请在原平台修改元字段类型，或联系 SHOPLINE 支持团队。
key not allow number元字段值或 Key 使用了不支持的数字格式。请在原平台修改该元字段的值或 Key，然后操作重试。
failed to get reference value元字段引用的资源不存在，例如图片、视频、商品或页面。请确认被引用的资源已成功搬迁，然后操作重试。
Key must be at least 3 characters in length元字段 Key 长度少于 3 个字符。请在原平台修改元字段 Key 名称，然后操作重试。
json: cannot unmarshal string into Go struct field ShoplineMetafieldDefinition.definition.id of type int64元字段数据无法处理。请联系 SHOPLINE 支持团队协助处理。
`single_line_text_field` must be consistent with the definition's type: 'boolean'元字段值与字段类型不匹配。请在原平台修改元字段类型或字段值，或联系 SHOPLINE 支持团队。
VALIDATION_ERROR: "metaobject_definition_id" validation value "gid://shopify/MetaobjectDefinition/9186738408" is invalid元字段引用了无效的元对象。请确认元对象数据已成功搬迁，然后操作重试。
metafield definition already exists元字段定义已存在。如果数据已正确搬迁，可以忽略此报错。
Failed to get reference value. Please check if the related resources have been moved.元对象条目引用的资源不存在，例如图片、视频、商品或页面。请确认被引用的资源已成功搬迁，然后操作重试。
body.metaobject.fields.#n: The required property 'value' is missing from the object某个必填元对象字段缺少值。请在原平台检查元对象条目并补充缺失值，然后操作重试。
This field type is a meta-object but cannot match the definition.元对象字段无法匹配对应定义。请确认作为字段值的元对象已成功搬迁。
definition.type: value does not match regex pattern `^[A-Za-z][A-Za-z0-9_-]*$`元对象定义类型名称包含不支持的字符。请在原平台修改元对象类型名称，仅使用字母、数字、连字符和下划线。

 

 

发货物流和库存地点相关报错

当物流方案、配送规则、库存地点或库存激活失败时，请参考下表：

数据类型搬迁结果中提供的信息如何查看和使用
发货物流物流方案名称（Profile name）使用物流方案名称在原平台找到对应物流方案
原始报错信息代表含义处理建议
Failed to set Profile[invalid ProductGroupSetReq.DeliveryLocationGroupList[0]: embedded message failed validation | caused by: invalid SetDeliveryLocationGroupReq.DeliveryPlans: value must contain at least 1 item(s)];物流方案缺少配送规则，或配送规则关联的商品未成功搬迁。请检查原平台物流数据是否完整。如果数据完整，请确认配送规则指定的商品已成功搬迁。
activation inventory Error[System error, please try again.];如果相关库存地点未成功搬迁，库存激活可能失败。请检查库存地点是否已成功搬迁，然后操作重试。

 

 

搬迁后的客户统计数据说明

客户的总订单数和总消费金额取决于是否同步搬迁订单。如果只搬迁客户、不搬迁订单，客户详情页可能不会显示历史订单数量或历史消费金额。

注意：如需在搬迁后显示客户总订单数和总消费金额，请将订单与客户数据一起搬迁。

 

 

无法解决搬迁报错时请联系 SHOPLINE 客服

如果搬迁失败，且您无法根据本文的排查建议解决报错，请根据报错信息和表格中的处理建议，判断应该稍后重试还是联系 SHOPLINE 客服。

  • 稍后重试：适用于临时服务失败或请求限制。
  • 联系 SHOPLINE 客服：适用于多次重试后仍失败、报错显示设置暂不支持，或表格中建议联系支持团队的情况。