From WooCommerce

Overview

The WooCommerce importer pulls products, customers, orders, and inventory from a WooCommerce store via the REST API.

Prerequisites

1. WooCommerce 3.0+ with REST API enabled
2. Consumer key and consumer secret (generate in WooCommerce → Settings → Advanced → REST API)
3. API access with read permissions for products, customers, orders

Import command

rcommerce import platform woocommerce \
  --api-url https://your-store.com \
  --api-key ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  --api-secret cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  --entities products,customers,orders \
  --overwrite

What gets imported

Products

• Title, description, SKU, price, weight, dimensions
• Product images (downloaded to local storage)
• Categories and category relationships
• Variants and option values
• Bundle components (for WooCommerce bundled/party-pack products)

Customers

• Name, email, phone
• Billing and shipping addresses
• Metadata

Orders

• Line items with product references
• Order status (mapped to rCommerce status)
• Shipping and billing addresses
• Payment status

Inventory

• Stock quantities per product
• Managed stock flag

Bundle handling

WooCommerce “party packs” / bundles are expanded:

• Parent line carries the bundle price (no inventory reservation)
• Component lines at $0 reserve underlying product stock

After import, re-sync party pack inventory:

UPDATE products pp
SET inventory_quantity = GREATEST(0, FLOOR(bp.inventory_quantity / 5.0)::integer)
FROM products bp
WHERE pp.slug LIKE '%-party-pack'
  AND bp.sku = REPLACE(pp.sku, '-PP', '')
  AND bp.is_active = true;

Status mapping

WooCommerce	rCommerce
pending	pending
processing	confirmed
on-hold	on_hold
completed	completed
cancelled	cancelled
refunded	refunded

Dry run

Preview what would be imported:

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

Re-importing

Use --overwrite to update existing records (matched by SKU for products, email for customers). This is useful after fixing weight data or updating inventory.