Flxpoint allows you to connect directly to your WooCommerce as a sales channel. This article will walk you through how to connect and what to expect from your WooCommerce integration.
Add Channel and Establish Connection
Phase 1: Initial Channel Setup
Access the Channels Section
Log into your Flxpoint account and navigate to the Channels section to begin setting up your integration.
Create a New Channel
Click on + Add Channel or select "Channel Setup" to initiate the process of connecting your WooCommerce account to Flxpoint.
Tip: Having your WooCommerce store URL and API credentials ready will make this process smoother.
Select Channel Type
In the channel selection screen:
- Search for and select WooCommerce as your channel type
- Proceed to the next step
Phase 2: Authentication & Connection
Generate API Credentials in WooCommerce
Before connecting in Flxpoint, generate the required API keys in your WooCommerce admin panel:
- Log in to your WordPress admin panel.
- If not already installed, click on Plugins > Add New, search for WooCommerce, install and activate it.
- Go to WooCommerce > Settings > Advanced > REST API.
- Click "Add Key".
- Enter a description (e.g., "Flxpoint Integration").
- You must select a Store Manager or Administrator user
- Click "Generate API Key".
- Copy the Consumer Key and Consumer Secret immediately (the secret won't be shown again).
Important: Ensure WordPress permalinks are set to a readable format (Settings > Permalinks) for the REST API to work.
Enter Credentials in Flxpoint
In the WooCommerce channel setup form in Flxpoint, provide the following:
- Connection Name - A descriptive name (e.g., "My WooCommerce Store").
- Domain - Your WooCommerce store URL (e.g., https://yourstore.com).
- Consumer Key - Paste the generated key from WooCommerce.
- Consumer Secret - Paste the generated secret from WooCommerce.
Important: Use the correct credentials for your store. Flxpoint needs Read/Write access to manage listings and orders.
Verify Connection
Click Test Connection & Continue to verify the details. If successful, proceed to configuration.
Phase 3: Configuration & Mapping
Set Up Listing Management
Configure how listings are handled:
- Choose Create Only to import and link listings based on SKU, creating new ones if no match.
- Choose Create & Overwrite Existing to import, link, and overwrite existing Flxpoint listings with WooCommerce data.
- Enable Set New Listings to Paused to pause new imports for review before going live.
Pro Tip: Pausing new listings prevents orders until you've connected them to inventory sources.
Configure Order Import
Set the Get Orders Created within the last X Days to define the date range for importing orders.
Set Up Shipping Mappings
This is a required step to ensure orders are imported from WooCommerce and mapped to a central shipping policy in Flxpoint. You will need to provide the shipping text associated with the Shipping Methods "Title" currently offered on your WooCommerce account. To determine what to populate in your Flxpoint Channel Shipping Text:
- In WooCommerce, go to WooCommerce > Settings > Shipping > Shipping Zones.
- Either add a new shipping zone with "Add shipping zone" or select an existing one to view your Shipping Methods.
- Once selected, view or add your Shipping Methods.
Important: Accurate shipping mappings are essential for correct order processing.
Complete Setup
Review settings and save the integration.
Next Steps: Run manual syncs to test listings and orders before enabling automation.
Phase 4: Pricing, Rules & Automation (Optional)
Configure Pricing Strategy
Under Pricing & Quantity Rules, set up how you want to price your products:
- Add markups (e.g., 20% over cost) or set specific pricing rules
- Set minimum prices to protect your margins
- Limit quantities shown (helps prevent overselling)
Strategy Tip: Some sellers limit the quantity shown to reduce the risk of overselling, even if they have more inventory available.
Schedule Your Integration Processes
In Automate Integrations, decide how often each process should run:
- Import Listings - Manually import existing WooCommerce listings (cannot be scheduled).
- Sync Listings - Update changes to listings (e.g., every hour).
- Publish Listings - Publish new or updated listings to WooCommerce (supports overwriting details like title, description, images).
- Get Orders - Pull new orders (every 15-30 minutes recommended).
- Sync Orders - Update tracking info back to WooCommerce (every few hours).
Ready for Launch: After setup is complete, we recommend:
- Run each process manually first to test
- Verify that a few products sync correctly
- Check that test orders process properly
- Then enable automation when everything looks good!
×
![]()
Listing Operations
Import Listings
Sync & Link Listings
Publish Listings
Order Operations
Get Orders
Introduction
The Get Orders feature automates the process of retrieving order data from WooCommerce to your platform. This integration pulls details such as billing and shipping addresses, order totals, payment methods, and item information, mapping them to your platform's fields for processing.
The sections below walk through each step of the setup and configuration process.
Purpose
- Retrieve order data, including billing and shipping addresses, from WooCommerce.
- Map fields such as street addresses, postal codes, and payment methods to your platform's fields for order processing.
- Automate the retrieval process, ensuring real-time order updates in your system.
- Filter which WooCommerce orders are imported by selecting one or more order statuses or by using a custom order status value.
How It Works
- Data Extraction: Pulls order data including billing and shipping addresses, and item details from WooCommerce.
- Field Mapping: Maps the extracted data to your platform's fields using a customizable mapping template.
- Data Import: Imports the mapped data into your platform for processing or fulfillment.
Sample Data:
{
"Order": {
"BillingAddress": {
"StreetAddress1": "123 Main St",
"StreetAddress2": "Apt 4",
"City": "Boston",
"StateCode": "MA",
"PostCode": "02108",
"Country": "US"
},
"ShippingAddress": {
"StreetAddress1": "456 Oak St",
"PostCode": "02109",
"StateCode": "MA"
},
"Total": 99.99,
"Status": "processing",
"PaymentMethod": "Credit Card",
"ShippingTotal": 5.99
},
"Items": [
{
"Name": "Sample Product",
"SKU": "PROD123",
"Quantity": 2,
"Price": 49.99
}
]
}
Understanding: "BillingAddress" (123 Main St) and "ShippingAddress" (456 Oak St) provide customer details, while "PaymentMethod" (Credit Card) tracks the transaction type.
Setup Instructions
- 1 Create a Mapping Template: Go to the Mapping Dashboard, name your template (e.g., "WooGetOrders"), and define the initial field mappings.
- 2 Map Fields: Use the interface to map fields like "Street Address 1" and "Post Code" from WooCommerce to your platform's fields.
- 3 Save the Template: Click the "Save" button to store your mappings for future use or updates.
- 4 Get Orders: Manually trigger a retrieval or set up a schedule to automatically fetch new or updated orders from WooCommerce.
Configure Order Status Filters
When you configure WooCommerce Get Orders, you can control which orders are imported by selecting one or more WooCommerce order statuses.
In the Get Orders integration settings:
- Locate the Order Status configuration.
- Use the multi-select options to choose which WooCommerce statuses should be imported.
- Optionally, enter a Custom Order Status value if you use a non-standard order status in WooCommerce.
The following standard WooCommerce statuses are available to select:
ProcessingOn HoldPending PaymentRefundedCancelledCompleted
Default behavior for new setups: For any new WooCommerce Get Orders setup, the
processing status is selected by default so that paid orders begin importing immediately.
Validation and job behavior: At least one status must be selected, or a custom order status must be configured, for jobs to run successfully. If no order status is selected and the Custom Order Status is left blank, the Get Orders job will fail and a notification will prompt you to select at least one status filter.
Interface Overview
- Header Section: Includes a back button, template name input, and action buttons (Delete, Duplicate, Save).
- Mapping Section: Displays a group for "Billing Address Fields" with dropdowns for field selection.
- Action Buttons: Provides options to delete, duplicate, or save the template.
Mapping Fields
| Field | Maps To | Example | Purpose | Status |
|---|---|---|---|---|
| Street Address 1 (T) | Billing Address: Street Address 1 | 123 Main St | Provides the primary billing street address | Required |
| Street Address 2 (T) | Billing Address: Street Address 2 | Apt 4 | Provides additional billing address details | Optional |
| Post Code (T) | Shipping Address: Post Code | 02109 | Specifies the shipping postal code | Required |
| State Code (T) | Shipping Address: State Code | MA | Indicates the shipping state | Required |
| City (T) | Billing Address: City | Boston | Specifies the billing city | Required |
| Country (T) | Billing Address: Country | US | Indicates the billing country | Required |
| First Name (T) | Billing Address: First Name | John | Provides the customer's first name | Required |
| Last Name (T) | Billing Address: Last Name | Doe | Provides the customer's last name | Required |
| Phone (T) | Billing Address: Phone | 555-1234 | Provides the customer's phone number | Optional |
| Total (N) | Order: Total | 99.99 | Indicates the order total amount | Required |
| Shipping Total (N) | Order: Shipping Total | 5.99 | Specifies the shipping cost | Optional |
| Payment Method (T) | Order: Payment Method | Credit Card | Indicates the payment method used | Optional |
| Status (T) | Order: Status | processing | Tracks the order status | Required |
| SKU (T) | Order Item: SKU | PROD123 | Identifies the product SKU | Required |
| Quantity (N) | Order Item: Quantity | 2 | Specifies the item quantity | Required |
Available Source Fields
- WooCommerce Billing Address: City (T), Company (T), Country (T), Email (T), First Name (T), Last Name (T), Phone (T), Post Code (T), State Code (T), Street Address 1 (T), Street Address 2 (T).
- WooCommerce Shipping Address: City (T), Company (T), Country (T), First Name (T), Last Name (T), Phone (T), Post Code (T), State Code (T), Street Address 1 (T), Street Address 2 (T).
- WooCommerce Order: Customer Note (T), Date Created (D), Date Modified (D), Payment Method (T), Reference Number (T), Shipping Line Method (T), Shipping Line Title (T), Shipping Total (N), Status (T), Total (N), Total Tax (N).
- WooCommerce Order Item: Id (N), Name (T), Price (N), Quantity (N), SKU (T).
"Street Address 1" (123 Main St) maps to the billing address, while "Total" (99.99) tracks the order value.
Mapping Options
- Field: Links a WooCommerce field (e.g., Street Address 1) to your platform's field.
- Value: Sets a fixed value (e.g., always set State Code to "CA").
- Mapping Set: Uses tools to combine or manipulate data (e.g., concatenate address fields).
- Don't Map: Skips the field in your platform.
- Set to Empty: Clears the field in your platform.
Use "Value" to set a default Company name if missing.
Summary: Map key fields like Street Address 1, Post Code, and Total to your platform, enabling comprehensive order retrieval from WooCommerce. You can also control which orders are imported by configuring WooCommerce order status filters, including support for a default
processing status and custom order statuses.
Quick Checks
- Connection shows Connected and passes Test Connection.
- Mapping template is selected and saved.
- Order status filter is configured correctly.
- Get Orders Created within the last X Days is set appropriately.
Troubleshooting
- No orders importing? Verify the order status filter includes the statuses you expect (e.g., "processing").
- Missing address fields? Ensure billing and shipping fields are mapped in the template.
- Duplicate orders? Check the lookback period — overlapping windows can re-import orders.
Operation Details
| Feature | Availability | What to Expect |
|---|---|---|
| Get Orders | Supported | Retrieves orders from WooCommerce based on status and date filters. |
| Order Status Filtering | Supported | Select one or more statuses, or use a custom status value. |
| Billing & Shipping Address | Supported | Full address fields available for mapping. |
| Order Items | Supported | SKU, quantity, and price per line item. |
| Scheduling | Supported | Can be scheduled (every 15-30 minutes recommended) or run manually. |
| Custom Order Status | Supported | Enter a custom status value if using non-standard statuses. |
Final Tip: Test your mappings to ensure all address and order fields are correctly imported.
Sync Orders