WooCommerce as a Channel

FLX 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.

 

📋 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 WooCommerce integration.
Create a New Channel
Click on + Add Channel to initiate the process of connecting your WooCommerce account to Flxpoint.
Tip: Have your WooCommerce store URL and API credentials ready to streamline the setup process.
Select Channel Type & Name
In the popup that appears:
  • Choose WooCommerce as your channel type
  • Enter a descriptive channel name (e.g., "WooCommerce Main Store")
  • Click Save to continue to the next step
A good channel name helps you identify this integration if you have multiple sales channels.
Start the Integration Process
After creating your channel, you'll see a message that says "No integrations created yet." Click the Get Started button to launch the setup wizard and begin configuring your connection.
🔐 Phase 2: Authentication & Connection +
Select the Integration Type
In the Setup Integrations wizard, select WooCommerce REST API to proceed with connecting your account.
Connect Your Account
To connect your WooCommerce account, provide the following credentials:
  • Domain - Your WooCommerce store URL (e.g., https://yourstore.com)
  • Consumer Key - Generated in WooCommerce under Settings > Advanced > REST API
  • Consumer Secret - Generated alongside the Consumer Key, shown only once
Important: Generate API keys in WooCommerce: Go to WooCommerce > Settings > Advanced > REST API, click "Add Key," set Read/Write permissions, and copy the keys.
Authorize Access
Enter your credentials in Flxpoint, then click Test Connection and Continue to proceed.
Important: Ensure you're using the correct credentials for the WooCommerce store you want to integrate. Flxpoint will only manage listings and orders for the connected account.
Verify Connection
After successful authentication, review your connection details in Flxpoint to ensure everything is correct, then proceed with the integration setup.
🔄 Phase 3: SKU Mapping & Configuration +
Set Up SKU Mapping
Map your internal Inventory SKU to your WooCommerce Listing SKU to ensure proper inventory synchronization.
  • Ensure your SKU mapping matches your listings to avoid inventory errors
  • You can optionally set an SKU prefix for better organization
Pro Tip: Use a consistent naming convention across all your sales channels. For example, if your internal SKU is "WIDGET-123", your WooCommerce SKU might be "WC-WIDGET-123".
Configure Integration Settings
To enable automated features, configure your connection with these key components:
  • Inventory & Pricing: Enable automatic synchronization of inventory levels and price updates between Flxpoint and WooCommerce
  • Order Sync: Set up automatic order processing by linking your WooCommerce account to pull in new orders
  • Shipment Tracking: Configure shipment tracking updates to automatically notify WooCommerce and your customers when orders ship
These settings allow Flxpoint to communicate with WooCommerce in real-time, keeping your inventory, prices, and order statuses in sync.
Complete Setup
Review all your settings and click Save to finalize your integration.
Next Steps: After completing the setup, your integration will begin syncing with Flxpoint. You can now manage your listings, inventory, and orders directly from your Flxpoint dashboard.

 

Listing Operations

Import Listings

Supported | Import Listings

Introduction to Import Listings
Welcome to the WooCommerce (WC) Import Listings integration guide! This integration imports product listings from WooCommerce into your system. It ensures seamless data transfer for new or updated products without requiring a detailed mapping template. Let’s get started!

The WooCommerce Import Listings integration enables you to:
  • Import product listings, including titles and prices, from WooCommerce.
  • Prepare imported data for use in your system using a pre-defined format.
  • Automate the import process, reducing manual data entry.
This ensures efficient product setup and synchronization.

The integration follows these steps:
  • 1 Connecting to WC: Establish a connection using API credentials to access your WooCommerce system.
  • 2 Fetching Product Data: A GET call to the WC /products endpoint retrieves product details.
  • 3 Extracting Product Details: Extract titles, descriptions, and prices from the API response.
  • 4 Importing Data: Import the data into your system using a pre-defined format.
  • 5 Validation: Validate and activate the imported listings in your system.
  • 6 Execution: Run manually with Run Import (cannot be scheduled).
Pro Tip: Validate your data source (e.g., CSV) before importing.
Note: API failures pause the integration and trigger notifications.

Customize the integration with these settings:
  • Import Mode: Select "Create Only" or "Create & Overwrite Existing" for listing imports.
  • Data Source: Specify the source (e.g., CSV file) and format.
  • Execution: Run manually (cannot be scheduled).
Note: Ensure your data source includes standard fields like title and price.

Follow these steps:
  • 1 Add the Integration: Go to Channels > WooCommerce > Integrations, select “Import Listings.”
  • 2 Connect to WC: Use your WC API credentials or set up a new connection via OAuth2 authentication.
  • 3 Configure Settings:
    • Select import mode (Create Only or Create & Overwrite).
    • Specify data source and format.
  • 4 Run the Integration: Start with Run Import.

Be aware of these limitations:
  • API Rate Limits: Exceeding WC API limits pauses the integration.
  • Data Scope: Only imports data available via the WC /products endpoint.
  • Manual Execution: Cannot be scheduled; requires manual triggers.

Troubleshoot issues with these steps:
  • Connection Issues: Verify API credentials and connectivity to WC.
  • API Errors: Ensure the WC /products endpoint is accessible.
  • Data Format Errors: Check your data source (e.g., CSV) for correct headers.
  • Rate Limits: Confirm you haven’t hit WC API limits.
  • Contact Support: Reach out to WC support with error details.
Diagnostic Tip: Missing product data often results from incorrect data formats.

Key information:
  • Date: As of 04:55 PM -04, July 12, 2025, this integration is operational.
  • Execution: Manual only; no scheduling available.
  • API Limits: Monitor to avoid import interruptions.
Pro Tip: Validate your data source before each import.

Conclusion
The WooCommerce Import Listings integration automates product imports, ensuring your system reflects accurate product details without a mapping template. Run imports manually to fit your workflow, streamlining product management. Happy importing!
 
 

Sync & Link Listings

Supported | Sync and Link Listings

Introduction to Sync and Link Listings
Welcome to the WooCommerce (WC) Sync and Link Listings integration guide! This integration synchronizes and links product listings from your system to WooCommerce. It ensures real-time updates and accurate product associations. Let’s get started!

The WooCommerce Sync and Link Listings integration enables you to:
  • Sync product data, including prices and variants, to WooCommerce.
  • Link Flxpoint listings with WooCommerce products using SKU or UPC.
  • Automate updates, reducing manual effort.
This ensures consistent product management across platforms.

The integration follows these steps:
  • 1 Connecting to WC: Establish a connection using API credentials to access your WooCommerce system.
  • 2 Fetching Product Data: A GET call to the WC /products endpoint retrieves product details.
  • 3 Extracting Product Details: Extract titles, prices, and variants from the API response.
  • 4 Mapping Data: Map WC fields (e.g., SKU, price) to your system’s fields using a mapping template.
  • 5 Syncing Data: Update WooCommerce with the mapped data, linking records.
  • 6 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to maintain data consistency.
Note: API failures pause the integration and trigger notifications.

Customize the integration with these settings:
  • Sync Frequency: Choose to sync product data for items updated within a specific time frame (e.g., last 24 hours).
  • Linking Mode: Select SKU or UPC for linking Flxpoint listings to WC products.
  • Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
  • Mapping Template: Define how WC fields sync to your system (e.g., SKU to product ID).
Note: Enable the mapping template to customize field syncing.

Follow these steps:
  • 1 Add the Integration: Go to Channels > WooCommerce > Integrations, select “Sync and Link Listings.”
  • 2 Connect to WC: Use your WC API credentials or set up a new connection via OAuth2 authentication.
  • 3 Configure Settings:
    • Set sync frequency (e.g., last 24 hours).
    • Select linking mode (SKU or UPC).
    • Configure scheduling.
  • 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
  • 5 Run the Integration: Start with Run Sync or schedule.

Mapping templates control which WC product data is synced and linked into your system.
Interface Overview
  • Screen labeled “Sync and Link Listings” at the top; name your template (e.g., “WC Sync Listings 1”).
  • Buttons: Delete, Duplicate, Save Mapping.
  • Columns: WC fields (left), your system fields (right).
Mapping Options
  • Enable: Send the field (e.g., SKU).
  • Disable: Ignore the field (e.g., UPC).
  • Required Fields: SKU.
SKU Mapping Requirement
The SKU field must be enabled to ensure proper product linking.
  • Required Field: SKU uniquely identifies the product for linking.
  • Error Scenario: Unenabled SKU may cause:
    Invalid request: Missing required field 'SKU' for product link
  • Fix: Go to Channels > WooCommerce > Templates > Sync and Link Listings > Field Mapping, enable SKU, save, and re-run sync.
Recommendation: Always enable SKU for reliable linking and syncing.
Complete Field Mappings
Below are the fields you can enable for syncing:
Product Fields
WC Field Maps To Example Purpose Status
SKU Product SKU PROD123 Identifies the product for linking Required
Regular Price Product Price 29.99 Sets the product price Optional
Variant Fields
WC Field Maps To Example Purpose Status
UPC Variant UPC 012345678905 Alternative linking identifier Optional
Stock Quantity Variant Quantity 50 Tracks available stock Optional
Practice Mapping
Try enabling/disabling WC - SKU:

Be aware of these limitations:
  • API Rate Limits: Exceeding WC API limits pauses the integration.
  • Data Scope: Only syncs data available via the WC /products endpoint.
  • Required Fields: SKU must be enabled.

Troubleshoot issues with these steps:
  • Connection Issues: Verify API credentials and connectivity to WC.
  • API Errors: Ensure the WC /products endpoint is accessible.
  • Missing Data: Check mapping template for enabled fields (e.g., SKU).
  • Rate Limits: Confirm you haven’t hit WC API limits.
  • Contact Support: Reach out to WC support with error details.
Diagnostic Tip: Missing product data often results from disabled required fields.

Key information:
  • Date: As of 04:48 PM -04, July 12, 2025, this integration is operational.
  • Required Fields: SKU must be enabled.
  • API Limits: Monitor to avoid sync interruptions.
Pro Tip: Enable all required fields to ensure accurate syncing and linking.

Conclusion
The WooCommerce Sync and Link Listings integration automates product synchronization and linking, ensuring your system reflects accurate product details. Customize mappings and schedules to fit your workflow, streamlining product management. Happy syncing!
 
 

Publish Listings

Supported | Publish Listings

Q3 2025 – New Option: Use Variant SKU for Regular Products (default: Off). Turn this on if you want WooCommerce simple products to use the Variant SKU as the product SKU (instead of the Parent SKU). Helpful for stores that search, report, or pick by Variant SKU—especially after moving from Inventory Source.
Introduction to Publish Listings
This guide explains how the WooCommerce Publish Listings integration sends your products to WooCommerce and how to control which SKU is used for simple products. You’ll find setup steps, mapping details, the new Variant SKU option, and easy ways to verify it’s working as expected.

The WooCommerce Publish Listings integration lets you:
  • Publish product listings (titles, images, etc.) to WooCommerce.
  • Control field mapping so Woo receives the right data.
  • Automate publishes on a schedule.
It now also includes a setting to choose which SKU is used for simple products: Parent SKU (default) or Variant SKU.

The integration follows these steps:
  • 1 Connect to WooCommerce: Authenticate so we can create/update products.
  • 2 Prepare Product Data: Choose which fields to send with a mapping template.
  • 3 Decide Which SKU is Sent (Simple Products): By default we send the Parent SKU. If you enable Use Variant SKU for Regular Products, we send the Variant SKU instead.
  • 4 Publish: Run manually or on a schedule. Use Create & Overwrite if you want to update existing products.
Tip: If your storefront search, barcodes, or ERP picking rely on Variant SKUs, enable the new option so Woo shows and returns the Variant SKU for simple products.

Configure the integration:
  • Publish Frequency: Publish items changed within a time window (e.g., last 24 hours).
  • Publish Mode: Create Only or Create & Overwrite.
  • Scheduling: Manual or scheduled (e.g., daily).
  • Mapping Template: Choose which fields (Title, SKU, Images…) are sent.
Note: SKU and Title are usually required in your Woo theme/workflows—keep them enabled.

Friendly explanation: Some stores need the Variant SKU (not the Parent SKU) to appear on their WooCommerce product page and in API search—especially if you scan barcodes or migrated from Inventory Source where simple products used Variant SKUs. This option lets you pick that behavior with a simple toggle.

What it does
  • Applies to simple products only (no Woo variations).
  • When Off (default): Woo product _sku is the Parent SKU.
  • When On: Woo product _sku is the Variant SKU.
When to enable
  • Your storefront search, warehouse barcodes, or reports use Variant SKUs.
  • You migrated from Inventory Source and expect simple products to show Variant SKUs.
  • Parent and Variant SKUs differ and you want the Variant SKU visible/searchable in Woo.
How to enable
  1. 1 Go to Channel > WooCommerce > Integrations > Publish Listings.
  2. 2 In Advanced Configuration, toggle Use Variant SKU for Regular Products On.
  3. 3 Save and run a publish (preferably Create & Overwrite) on an affected listing to update SKU in Woo.
  4. 4 If the SKU doesn’t update due to a Woo plugin/theme lock, Delist and then Publish again.
Before vs After
State Woo _sku value (Simple product) Storefront/API search behavior
Default (Off) Parent SKU Searching by Variant SKU returns no result.
Enabled (On) Variant SKU Searching by Variant SKU returns the product as expected.
Verify it worked
  1. Run Publish on a test listing (use Create & Overwrite).
  2. Query Woo by Variant SKU (admin search or API):
GET /wp-json/wc/v3/products?sku=YOUR_VARIANT_SKU
You should see: The product returned with _sku equal to your Variant SKU, and the storefront displays the Variant SKU where your theme shows SKU.
Troubleshooting
  • No change in Woo: Ensure the toggle is On and you used Create & Overwrite. Some plugins lock _sku; if so, Delist → Publish.
  • Duplicate SKU alert: Another product may already use that Variant SKU. Resolve duplicates first.
  • Still seeing Parent SKU on product page: Clear caches and confirm your theme displays Woo’s _sku field (not a custom meta).
FAQ:
Does this affect variable products? No. Variable products still use their variation SKUs for the child variants, and a distinct parent SKU if you map one.
Will existing Woo products update automatically? Use Create & Overwrite or Delist → Publish to update the SKU on existing products.

Follow these steps:
  • 1 Add the Integration: Channels > WooCommerce > Integrations > “Publish Listings.”
  • 2 Connect: Use API credentials or OAuth2.
  • 3 Configure Basics: Frequency, Mode (Create Only or Create & Overwrite), and Scheduling.
  • 4 Advanced (Optional): Enable Use Variant SKU for Regular Products if you need Variant SKUs on simple products.
  • 5 Create Mapping Template: Enable key fields (SKU, Title, Images, etc.).
  • 6 Run: Publish now or let the schedule handle it.

Mapping templates control which product data is published to WooCommerce.
Interface Overview
  • Screen title “Publish Listings”; name your template (e.g., “WC Publish – Default”).
  • Actions: Delete, Duplicate, Save Mapping.
  • Columns: Your fields (left) → Woo fields (right).
Mapping Options
  • Enable: Send the field (e.g., Title).
  • Disable: Do not send the field.
  • Required: SKU and Title should be enabled.
SKU Mapping Requirement
The SKU field must be enabled for reliable identification.
  • Why: Woo uses _sku for unique product lookups and many themes display it.
  • If disabled: You may see publish errors or unexpected storefront behavior.
Heads up: If you enable Use Variant SKU for Regular Products, we still use the same mapping—only the value changes (Variant vs Parent) for simple products.
Example Field Mappings
Product Fields
Your Field Maps To Example Purpose Status
SKU Product SKU PROD123 Unique identifier for the product Required
Title Product Name Sample Product Title shown in Woo Required
Images Product Images image1.jpg Gallery/featured images Optional
Variant Fields
Your Field Maps To Example Purpose Status
Stock Quantity Variant Quantity 50 Available stock Optional
Price Variant Price 29.99 Variant price Optional
Practice Mapping
Try enabling/disabling SKU:

Be aware of:
  • API Rate Limits: Exceeding Woo API limits pauses or slows publishes.
  • Existing Products: Use Create & Overwrite (or Delist → Publish) to update SKU on items already in Woo.
  • Theme/Plugin Overrides: Some themes/plugins override _sku; adjust or temporarily disable if needed.

Quick checks:
  • Credentials: Verify Woo API/OAuth.
  • Mapping: Ensure SKU & Title enabled.
  • Variant SKU toggle: Confirm it’s On (if you expect Variant SKUs on simple products).
  • Publish Mode: Use Create & Overwrite to update existing products.
  • Duplicates: Search Woo for SKU duplicates and resolve.
  • Caching: Clear caches/indexers if storefront still shows old values.
Diagnostic Tip: Use the Woo API to confirm the product’s current _sku:
GET /wp-json/wc/v3/products?sku=YOUR_SKU

  • As of Sept 3, 2025: The Variant SKU option for simple products is available (default Off).
  • Applies to Simple Products: Variable products are unaffected.
  • Update Path: Use Create & Overwrite or Delist → Publish to push SKU changes to existing Woo products.
Tip: Keep a short checklist: (1) toggle On, (2) save, (3) publish override, (4) verify via Woo API.

Conclusion
You’re in control of which SKU WooCommerce shows and searches for simple products. If Variant SKUs matter to your operations, enable the new option, republish, and verify—done.
 
 

 
 

Order Operations

Get Orders

Supported | Get Orders

Introduction to Get Orders
Welcome to the WooCommerce (WC) Get Orders integration guide! This integration retrieves order data from WooCommerce into your system. It ensures real-time order updates for processing. Let’s get started!

The WooCommerce Get Orders integration enables you to:
  • Retrieve order data, including billing and shipping addresses, from WooCommerce.
  • Map fields to your system for order processing.
  • Automate the retrieval process, ensuring timely updates.
This ensures efficient order management.

The integration follows these steps:
  • 1 Connecting to WC: Establish a connection using API credentials to access your WooCommerce system.
  • 2 Fetching Order Data: A GET call to the WC /orders endpoint retrieves order details.
  • 3 Extracting Order Details: Extract billing addresses, totals, and items from the API response.
  • 4 Mapping Data: Map WC fields (e.g., billing address, total) to your system’s fields using a mapping template.
  • 5 Syncing Data: Import the mapped data into your system, updating order records.
  • 6 Execution: Run manually with Run Sync or schedule (e.g., every 30 minutes).
Pro Tip: Schedule frequent syncs to capture new orders quickly.
Note: API failures pause the integration and trigger notifications.

Customize the integration with these settings:
  • Sync Frequency: Choose to sync order data for items created within a specific time frame (e.g., last 7 days).
  • Order Range: Set the date range for order retrieval (e.g., last 30 days).
  • Scheduling: Run manually or schedule (e.g., every 30 minutes).
  • Mapping Template: Define how WC fields sync to your system (e.g., billing address to customer address).
Note: Enable the mapping template to customize field syncing.

Follow these steps:
  • 1 Add the Integration: Go to Channels > WooCommerce > Integrations, select “Get Orders.”
  • 2 Connect to WC: Use your WC API credentials or set up a new connection via OAuth2 authentication.
  • 3 Configure Settings:
    • Set sync frequency (e.g., last 7 days).
    • Define order range (e.g., last 30 days).
    • Configure scheduling.
  • 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
  • 5 Run the Integration: Start with Run Sync or schedule.

Mapping templates control which WC order data is imported into your system.
Interface Overview
  • Screen labeled “Get Orders” at the top; name your template (e.g., “WC Get Orders 1”).
  • Buttons: Delete, Duplicate, Save Mapping.
  • Columns: WC fields (left), your system fields (right).
Mapping Options
  • Enable: Send the field (e.g., billing address).
  • Disable: Ignore the field (e.g., shipping total).
  • Required Fields: Order ID.
Order ID Mapping Requirement
The Order ID field must be enabled to ensure proper order identification.
  • Required Field: Order ID uniquely identifies the order.
  • Error Scenario: Unenabled Order ID may cause:
    Invalid request: Missing required field 'Order ID' for order sync
  • Fix: Go to Channels > WooCommerce > Templates > Get Orders > Field Mapping, enable Order ID, save, and re-run sync.
Recommendation: Always enable Order ID for reliable order syncing.
Complete Field Mappings
Below are the fields you can enable for syncing:
Order Fields
WC Field Maps To Example Purpose Status
Order ID Order ID 1001 Identifies the order uniquely Required
Total Order Total 99.99 Shows the order amount Optional
Billing Address Fields
WC Field Maps To Example Purpose Status
Street Address 1 Billing Street 1 123 Main St Provides the billing address Optional
Post Code Billing Zip 02108 Specifies the billing postal code Optional
Practice Mapping
Try enabling/disabling WC - Order ID:

Be aware of these limitations:
  • API Rate Limits: Exceeding WC API limits pauses the integration.
  • Data Scope: Only fetches data available via the WC /orders endpoint.
  • Required Fields: Order ID must be enabled.

Troubleshoot issues with these steps:
  • Connection Issues: Verify API credentials and connectivity to WC.
  • API Errors: Ensure the WC /orders endpoint is accessible.
  • Missing Data: Check mapping template for enabled fields (e.g., Order ID).
  • Rate Limits: Confirm you haven’t hit WC API limits.
  • Contact Support: Reach out to WC support with error details.
Diagnostic Tip: Missing order data often results from disabled required fields.

Key information:
  • Date: As of 04:55 PM -04, July 12, 2025, this integration is operational.
  • Required Fields: Order ID must be enabled.
  • API Limits: Monitor to avoid sync interruptions.
Pro Tip: Enable all required fields to ensure accurate order syncing.

Conclusion
The WooCommerce Get Orders integration automates order retrieval, ensuring your system reflects accurate order details. Customize mappings and schedules to fit your workflow, streamlining order management. Happy syncing!
 
 

Sync Orders

Supported | Sync Orders

Introduction to Sync Orders
Welcome to the WooCommerce (WC) Sync Orders integration guide! This integration updates order status and tracking information from your system back to WooCommerce. It ensures accurate order tracking for customers. Let’s get started!

The WooCommerce Sync Orders integration enables you to:
  • Update order status and tracking details in WooCommerce.
  • Map fields to reflect changes from your system.
  • Automate the sync process, ensuring timely updates.
This ensures seamless order tracking communication.

The integration follows these steps:
  • 1 Connecting to WC: Establish a connection using API credentials to access your WooCommerce system.
  • 2 Fetching Order Data: A GET call to the WC /orders endpoint retrieves order details.
  • 3 Extracting Order Updates: Extract status and tracking updates from your system.
  • 4 Mapping Data: Map your system fields (e.g., tracking number) to WC fields using a mapping template.
  • 5 Syncing Data: Update WC with the mapped data, reflecting changes.
  • 6 Execution: Run manually with Run Sync or schedule (e.g., every 2 hours).
Pro Tip: Schedule frequent syncs to keep tracking updates current.
Note: API failures pause the integration and trigger notifications.

Customize the integration with these settings:
  • Sync Frequency: Choose to sync order data for items updated within a specific time frame (e.g., last 7 days).
  • Update Mode: Select fields to update (e.g., status, tracking).
  • Scheduling: Run manually or schedule (e.g., every 2 hours).
  • Mapping Template: Define how your system fields sync to WC (e.g., tracking number to shipment tracking).
Note: Enable the mapping template to customize field syncing.

Follow these steps:
  • 1 Add the Integration: Go to Channels > WooCommerce > Integrations, select “Sync Orders.”
  • 2 Connect to WC: Use your WC API credentials or set up a new connection via OAuth2 authentication.
  • 3 Configure Settings:
    • Set sync frequency (e.g., last 7 days).
    • Select update mode (e.g., status, tracking).
    • Configure scheduling.
  • 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
  • 5 Run the Integration: Start with Run Sync or schedule.

Mapping templates control which order updates are synced from your system to WC.
Interface Overview
  • Screen labeled “Sync Orders” at the top; name your template (e.g., “WC Sync Orders 1”).
  • Buttons: Delete, Duplicate, Save Mapping.
  • Columns: Your system fields (left), WC fields (right).
Mapping Options
  • Enable: Send the field (e.g., tracking number).
  • Disable: Ignore the field (e.g., status).
  • Required Fields: Order ID.
Order ID Mapping Requirement
The Order ID field must be enabled to ensure proper order identification.
  • Required Field: Order ID uniquely identifies the order.
  • Error Scenario: Unenabled Order ID may cause:
    Invalid request: Missing required field 'Order ID' for order sync
  • Fix: Go to Channels > WooCommerce > Templates > Sync Orders > Field Mapping, enable Order ID, save, and re-run sync.
Recommendation: Always enable Order ID for reliable syncing.
Complete Field Mappings
Below are the fields you can enable for syncing:
Order Update Fields
Your Field Maps To Example Purpose Status
Order ID Order ID 1001 Identifies the order uniquely Required
Tracking Number Shipment Tracking 1Z9999W999999999 Provides tracking information Optional
Status Fields
Your Field Maps To Example Purpose Status
Status Order Status shipped Updates the order status Optional
Practice Mapping
Try enabling/disabling Order ID:

Be aware of these limitations:
  • API Rate Limits: Exceeding WC API limits pauses the integration.
  • Data Scope: Only syncs data available via the WC /orders endpoint.
  • Required Fields: Order ID must be enabled.

Troubleshoot issues with these steps:
  • Connection Issues: Verify API credentials and connectivity to WC.
  • API Errors: Ensure the WC /orders endpoint is accessible.
  • Missing Data: Check mapping template for enabled fields (e.g., Order ID).
  • Rate Limits: Confirm you haven’t hit WC API limits.
  • Contact Support: Reach out to WC support with error details.
Diagnostic Tip: Missing order updates often result from disabled required fields.

Key information:
  • Date: As of 04:53 PM -04, July 12, 2025, this integration is operational.
  • Required Fields: Order ID must be enabled.
  • API Limits: Monitor to avoid sync interruptions.
Pro Tip: Enable all required fields to ensure accurate order syncing.

Conclusion
The WooCommerce Sync Orders integration automates order updates, ensuring your WooCommerce store reflects accurate tracking details. Customize mappings and schedules to fit your workflow, streamlining order management. Happy syncing!