跳转到内容

从 WooCommerce 迁移

WooCommerce 导入器通过 REST API 从 WooCommerce 店铺拉取商品、 客户、订单和库存。

  1. WooCommerce 3.0+ 且启用 REST API
  2. Consumer key 和 consumer secret(在 WooCommerce → Settings → Advanced → REST API 中生成)
  3. 对 products、customers、orders 的读权限
Terminal window
rcommerce import platform woocommerce \
--api-url https://your-store.com \
--api-key ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--api-secret cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
--entities products,customers,orders \
--overwrite
  • 标题、描述、SKU、价格、重量、尺寸
  • 商品图片(下载到本地存储)
  • 分类及商品-分类关联
  • 变体和选项值
  • 捆绑商品组件(WooCommerce bundled 商品)
  • 姓名、邮箱、电话
  • 账单和收货地址
  • 元数据
  • 含商品引用的行项目
  • 订单状态(映射到 rCommerce 状态)
  • 收货和账单地址
  • 支付状态
  • 每个商品的库存数量
  • 是否管理库存的标记

WooCommerce 捆绑商品会被展开:

  • 父行承载捆绑价格(不预留库存)
  • 组件行价格为 $0,为底层商品预留库存

导入后重新同步捆绑商品库存:

UPDATE products pp
SET inventory_quantity = GREATEST(0, FLOOR(bp.inventory_quantity / 5.0)::integer)
FROM products bp
-- 请根据你的捆绑商品命名习惯调整以下 slug/SKU 规则
WHERE pp.slug LIKE '%-bundle'
AND bp.sku = REPLACE(pp.sku, '-BUNDLE', '')
AND bp.is_active = true;
WooCommercerCommerce
pendingpending
processingconfirmed
on-holdon_hold
completedcompleted
cancelledcancelled
refundedrefunded

预览将要导入的内容:

Terminal window
rcommerce import platform woocommerce \
--api-url https://your-store.com \
--api-key ck_xxx \
--api-secret cs_xxx \
--entities products \
--dry-run

使用 --overwrite 更新已有记录(商品按 SKU 匹配,客户按邮箱匹配)。 修正重量数据或更新库存后重导时很有用。

导入器把商品图片下载到本地存储时,写入 product_images.src 的 URL 基于 IMAGE_BASE_URL 环境变量构建:

Terminal window
IMAGE_BASE_URL=https://images.shop.example.com rcommerce import platform woocommerce ...

导入前每个店铺都必须显式设置它(通常是 R2/CDN 的 URL)——没有可靠的 默认值,否则所有图片记录都会指向错误的主机。见 R2 图片托管。

  • 只有 customer 角色的用户会被导入。 WooCommerce 的 /customers 端点只返回客户角色的用户——店长和管理员不会被导入。 如果需要在 rCommerce 中存在管理员账户,请手动注册并提升角色:

    UPDATE customers SET role = 'admin' WHERE email = '[email protected]';
  • WPML 翻译重复。 多语言 WooCommerce 店铺会把每种语言变体导入 为独立商品。导入后请停用(或删除)非规范的翻译,保证目录中每个 slug 只有一个商品——否则 sitemap 和分类页会列出重复项。

  • 评论会挂到翻译商品上。 导入的评论可能关联到翻译商品而非规范 商品,在去重之前评论数和评分会分散在多个副本上。翻译去重后请 合并。

  • 导入的客户没有密码。 迁移客户的 is_imported = true 且没有 password_hash;首次登录时 API 返回 403 account_requires_password_reset,客户必须走重置密码流程。 设置密码后该标记自动清除。