如何将您的 WooCommerce 商店迁移至 SHOPLINE – SHOPLINE 常见问题

为了帮助您在保持业务连续性的同时快速过渡到 SHOPLINE，SHOPLINE 提供了店铺一键搬迁工具（Multi-platform Store Migration app），支持将 WooCommerce 店铺的商品、客户等数据快速迁移至 SHOPLINE，并同步保持 Google 渠道商品 Feed 与数据上报的一致性，无需手动逐条录入。使用该工具，您可以完成从店铺授权、选择迁移模块到处理失败数据的完整迁移流程。本指南将说明迁移的整体流程，包括迁移前的准备工作、如何选择迁移模块、如何处理迁移失败的数据，以及迁移完成后需要进行的后续设置。

注：若要迁移 Shopify 或 Shoplazza（店匠）店铺，请分别参阅《如何将您的 Shopify 商店迁移至 SHOPLINE》与《如何将您的 Shoplazza 商店迁移至 SHOPLINE》。

WooCommerce 迁移流程总览

从 WooCommerce 迁移到 SHOPLINE 包含以下 7 个阶段：

阶段	章节	说明
1	迁移前的店铺准备工作	完成店铺配置检查，避免迁移数据触发异常通知。
2	获取 WooCommerce 店铺的 REST API 信息	在 WooCommerce 后台生成 REST API，并在 SHOPLINE 中完成店铺授权。
3	选择要迁移的数据模块	选择需要迁移的商品、客户及 301 重定向数据，并按需配置 Google 广告 Feed 同步。
4	开始搬迁	开始在 SHOPLINE 搬迁。
5	处理迁移失败的数据	查看并处理迁移失败的数据。
6	二次搬迁：迁移增量数据	如需在切换域名前补充迁移新增数据，可再次发起迁移。
7	完成迁移并绑定店铺域名	完善店铺配置，绑定 WooCommerce 独有域名，正式开始运营。

迁移前的店铺准备工作

在开始迁移之前，请先完成以下准备工作，避免因数据迁移而影响店铺的正常运营：

关闭邮件通知：关闭店铺后台客户、订单相关的邮件通知，避免在店铺创建客户或订单后自动向客户发送邮件造成打扰。
向支付渠道报备：向支付渠道报备您的店铺将切换 SAAS 平台，以免影响支付功能。
备份广告数据（可选）：迁移前备份原广告渠道的 Feed 文件并确认原商品 ID，可作为验证广告数据是否成功迁移的参考文件。
清空商品数据（可选）：若您需要进行 Feed 迁移，由于非迁移应用写入的商品无法做 Feed 对应，请务必提前清空 SHOPLINE 商品数据。

获取 WooCommerce 店铺的 REST API 信息

在选择迁移模块之前，您需要先在 WooCommerce 店铺管理后台创建 REST API，让店铺一键搬迁工具能够读取您的店铺数据。

在 WooCommerce 管理后台 完成以下操作：

进入 WooCommerce > 设置 > 高级 > REST API，点击【添加 Key】。
输入描述后，点击【生成 API Key】。
创建成功后，保存并复制生成的 API Key 和 API Secret。

完成 WooCommerce 后台的 API Key 生成后，前往 SHOPLINE 商家后台完成搬迁工具的店铺授权：

完成店铺创建，在进行店铺装修设置前，前往 SHOPLINE 应用市场 安装 多平台店铺一键搬迁。
在插件页面选择 WooCommerce 渠道，点击【开始搬迁】。
输入 WooCommerce 店铺域名（域名不需要 https:// 前缀），并粘贴前面获取的 Consumer Key 与 Consumer Secret，完成后进入下一步。

选择要迁移的数据模块

完成店铺授权后，您可以选择需要迁移的数据模块：

模块	说明	依赖模块
商品	商品基本信息，包括商品名、价格、描述、商品图、规格信息、标签等。商品分类，仅支持手动分类。	—
客户	客户基本信息（客户名、手机号、邮箱号、用户地址等）。	—
订单	订单（订单基础信息，包括订单商品、订单金额、收货人等）	依赖商品、客户模块
301 重定向	原平台已配置的 301 重定向数据，保证搬迁过来之后对应的链接跳转正常。	—
商品评价	商品评价数据，包含评价人、评价内容等。	依赖商品模块

建议的模块迁移顺序

商品、客户、301重定向
订单、商品评价

强依赖模块规则

部分模块之间的业务数据存在强依赖关系：

订单和依赖商品、客户数据。若存在商品或客户数据未搬迁，会导致订单数据异常，且无法修正。
商品评价依赖商品。商品评价不支持覆盖更新，重复搬迁会导致评价数据重复。

影响点：

商品缺失时将创建自定义商品，影响发货和退货退款。客户缺失时将新创建客户，导致“客户加入时间”错误。

