Shopify 店铺迁移
本指南介绍如何使用 Genstore 迁移助手 将您的 Shopify 店铺数据（包括客户、商品、订单等）迁移至 Genstore。
前置准备
迁移前，请确保完成以下准备工作，以确保数据完整性和迁移顺利进行：
- 报备支付渠道：如 Shopify 店铺已启用支付功能，请提前通知支付渠道，以避免因店铺变更导致支付受限或风险。
- 确认店铺状态：确保 Shopify 店铺正常运营，无冻结、关闭或其他异常情况。
- 检查产品库存和订单状态：建议仔细检查 Shopify 店铺的产品库存和订单状态，确保数据准确。
- 备份 Shopify 店铺数据：强烈建议在迁移前备份 Shopify 店铺数据，以防意外情况。
- 清理无用数据：可清理无用的草稿订单、已取消订单等，以减少迁移数据量，提高效率。
开始迁移
TIP
- 店铺数据量较大时，迁移可能耗时较长。
- 迁移过程中请勿修改 API 权限，否则可能导致迁移失败。
- 尽量避免在迁移过程中对 Shopify 店铺进行大规模数据修改，以防数据不一致。
步骤一：获取 Shopify API 访问权限
- 登录 Shopify 后台，进入 设置 -> 应用和销售渠道。
- 点击 开发应用，创建一个新的自定义应用。
- 在 应用名称 处填写应用名称（建议自用即可），然后点击 创建应用。
- 进入 API 凭据 界面，勾选所有 Read（可读） API 权限，点击 保存。
- 点击 安装应用，获取 后台 API 访问令牌。注意：当前访问令牌仅可查看一次，请妥善保存。
- [可选] 若数据量较大，可创建第二个 Shopify 应用获取额外的 API Token，以提升迁移速度。
步骤二：打开 Genstore 迁移助手
- 登录 Genstore 商户后台，导航至 应用。
- 在 已安装 页签，找到 Migration Tool。
- 点击 打开应用，选择 Shopify 作为迁移来源，点击 开始搬迁。
步骤三：店铺授权
- 输入待迁移的 Shopify 店铺域名（示例：
sample.myshopify.com）。 - 输入访问令牌，即 *后台 API 访问令牌。
- [可选] 如有额外的 API Token，可点击 添加访问令牌 以提升迁移速度。
- 完成设置后，点击 下一步。
步骤四：选择迁移模块
Genstore 支持将 Shopify 的以下模块迁移至 Genstore：
- 店铺（必选）
- 客户（需勾选店铺模块）
- 产品（需勾选店铺模块）
- 订单（需勾选客户和产品模块）
TIP
- 订单迁移需同时勾选客户和产品模块，否则无法完成迁移。
- 迁移订单模块前，建议先迁移产品和客户。 这样可确保订单在迁移时能够正确关联至 Genstore 中的客户和产品信息。
如需了解各模块迁移的常见问题，请参阅 常见问题解答。
步骤五：自定义迁移设置
您可以根据筛选条件选择特定的数据进行迁移：
- 产品：按状态筛选（已发布、草稿、已归档等）。
- 订单：按订单创建时间筛选（如 2024-01-01 至 2024-12-31）。
步骤六：开始迁移
- 确认所有设置后，点击 开始迁移。
- 系统将开始处理迁移，您可在应用界面查看迁移进度。迁移时间取决于数据量大小，请耐心等待。
- 迁移完成后，可进入 Genstore 后台进一步完善店铺设置，推荐阅读 店铺快速上线 Checklist
查看迁移记录
完成店铺迁移后，您可在迁移助手应用内查看所有迁移历史记录，包括：
- 迁移时间
- 迁移平台（Shopify）
- 店铺域名
- 迁移模块
- 迁移数据结果
- 查看异常详情
常见问题解答
通用问题
- API 权限不足：需要重新检查 Shopify API 访问权限，确保已勾选所有 Read 权限。
- 数据格式不兼容：某些字段格式可能需要手动调整，请查看异常详情获取具体信息。
- 网络连接异常：建议检查您的网络连接是否正常，或尝试更换网络环境，也可以稍后重试。
- 迁移后数据不完整：请仔细检查迁移日志中的异常详情，确认是否有数据迁移失败。如有疑问，请联系 Genstore 客服支持。
- 迁移过程中是否可以操作 Shopify 店铺？ 为了保证数据一致性，建议在迁移过程中尽量避免对 Shopify 店铺进行大规模的数据修改。
- 迁移后需要做哪些检查？ 迁移完成后，请务必仔细检查 Genstore 后台的店铺、商品、客户和订单数据，确保数据完整性和准确性。
店铺模块
账单地址不兼容
- 如果 Shopify 中的账单地址不在 Genstore 支持的国家或地区范围内，该地址将无法迁移。
素材迁移失败
- 以下情况将导致素材无法迁移：
- 文件格式不符合要求（如不支持的图片或视频格式）
- 文件大小或时长超出限制
- 当前店铺套餐的素材存储容量已满
语言不受支持
- 不在 Genstore 支持范围内的语言将被跳过
- 语言对应的翻译内容不会被迁移
地点数量超限
- Genstore 店铺可设置的地点数量受套餐限制，超出上限的地点将无法迁移。
客户模块
客户重复校验
- 如果导入客户的邮箱或手机号与现有客户重复，该客户将不被导入，系统将在迁移日志中标记重复信息。后续版本将支持 邮箱或手机号一致时覆盖 选项。
手机号格式要求
- 客户手机号需符合国际标准 E.164 格式（如 +12025550123）。若缺少国家代码，系统默认添加 +1（美国/加拿大区号）。格式错误的手机号将导致该客户迁移失败。
客户免税设置
- 仅支持迁移
完全免税或不免税的客户。如果客户属于特殊税务场景，请在迁移完成后手动添加或调整设置。 - 迁移结束后，系统会在迁移日志中标记这些客户，您可根据提示信息手动添加或调整免税设置，确保客户数据完整。
客户账户密码
- 出于安全性考虑，客户密码不可迁移。迁移完成后，客户可通过邮箱验证码登录或重置密码。
TIP
推荐操作：您可以在迁移完成后向客户发送密码重置邮件，并结合营销活动发放优惠券，鼓励客户设置新密码。
产品模块
产品
产品字段映射与校验
- 在产品迁移过程中，系统会对以下内容进行字段映射与验证：
- 字段长度是否符合 Genstore 限制
- 字段类型与格式是否合规
- 非法字段内容将导致该字段或该产品迁移失败，异常信息将显示在迁移日志中
产品价格与货币
- 产品价格将按照 Shopify 店铺的主市场货币进行迁移，其他市场价格暂不支持迁移
- 多市场定价不包含在本次迁移中，迁移完成后，商户需前往 Genstore 后台的 市场设置 中手动为各市场配置价格
产品库存
- 实物产品：将迁移产品在各库存地点的库存数量，包括可售、现货与不可用库存
- 虚拟产品：仅迁移产品的可售库存数量，不包含库存地点信息
产品系列
Genstore 支持迁移 Shopify 中的产品系列（Collections），包括手动和自动两种分配方式。
手动分配系列迁移规则
- 将迁移产品系列的标题与描述
- 已手动分配的产品将尝试与 Genstore 中的产品进行关联
- 若某个系列下的产品未在 Genstore 成功匹配，该产品将被跳过，不进行系列绑定
自动分配系列迁移规则
- 将迁移自动系列的标题与描述
- 系列的筛选条件将同步迁移，Genstore 将尝试根据条件重新匹配产品
- 若条件无法匹配 Genstore 中的产品结构，系统将标记为迁移失败
订单模块
订单的操作限制
- 迁入的订单在 Genstore 中仅支持 查看，可在商家后台和客户端订单列表中展示，但不支持以下操作：支付、发货、取消、退货或换货。
订单货币与金额保持不变
- 订单将保留原始货币与金额信息，Genstore 不对币种进行转换或处理。
订单时间信息不做转换
- 系统不会对迁入订单的时间进行时区识别与转换，保留 Shopify 订单的原始创建时间和时区。
订单市场设置原样保留
- 订单将保留原始的销售市场信息，无论 Genstore 当前是否启用该市场，都不会影响订单迁入。
客户与商品数据的迁移顺序建议
订单迁移不强依赖客户和产品的迁移结果，建议优先迁移商品和客户信息。
- 若商品和客户已存在于 Genstore，订单中的相关字段将自动与现有数据建立关联；
- 若商品和客户尚未迁移，订单将以原始记录导入，不与 Genstore 数据关联。