WooCommerce Integration
Overview
Section titled “Overview”The WooCommerce integration connects MicroPIM to a WooCommerce store using the WooCommerce REST API. Products, stock, prices, and categories flow from MicroPIM to WooCommerce.
Prerequisites
Section titled “Prerequisites”- A WordPress site with WooCommerce 5.0+ installed and activated
- Admin access to WordPress
- Permalinks set to anything other than “Plain” (required for the REST API to work)
- HTTPS enabled on the store (required for the REST API in production)
- An active MicroPIM account
What you’ll need
Section titled “What you’ll need”| Field | Where to find it |
|---|---|
| API URL | Your WooCommerce store URL, e.g. https://store.example.com |
| API User | The Consumer Key generated in WooCommerce |
| API Secret | The Consumer Secret generated in WooCommerce |
To generate the keys:
- In WordPress admin, go to WooCommerce → Settings → Advanced → REST API
- Click Add key
- Set Description to
MicroPIM, User to an admin account, and Permissions to Read/Write - Click Generate API key
- Copy the Consumer key and Consumer secret (shown only once)
Caution: Keys are shown only once. If you lose them, revoke and regenerate.
Connect MicroPIM to WooCommerce
Section titled “Connect MicroPIM to WooCommerce”- In MicroPIM, go to Integrations → Add Integration
- Select WooCommerce from the platform list
- Paste your store URL into API URL (no trailing slash)
- Paste the Consumer Key into API User
- Paste the Consumer Secret into API Secret
- Click Test Connection to verify
- Click Save to create the integration
What syncs
Section titled “What syncs”| Data | Direction | Notes |
|---|---|---|
| Products | MicroPIM → WooCommerce | Simple, variable, and grouped types |
| Stock | MicroPIM → WooCommerce | Per-product and per-variation |
| Pricing | MicroPIM → WooCommerce | Regular price and sale price |
| Categories | MicroPIM → WooCommerce | Mapped by category slug |
| Images | MicroPIM → WooCommerce | Featured image and gallery |
Field mapping
Section titled “Field mapping”Default mapping covers WooCommerce core fields. Map custom fields, attributes, and metadata from Integrations → Edit → Field Mapping.
Troubleshooting
Section titled “Troubleshooting”401 Unauthorized — Consumer Key or Secret is wrong, or the user the key belongs to was deactivated. Regenerate and reconnect.
404 Not Found on test connection — permalinks are set to “Plain”. Change to “Post name” or another setting in Settings → Permalinks and save.
SSL certificate problem — the store’s HTTPS certificate is invalid or self-signed. Use a valid certificate (Let’s Encrypt is fine).
Variable products not syncing variations — confirm each variation has a unique SKU and is enabled in WooCommerce.
Does this work with WooCommerce Bookings, Subscriptions, or other extensions? Core product and stock sync works. Extension-specific fields can be added via custom field mapping.
Can I connect multiple WooCommerce stores? Yes — one integration per store.
Does it work with WordPress multisite? Yes — connect each subsite as a separate integration.
Can I roll back a sync? Syncs are not reversible, but every change is recorded in the Audit Log.