WooCommerce Integration
Connect a WooCommerce store, sync products and stock, and mirror release orders into your e-commerce workflow.
WooCommerce is a popular fit for wineries that already have a WordPress e-commerce site. The integration keeps OnCloudWine and Woo in sync for products, stock, and orders.
What syncs
| Direction | What |
|---|---|
| Woo → OnCloudWine | Products and variants, stock levels, paid online orders. |
| OnCloudWine → Woo | Release orders (mirrored as Woo orders for fulfillment workflow). |
Prerequisites
- WooCommerce 6+
Older versions are missing API endpoints OnCloudWine relies on.
- HTTPS
Your WordPress site must be served over HTTPS. Woo's REST API rejects HTTP-only credentials.
- REST API key
Generated in WooCommerce → Settings → Advanced → REST API. Read/write scope.
- Permalinks
Set to "Post name" or any non-default option in WordPress Settings → Permalinks. Default permalinks break the REST API.
Connect
Generate a WooCommerce REST API key
In WordPress admin, go to WooCommerce → Settings → Advanced → REST API → Add Key. Permissions: Read/Write. Save the consumer key and secret — they only show once.
Open OnCloudWine integrations
Settings → Organization → Integrations → WooCommerce.
Click Connect WooCommerce
Enter your store URL, consumer key, and consumer secret.
Test the connection
OnCloudWine fetches your store info to confirm. If it succeeds, status moves to ACTIVE.
Sync products
Click Sync products
Triggers
SYNC_WOOCOMMERCE_PRODUCTS. Pulls every product and variation from your store.Match to OnCloudWine variants
Each Woo variation becomes an OnCloudWine variant. Variations are matched by SKU — if a SKU already exists locally, the variant is updated rather than duplicated.
Verify pricing and weight
Woo carries both — they sync straight through. Spot-check before using in a release.
Sync stock
Stock levels sync automatically every 5–15 minutes (configurable). Manual
trigger via Sync stock runs SYNC_WOOCOMMERCE_STOCK immediately.
WooCommerce is the source of truth for stock when this integration is active. OnCloudWine reservations are deducted from Woo's "available" so releases never oversell.
Order mirroring
When you process payments on a release, OnCloudWine optionally creates a mirror order in WooCommerce. This is useful if your fulfillment workflow runs in Woo (label printing, ShipStation, etc.).
To enable:
Go to integration settings
Settings → Organization → Integrations → WooCommerce.
Toggle Mirror release orders to Woo
Now every paid release order appears as a Woo order with status "processing".
Choose how to map customers
Either create matching Woo customers (recommended) or attach all orders to a single "OnCloudWine" Woo user.
Sync statuses
| Status | Meaning |
|---|---|
| PENDING | Queued for sync. |
| SYNCED | Successfully synced. |
| FAILED | Sync failed. Hover for the WooCommerce error. |
Common issues
| Problem | Fix |
|---|---|
| 401 Unauthorized | API key revoked or wrong. Regenerate in Woo and reconnect. |
| Permalinks error | Default permalinks block the REST API. Change to "Post name" in WordPress settings. |
| Slow sync | Large catalogs (5000+ products) can take several minutes. Watch progress under Activity Logs. |
| Variations not syncing | Variations need to be Published, not Draft, in Woo. |
| Order not appearing in Woo | Confirm the mirror toggle is on and check the activity log for the failure reason. |