从 WooCommerce 迁移
WooCommerce 导入器通过 REST API 从 WooCommerce 店铺拉取商品、 客户、订单和库存。
- WooCommerce 3.0+ 且启用 REST API
- Consumer key 和 consumer secret(在 WooCommerce → Settings → Advanced → REST API 中生成)
- 对 products、customers、orders 的读权限
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 状态)
- 收货和账单地址
- 支付状态
- 每个商品的库存数量
- 是否管理库存的标记
捆绑商品处理
Section titled “捆绑商品处理”WooCommerce 捆绑商品会被展开:
- 父行承载捆绑价格(不预留库存)
- 组件行价格为 $0,为底层商品预留库存
导入后重新同步捆绑商品库存:
UPDATE products ppSET 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;| WooCommerce | rCommerce |
|---|---|
| pending | pending |
| processing | confirmed |
| on-hold | on_hold |
| completed | completed |
| cancelled | cancelled |
| refunded | refunded |
预览将要导入的内容:
rcommerce import platform woocommerce \ --api-url https://your-store.com \ --api-key ck_xxx \ --api-secret cs_xxx \ --entities products \ --dry-run使用 --overwrite 更新已有记录(商品按 SKU 匹配,客户按邮箱匹配)。
修正重量数据或更新库存后重导时很有用。
图片 URL 与 IMAGE_BASE_URL
Section titled “图片 URL 与 IMAGE_BASE_URL”导入器把商品图片下载到本地存储时,写入 product_images.src 的
URL 基于 IMAGE_BASE_URL 环境变量构建:
IMAGE_BASE_URL=https://images.shop.example.com rcommerce import platform woocommerce ...导入前每个店铺都必须显式设置它(通常是 R2/CDN 的 URL)——没有可靠的 默认值,否则所有图片记录都会指向错误的主机。见 R2 图片托管。
已知注意事项
Section titled “已知注意事项”-
只有
customer角色的用户会被导入。 WooCommerce 的/customers端点只返回客户角色的用户——店长和管理员不会被导入。 如果需要在 rCommerce 中存在管理员账户,请手动注册并提升角色: -
WPML 翻译重复。 多语言 WooCommerce 店铺会把每种语言变体导入 为独立商品。导入后请停用(或删除)非规范的翻译,保证目录中每个 slug 只有一个商品——否则 sitemap 和分类页会列出重复项。
-
评论会挂到翻译商品上。 导入的评论可能关联到翻译商品而非规范 商品,在去重之前评论数和评分会分散在多个副本上。翻译去重后请 合并。
-
导入的客户没有密码。 迁移客户的
is_imported = true且没有password_hash;首次登录时 API 返回403 account_requires_password_reset,客户必须走重置密码流程。 设置密码后该标记自动清除。