订单模块与商品、客户模块同一批次搬迁时，若依赖模块搬迁成功率未达标（低于95%），系统就不会继续搬迁订单。

Notes:

若基础模块的异常数据无法修正，指标无法达到 95% 并影响后续模块搬迁，可联系客服经理或邮件至 erp@shopline.com

订单模块，满足以下条件时可选择单独搬迁：

依赖模块最近一次全量搬迁的记录在 90 天内。全量搬迁指未设置自定义范围（搬迁范围是 “全部”），不包括搬迁任务被中断、被终止的记录。
依赖模块最近一次全量搬迁的成功率大于等于 95%。若不达标，可以通过【重试】失败数据刷新成功率。

同步迁移广告数据

如果您正在运行 Google 广告，为确保迁移后广告效果不中断，请根据您选择的工具完成以下操作：

使用 SHOPLINE 官方 Smart Feed 应用（推荐）：在完成店铺基础数据迁移后，建议安装 Smart Feed 应用。该工具支持从 WooCommerce 迁移商品 Feed，您可直接在应用内完成所有配置以确保 ID 匹配。详细操作请参考《Smart Feed（新版）：从 Shopify、WooCommerce 与 Shoplazza 搬迁商品 Feed 指南（限量开放）》。
使用第三方 Simprosys 插件：若您选择使用 Simprosys 迁移 Google 广告数据，需要在搬迁插件里设置 Feed 的规则，并完成搬迁。请务必在开始前清空 SHOPLINE 店内已有的非搬迁商品，以避免 Feed 对应失败。

开始搬迁

完成以上搬迁内容的勾选后，点击 开始搬迁，进行店铺迁移。

处理迁移失败的数据

迁移完成后，可能会有部分数据因系统错误或数据不符合规范而迁移失败。您可以按模块查看和处理这些失败数据：

迁移结束后，在迁移结果页面查看迁移失败的数据详情。
支持按模块导出失败数据，每次迁移的导出上限为 1 万条。若单模块失败数据超出限制，建议先分析并处理部分失败问题，点击【重试】后再尝试导出。

二次搬迁：迁移增量数据

若您已完成一次完整迁移，后续仍需迁移新增数据（例如在切换域名前），可以再次发起迁移，这一操作称为「二次搬迁」：

已迁移数据：对于已迁移的数据，可以选择是否覆盖更新，默认不覆盖。选择「覆盖更新」会对已搬迁的数据做覆盖更新，适用于已迁移数据需要更新或修正的场景；选择「不覆盖」时已迁移数据会自动跳过，适用于数据无变动的场景。

完成迁移并绑定店铺域名

数据迁移完成后，您可以进一步完善店铺建站配置，包括商城模板配置、支付配置、广告 Pixel 设置、meta 验证、sitemap 提交等，同时也包括广告 Feed 同步。其中广告 Pixel 设置需保持跟原渠道 ID 一致。

店铺搭建完毕后，可以将 WooCommerce 店铺的独有域名绑定至 SHOPLINE，正式开始运营。

WooCommerce 商店搬迁重要须知

SKU 搬迁规则：SHOPLINE 按照商品属性值笛卡尔积生成 SKU，即将商品的不同属性进行排列组合，得到所有可能的商品类型。因此，当额外生成的 SKU 在 WooCommerce 没有时（WooCommerce 可仅存在部分属性的 SKU），此 SKU 的价格和库存默认为条件「Any」对应的库存和价格。当商品属性值的别名与标准名称不一样，且该 SKU 有设置无属性的情况时，商品里会同时生成标准名称和别名两种属性。
商品促销价规则：当有促销价且促销价有时间限制时，常规价为 SHOPLINE 销售价；当有促销价但促销价无时间限制时，促销价为 SHOPLINE 销售价；当无促销价时，常规价为 SHOPLINE 销售价。
商品短描述字段：由于 WooCommerce 的短描述字段为 HTML 格式，SHOPLINE 为文本格式，格式无法对应，因此该字段无法支持搬迁。
客户账号激活：SHOPLINE 支持在客户无感知的情况下完成账号注册流程。搬迁客户进入登录页面，直接输入账号密码后，通过邮箱验证码即可完成账号激活。
手机号登录权限：店铺需开通支持手机号注册登录权限，否则搬迁过来仅有手机号的客户将无法登录。您可以前往设置 > 客户中进行勾选配置。

常见问题

Q1：为什么显示的搬迁商品数量和实际搬迁完成的商品数不一致？

商品智能分类无法进行搬迁。商品搬迁数量统计包括商品数、SKU 数、分类数，以及商品与分类关系绑定数。

Q2：后台客户数量显示为什么跟搬迁数量不一致？

因为客户数量统计不是实时更新，会有数据延迟约 1.5 小时（例如搬迁 4 万条客户数据，后台展示总数为 2 万条，一个多小时后数据更新才会显示正常）。