WooCommerce is a leading eCommerce platform that allows businesses to sell products online and manage their sales channels efficiently. Integrating WooCommerce into Flxpoint as a channel allows you to automate order processing, inventory syncing, and product publishing between Flxpoint and WooCommerce. It helps streamline operations, ensuring that your product data and inventory levels are always up-to-date across your sales platforms.
How to Connect
📋 Phase 1: Initial Channel Setup
Access Channels Section
Log into your Flxpoint account and navigate to the Channels section.
Create a New Channel
Click + Add Channel to start the integration process.
Tip: Have your Standard account credentials or API details ready to streamline setup.
Select WooCommerce and Name Channel
In the popup:
- Choose WooCommerce as the channel type.
- Enter a descriptive Channel Name (e.g., "Standard Store").
- Click Save to continue.
Start the Integration Process
After creating the channel, you’ll see "No integrations created yet." Click Get Started to launch the setup wizard.
🔐 Phase 2: Authentication & Connection
Important Note: The recommended method for connecting Standard to Flxpoint is via WooCommerce REST API key, which securely authorizes the connection without manual credential entry. Use API Key only if WooCommerce REST API key is unavailable (e.g., for custom integrations).
Select the Integration Type
In the Setup Integrations wizard, select WooCommerce REST API key for secure authorization, or choose API Key for manual credential entry.
Connect Your Account
For WooCommerce REST API key:
- Enter your Store URL (e.g., https://your-store.com). Find this in your WooCommerce Admin under Settings > Domains or in your browser’s address bar.
- Click Initiate WooCommerce REST API key Flow, select your store account, and Install the Flxpoint app in the WooCommerce dialog.
- Review and Approve the requested permissions.
- You’ll be redirected to Flxpoint upon completion.
- Send your vendor the Vendor’s Guide to the WooCommerce App.
- The vendor installs the Flxpoint App in their WooCommerce Admin and shares their Store URL and API Key with you.
- Paste the vendor’s API Key as the Token and their Store URL.
Important: Use the platform’s native URL (e.g., https://your-store.com) (the full HTTPS URL of your WordPress site).
Authorize Access
For WooCommerce REST API key, no further credentials are needed after authorization. For API Key:
- Enter a Connection Name (e.g., "Standard Connection #1").
- Paste the API Access Token and Store URL.
- Click Test Connection and then Continue if successful.
Troubleshooting: If the connection fails, verify credentials, permissions, and URL format. In WooCommerce Admin, go to Apps and Integrations, locate the Flxpoint app, and select Delete to reset, then restart from Phase 1.
Verify Connection
Review connection details in Flxpoint to ensure accuracy, then proceed.
Standard API Rate Limits: Standard enforces API rate limits to ensure platform stability. Details at Standard API Documentation:
- REST API: 2 requests/sec, 40 requests/sec for premium plans.
- REST API API: 50 points/sec.
- WooCommerce REST API key: Exempt from rate limits; optimize with Flxpoint sync schedules.
🔄 Phase 3: SKU Mapping & Configuration
Set Up SKU Mapping
Configure Import Listings to align with your inventory:
- Set new listings to Paused to review before publishing.
- Map your internal Master SKU to Standard’s listing SKU.
Pro Tip: Use consistent SKU naming (e.g., "PROD-123" internally and "STD-PROD-123" on Standard) for easier inventory management.
Configure Integration Settings
Enable automated features:
- Inventory & Pricing: Enable automatic synchronization of inventory levels and prices between Flxpoint and Standard.
- Publish Listings: Standard uses REST API; map categories to global IDs from Standard’s Taxonomy. Adjust settings like "Truncate Title to 255" or "Enable variant images."
- Order Sync: Select fulfillment and financial statuses (e.g., "Unfulfilled," "Authorized") for Get Orders.
- Shipment Tracking: Configure tracking updates to notify Standard and customers when orders ship.
- TikTok Shop (Optional): In WooCommerce Admin, install a TikTok Shop app, connect your store, and verify listings can be published via Flxpoint.
Note: TikTok Shop integration is optional and only needed if selling on that platform.
Complete Setup
Review settings and click Save. In Channels > Standard, run Import Listings, Get Orders, and manage syncs or schedules.
Next Steps: Run processes manually to verify sync accuracy before enabling automation.
×
![]()
Listing Operations
Import Listings
Sync & Link Listings
Publish Listings
Mapping Source Attributes to WooCommerce
Mapping Source Attributes to WooCommerce explains how product attributes pulled from any Flxpoint source — color, size, material, brand, and other variant-level fields — are published into your WooCommerce store, and which settings control whether each attribute becomes a global WooCommerce taxonomy attribute or a per-product custom attribute.
Order Operations
Get Orders
Introduction
This integration imports orders from WooCommerce into Flxpoint for centralized order management. It ensures you can track and process WooCommerce orders efficiently within Flxpoint, supporting filters for fulfillment and financial statuses.
Follow these steps:
- 1 Add the Integration: Go to Channels > WooCommerce > Integrations, select “Get Orders.”
- 2 Connect to WooCommerce: Use your WooCommerce Token and Store URL or set up a new connection via WooCommerce REST API credentials.
-
3 Configure Settings:
- Toggle on "Enable Get Orders."
- Select the Location ID and other filters (fulfillment status, financial status, etc.).
- Configure retention period for personal information.
- Add a tag to WooCommerce orders after import (optional).
- Set the time frame for updated orders (e.g., last 14 days).
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Configuration Options
Customize the integration with these settings:
- Enable Get Orders: Toggle this on to import WooCommerce orders.
- Location ID: Select the WooCommerce location to import orders from. Orders with a different location are skipped unless you enable “Import Orders with No Location ID.”
- Import Orders with No Location ID: Enable this to import orders lacking a location; disabled by default (skips such orders).
- Get Orders with Fulfillment Status: Choose statuses to import: Unfulfilled, Partially Fulfilled, Fulfilled. Note that “Scheduled” and “On Hold” are not supported.
- Get Orders with Financial Status: Choose statuses to import: Any, Authorized, Pending, Paid, Partially Paid, Partially Refunded, Voided, Unpaid.
- Personal Identifying Information Retention: Choose retention period: Indefinitely, or 30/60/90 days after shipment.
- Upload Tag to WooCommerce Order After Importing: Add a tag to WooCommerce orders after import (e.g., “Received by Flxpoint”).
- Get Orders Updated in the Last X Days: Set the time frame for importing updated orders (e.g., last 14 days).
Advanced Options
-
Import Order Risk Rating
When enabled, Flxpoint will import risk ratings from WooCommerce for each order, if risk assessment is enabled in WooCommerce or provided via a third-party app in WooCommerce.How it Works
When enabled, orders will import with a risk rating tag:
High, Medium, Low, Pending, or None
Order import can be delayed up to 30 minutes for an order if fraud risk evaluation has not yet completed
If a risk rating is not assigned after 30 minutes, the next Get Orders job will import the order with a risk rating of Pending or None.
PENDING → WooCommerce had not added a risk rating at the time Flxpoint imported the order.
NONE → WooCommerce did not run fraud analysis for this order.
In Order Automation settings, you can build rules using these tags to automatically hold orders.
Example Rule:When Order → Tag → Contains → High or MediumThis allows you to review potential high-risk orders before routing or fulfillment to your suppliers.
→ Place Order On Hold -
Read Location From Fulfillment Order (disabled by default). When enabled, Flxpoint will:
- Fetch each order’s Fulfillment Orders via a separate API call.
- If exactly one Fulfillment Order exists, use its assigned_location_id as the order’s location.
- If zero or more than one Fulfillment Orders exist, the order is skipped and a warning is logged.
- Compare that location ID with your configured Location filter before import.
Setting Spotlight — Why some orders don’t import:
If Read Location From Fulfillment Order is enabled and WooCommerce returns multiple Fulfillment Orders for a single order, Flxpoint will skip importing that order.
Fix: Go to Channels → WooCommerce → Integrations → Get Orders → Advanced Options and disable “Read Location From Fulfillment Order”, then re-run the sync.
If Read Location From Fulfillment Order is enabled and WooCommerce returns multiple Fulfillment Orders for a single order, Flxpoint will skip importing that order.
Fix: Go to Channels → WooCommerce → Integrations → Get Orders → Advanced Options and disable “Read Location From Fulfillment Order”, then re-run the sync.
Example: Orders
2209 and 2202 were skipped because multiple Fulfillment Orders were returned for each. Disabling the setting allowed these orders to import.
Note: Ensure your fulfillment and financial status filters match your order management needs to avoid missing orders.
Mapping templates control which WooCommerce order data is imported into Flxpoint.
Interface Overview
- Screen labeled “Get Orders” at the top; name your template (e.g., “WooCommerce Get Orders 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: WooCommerce fields (left), Flxpoint fields (right).
Mapping Options
- Enable: Import the field (e.g., Order ID).
- Disable: Ignore the field (e.g., Custom Attributes).
- Required Fields: Order ID and Line Items are required for proper order import.
Order ID and Line Items Mapping Requirement
The Order ID and Line Items fields must be enabled to ensure proper order importing.
- Required Fields: Order ID and Line Items uniquely identify the order and its products.
-
Error Scenario: Missing Order ID or Line Items may cause:
Invalid request: Missing required fields 'Order ID' or 'Line Items' for order import
- Fix: Go to Channels > WooCommerce > Templates > Get Orders > Field Mapping, enable Order ID and Line Items, save, and re-run sync.
Recommendation: Always enable Order ID, Line Items, and billing/shipping addresses for accurate order importing.
Complete Field Mappings
Order Fields
| WooCommerce Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| WooCommerce Order - ID | Flxpoint Order ID | Number | 123456789 | Identifies the order | Required |
| WooCommerce Order - Financial Status | Flxpoint Financial Status | Text | Paid | Sets payment status | Supported |
| WooCommerce Order - Fulfillment Status | Flxpoint Fulfillment Status | Text | Unfulfilled | Sets fulfillment status | Supported |
| WooCommerce Order - Tags | Flxpoint Order Tags | Text | Received by Flxpoint | Sets order tags | Supported |
Line Item Fields
| WooCommerce Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| WooCommerce Line Item - SKU | Flxpoint Line Item SKU | Text | item-sku-001 | Identifies the product | Required |
| WooCommerce Line Item - Fulfillable Quantity | Flxpoint Line Item Quantity | Number | 2 | Sets quantity to fulfill | Supported |
| WooCommerce Line Item - Price | Flxpoint Line Item Price | Number | $30 | Sets item price | Supported |
Address Fields
| WooCommerce Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| WooCommerce Billing Address - Address 1 | Flxpoint Billing Address - Address 1 | Text | 123 Main St | Sets billing address | Supported |
| WooCommerce Shipping Address - Address 1 | Flxpoint Shipping Address - Address 1 | Text | 456 Oak St | Sets shipping address | Supported |
Limitations
Be aware of these limitations:
- Fulfillment Status Support: “Scheduled” and “On Hold” statuses are not supported; only Unfulfilled, Partially Fulfilled, and Fulfilled are importable.
- Location ID Filtering: Orders with a different Location ID are skipped unless “Import Orders with No Location ID” is enabled.
- Fulfillable Quantity Requirement: Orders must have a fulfillable quantity greater than 0 to be linked to Flxpoint listings.
- Setting Interaction: If Read Location From Fulfillment Order is enabled and WooCommerce returns multiple Fulfillment Orders for a single order, that order will be skipped by design.
- API Rate Limits: WooCommerce API rate limits may affect large import jobs; monitor usage to avoid interruptions.
Troubleshooting
Troubleshoot issues with these steps:
- Orders Not Importing: Verify fulfillment/financial status filters and Location ID filter.
- Location ID Issues: Ensure the Location ID matches or enable “Import Orders with No Location ID.”
- Missing Data: Confirm required fields (Order ID, Line Items) are enabled in the mapping template.
- Sync Not Running: Check your sync schedule or run it manually with "Run Sync" and view logs for details.
Orders show in WooCommerce/Postman but not in Flxpoint?
If you see multiple Fulfillment Orders in WooCommerce for a single order (common with split fulfillment) and Read Location From Fulfillment Order is enabled, Flxpoint will skip that order.
Resolution: Disable Read Location From Fulfillment Order and re-run the sync.
Path: Channels → WooCommerce → Integrations → Get Orders → Advanced Options.
If you see multiple Fulfillment Orders in WooCommerce for a single order (common with split fulfillment) and Read Location From Fulfillment Order is enabled, Flxpoint will skip that order.
Resolution: Disable Read Location From Fulfillment Order and re-run the sync.
Path: Channels → WooCommerce → Integrations → Get Orders → Advanced Options.
Diagnostic Tip: Missing orders often result from mismatched Location IDs, restrictive status filters, or the Fulfillment Order setting described above.
Sync Orders