WooCommerce
WooCommerce Integration
Quick Summary: Connect your WooCommerce store using API credentials to import orders and push fulfillment updates.
Overview
The WooCommerce integration connects your WooCommerce store to Floship using API credentials. Once connected, orders are automatically imported and fulfillment updates with tracking numbers are pushed back to your store when orders ship.
Quick Start
- In WooCommerce admin, go to WooCommerce → Settings → Advanced → REST API
- Create a new key with Read/Write permissions
- In your portal, navigate to Integrations and click Add New Integration
- Select WooCommerce
- Enter your Shop URL, Consumer Key, and Consumer Secret
- Click Save
Connecting Your WooCommerce Store
Step 1: Generate API Credentials in WooCommerce
Before connecting, you need to create REST API credentials in your WooCommerce admin:
- Log into your WooCommerce/WordPress dashboard
- Go to WooCommerce → Settings → Advanced → REST API
- Click Add Key
- Set Description to something like "Floship Integration"
- Set Permissions to Read/Write
- Click Generate API Key
- Copy the Consumer Key and Consumer Secret — you will need these in the next step
Important: The Consumer Secret is shown only once. Copy it immediately and store it securely.
Step 2: Add the Integration
- Navigate to Integrations in your Floship portal
- Click Add New Integration
- Select WooCommerce from the platform list
Step 3: Enter Credentials
| Field | What to Enter |
|---|---|
| Shop URL | Your WooCommerce store URL (e.g., https://yourstore.com) |
| Consumer Key | The Consumer Key from Step 1 |
| Consumer Secret | The Consumer Secret from Step 1 |
Step 4: Configure and Save
Review the settings below, then click Save. The system will validate your credentials and start importing orders.
Integration Settings
Status
Toggle between Active and Inactive. When inactive, no orders are imported and no sync occurs.
Sync & Fulfillment Settings
| Setting | Description |
|---|---|
| Mark Fulfillments | Push tracking numbers and fulfillment status back to WooCommerce when orders ship |
| Send customer shipment notice | Have WooCommerce send a shipping notification email to your customer when fulfillment is pushed |
| Enable Webhook | Allow WooCommerce to send real-time order notifications for faster import |
| Sync Shipping Cost | Import the shipping cost from WooCommerce into the order |
| Pull Customs Value From | Choose the source for customs values on international shipments |
| Use Checkout Currency | Use the currency from WooCommerce checkout for the order |
Last Orders Sync
Shows the timestamp of the most recent order sync. If this is blank or very old, there may be a connection issue.
Filters
Use filters to control which orders are imported from your WooCommerce store. Set rules based on order attributes to import only the orders you want Floship to process.
Actions
| Button | Description |
|---|---|
| Save | Save your current settings |
| Close | Return to the integrations list without saving |
How Order Sync Works
- Webhooks (if enabled): WooCommerce sends a notification when orders are created or updated
- Scheduled sync: The system checks your store regularly (approximately every 15–30 minutes depending on the platform)
- Orders matching your filter rules are imported into Floship
Both mechanisms work together — webhooks provide near-real-time import, and scheduled sync catches anything that webhooks may have missed.
How Fulfillment Sync Works
When an order is shipped from Floship:
- The tracking number and carrier information are pushed to WooCommerce
- The WooCommerce order status is updated
- If Send customer shipment notice is enabled, WooCommerce emails the customer
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| "Unable to setup webhook" error | Invalid credentials or insufficient permissions | Verify your Shop URL, Consumer Key, and Consumer Secret are correct. Ensure the API key has Read/Write permissions |
| Orders not importing | Integration inactive or sync stalled | Check that the integration is Active. Verify the Last Orders Sync timestamp is recent |
| Credentials rejected | API key expired or regenerated | Generate new API credentials in WooCommerce and update them in the integration settings |
| Fulfillments not appearing in WooCommerce | Fulfillment sync disabled | Ensure Mark Fulfillments is enabled |
| Slow order import | Using scheduled sync instead of webhook | Enable Webhook for near-real-time import instead of waiting for scheduled sync |
For more troubleshooting help, see Integration Troubleshooting.