Flxpoint Knowledge

Contact us

WooCommerce as Channel

Table of Contents

How to Connect Listing Operations Order Operations

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.

 

How to Connect

📋 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
This will open the WooCommerce channel setup form.
🔐 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").
  • Select a user (preferably an admin user).
  • Set permissions to Read/Write.
  • 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.
In Flxpoint, use the shipping method ID for orders, meaning the Title shown in WooCommerce must be added in all lowercase with underscores for spaces (e.g., "flat_rate").
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 (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.
⚙️ Phase 5: Automation & Scheduling (Optional) +
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!
📚 Additional Tips & Notes +

If a product is deleted in WooCommerce outside of Flxpoint, it will show as "Linked" until the next sync, then "Broken Link". Unlink and relink in Flxpoint to resolve.

For advanced shipment tracking, install the official WooCommerce Shipment Tracking plugin: WooCommerce Shipment Tracking.

  • Delisting removes the product from WooCommerce; relist via sync/publish.
  • Listing linking is based on SKU only.
  • Supported WooCommerce API versions: V2/V3.
  • Contact support@flxpoint.com for any issues.

 

 

 

Listing Operations

Import Listings

Supported | Import Listings

Introduction to Import Listings
The Import Listings feature automates the process of importing product listings from an external source (e.g., a CSV file or another platform) into WooCommerce. This integration pulls product details—such as titles, descriptions, prices, and stock quantities—and prepares them for use in WooCommerce. Since this feature lacks a detailed mapping template in the provided document, the setup focuses on configuration and execution. Let’s walk through each step!

The Import Listings integration connects an external data source to WooCommerce to:
  • Import product listings, including titles and prices, from an external source.
  • Prepare imported data for use in WooCommerce without requiring extensive field mapping.
  • Automate the import process, reducing manual data entry and ensuring efficient product setup.

This integration follows a clear process to import listings into WooCommerce:
  • Data Extraction: Pulls product data, such as titles, descriptions, and prices, from the external source.
  • Data Import: Transfers the extracted data into WooCommerce using a pre-defined import format.
  • Validation and Activation: Validates the imported data and makes the listings available in WooCommerce.
What Does the Product Data Look Like?
Here’s a sample product data structure from an external source, which the integration imports into WooCommerce:
{ "Products": [ { "Title": "Sample Product", "Description": "High-quality item", "Price": 29.99, "StockQuantity": 50, "SKU": "PROD456" }, { "Title": "Another Product", "Description": "Great value item", "Price": 19.99, "StockQuantity": 30, "SKU": "PROD789" } ] }
Understanding the Data: "Title" (Sample Product) and "Price" (29.99) are imported to create new WooCommerce listings.

Follow these steps to set up the Import Listings integration:
  • 1 Prepare Data Source: Ensure your external data (e.g., CSV file) is formatted with standard fields like Title, Description, Price, and SKU.
  • 2 Configure Import Settings: Go to the Import Dashboard, select the data source, and specify the import format (e.g., CSV structure).
  • 3 Run Import: Initiate the import process to transfer the data into WooCommerce.
  • 4 Verify Listings: Check the WooCommerce admin panel to confirm all listings are imported correctly and activate them as needed.

The Import Listings interface is where you configure the integration with WooCommerce. Here’s what you’ll see:
  • Header Section: Includes a back button, data source selection, and action buttons (Run Import, Cancel).
  • Import Settings: Allows selection of file type (e.g., CSV) and preview of data structure.
  • Action Buttons: Provides options to start or cancel the import process.
Next Steps
After importing, review your listings in WooCommerce to ensure accuracy and make any necessary adjustments.

Essential details for the Import Listings integration:
  • Current Date and Time: As of 04:24 PM -04 on Saturday, July 12, 2025, this integration is ready for use.
  • Supported Features: Imports product listings from external sources into WooCommerce without a detailed mapping template.
Pro Tip: Validate your CSV file for correct headers (e.g., Title, Price) before importing to avoid errors.
 
 

Sync & Link Listings

Supported | Sync & Link Listings

Introduction to Sync & Link Listings
The Sync & Link Listings feature automates the process of synchronizing and mapping product listings between your platform (e.g., Flxpoint) and WooCommerce. This integration pulls product data—such as titles, descriptions, prices, and variants—and maps them to WooCommerce fields, ensuring consistent and accurate listings. The Link Listings operation allows you to associate Flxpoint listings with WooCommerce products, enabling updates via Sync and Publish operations. WooCommerce supports linking via SKU or UPC, with the system checking the "UPC" attribute if selected. Let’s walk through each step to get started!

The Sync & Link Listings integration connects your platform to WooCommerce to:
  • Sync product listings by pulling data like titles, prices, and variants from your platform to WooCommerce.
  • Map fields such as custom fields and variant details to corresponding WooCommerce fields for accurate product representation.
  • Automate the update process, reducing manual effort and ensuring real-time listing consistency.
Why Accurate Linking Matters
Proper links between Flxpoint listings and WooCommerce products ensure that:
  • Inventory, price, and availability update the right SKU.
  • “Broken link – could not locate listing” errors disappear, so Sync Listings jobs finish quickly.
  • Manual edits drop to near-zero, freeing you for higher-value tasks.

This integration follows a clear process to sync and link listings from your platform to WooCommerce:
  • Data Extraction: Pulls product data including titles, descriptions, prices, and variants from your platform.
  • Field Mapping: Maps the extracted data to WooCommerce fields using a customizable mapping template.
  • Data Synchronization: Updates WooCommerce with the mapped data, reflecting changes in real-time or on demand. This includes syncing any changes made to listings since the last sync, as well as options to delist (permanently remove a product from WooCommerce, restorable only via Sync or Publish) or hide variants (temporarily set as Out of Stock to prevent unwanted orders), with unhiding available to restore hidden variants to live status.
What Does the Product Data Look Like?
Here’s a sample product data structure from your platform, which the integration maps to WooCommerce:
{ "Product": { "Title": "Example Product", "Description": "High-quality product description", "RegularPrice": 29.99, "SalePrice": 24.99, "StockQuantity": 50, "BackOrderEnabled": false }, "Variants": { "ListPrice": 29.99, "Quantity": 25, "CustomFields": { "Color": "Blue", "Size": "M" }, "UPC": "012345678905" } }
Understanding the Data: Fields like "RegularPrice" map to WooCommerce’s regular price, while "UPC" (012345678905) can be used for linking variants, ensuring all product details are accurately represented.
Exact Linking Workflow
Follow this workflow for accurate linking:
Pass Linking Identifier When to Use Benefit
1 Listing Variant SKU → WooCommerce Variant SKU Always first Captures every child “variation” record.
2 Listing Variant SKU → WooCommerce Product SKU Immediately after Pass 1 Captures parent “variable” or “simple” record so both levels stay in sync.
Tip: Run both passes back-to-back before you trigger Sync Listings.
Product-type Check
If a WooCommerce product is marked variable but has zero variations, switch it to simple. Result: Flxpoint can update price, stock, and visibility in a single API call—no 404 “use /variations/” errors.
API Access Check
Whitelist Flxpoint’s static IPs in Cloudflare or any firewall. If basic HTTP auth is enabled on the site’s public API, store the credentials in your WooCommerce channel settings. Result: Sync jobs run without 401/403 failures.

Follow these steps to set up the Sync & Link Listings integration:
  • 1 Create a Mapping Template: Go to the Mapping Dashboard, name your template (e.g., "WooSyncTemplate"), and define the initial field mappings.
  • 2 Map Fields: Use the interface to map fields like "Regular Price" and "Stock Quantity" from your platform to WooCommerce fields, selecting options like "Field" or "Value".
  • 3 Save the Template: Click the "Save" button to store your mappings for future use or updates.
  • 4 Sync Listings: Manually trigger a sync or set up a schedule to automatically update WooCommerce with the mapped data. Note: If you delete a product on your store without using Flxpoint, it will remain "Linked" in Flxpoint until the next sync, changing to "Broken Link" status, requiring you to un-link and re-link the item.

The Sync & Link Listings interface is where you configure the integration with WooCommerce. Here’s what you’ll see:
  • Header Section: Includes a back button, template name input, and action buttons (Delete, Duplicate, Save).
  • Mapping Sections: Displays groups for "Custom Fields" and "WooCommerce Variant Fields" with collapsible options and dropdowns for field selection.
  • Action Buttons: Provides options to delete, duplicate, or save the template.
Next Steps
After setting up, review and adjust your mappings in the "Mapping Template" section below, and proceed to link your listings.

The Mapping Template defines how your platform’s product data maps to WooCommerce fields. Let’s explore the key mappings!
Mapping Fields
Below is a table of key fields you can map, with examples and purposes:
Field Maps To Example Purpose Status
Regular Price (N) WooCommerce: Regular Price 29.99 Sets the standard price of the product Required
Sale Price (N) WooCommerce: Sale Price 24.99 Sets the discounted price of the product Optional
Stock Quantity (N) WooCommerce: Stock Quantity 50 Specifies the available stock quantity Required
Back Order Enabled (B) WooCommerce: Back Order Enabled false Indicates if back orders are allowed Optional
Custom Fields: Color (T) WooCommerce: Custom Field Blue Defines a custom attribute like product color Optional
UPC (T) WooCommerce: UPC 012345678905 Used as a linking identifier for variants Optional
Available Source Fields
Your platform provides these fields for mapping to WooCommerce:
  • Product: Title (T), Description (T), RegularPrice (N), SalePrice (N), StockQuantity (N), BackOrderEnabled (B).
  • Variants: ListPrice (N), Quantity (N), CustomFields (K/V), UPC (T).
Let’s Break It Down: "RegularPrice" (29.99) maps to WooCommerce’s regular price, while "UPC" (012345678905) can be used for linking variants to WooCommerce products.
Mapping Options
Customize how data is handled with these options:
  • Field: Link a platform field (e.g., RegularPrice) to a WooCommerce field.
  • Value: Set a fixed value (e.g., always set StockQuantity to 0).
  • Don’t Map: Skip the field in WooCommerce.
  • Set to Empty: Clear the WooCommerce field.
Try This: Use "Value" to set a default SalePrice of 0 if no sale is active.
Quick-fix Guide
Address common issues during Sync Listings with these solutions:
Error Seen in Sync Listings Root Cause Fast Solution
Product Sync Error – Broken Link Variant SKU not linked Re-run Pass 1 (Variant SKU → Variant SKU)
404 “use /products//variations/” Product saved as variation but Flx treats as simple Convert product to simple or add missing variations
401 / 403 IP or auth block Whitelist IPs and confirm API creds
Summary
You’ve mapped key fields like Regular Price, Stock Quantity, and UPC to WooCommerce, ensuring accurate product listings and linking. Adjust as needed in the interface.

Essential details for the Sync & Link Listings integration:
  • Current Date and Time: As of 04:31 PM -04 on Saturday, July 12, 2025, this integration is ready for use.
  • Supported Features: Syncs and maps product data to WooCommerce with customizable templates, including linking, delisting, hiding, and unhiding functionalities.
Pro Tip: Test your mappings and linking workflow in the dashboard to ensure all fields and variants sync correctly.
 
 

Publish Listings

Supported | Publish Listings

Introduction to Publish Listings
The Publish Listings feature automates the process of publishing product listings from your platform to WooCommerce. This integration pulls product details—such as descriptions, images, SKUs, and stock quantities—and maps them to WooCommerce product fields, making your products available for sale. The setup involves creating a mapping template, configuring field mappings, and saving the template for publishing. Let’s walk through each step!

The Publish Listings integration connects your platform to WooCommerce to:
  • Publish product listings by transferring data like descriptions and images from your platform to WooCommerce.
  • Map fields such as custom fields, SKUs, and stock quantities to WooCommerce product fields for accurate listings.
  • Automate the publishing process, ensuring products are readily available for sale with minimal manual effort.

This integration follows a clear process to publish listings from your platform to WooCommerce:
  • Data Extraction: Pulls product data including descriptions, images, SKUs, and stock quantities from your platform.
  • Field Mapping: Maps the extracted data to WooCommerce product fields using a customizable mapping template.
  • Data Publishing: Publishes the mapped data to WooCommerce, making products live for sale.
What Does the Product Data Look Like?
Here’s a sample product data structure from your platform, which the integration maps to WooCommerce:
{ "Product": { "Description": "High-quality product with great features", "Images": ["image1.jpg", "image2.jpg"], "SKU": "PROD123", "StockQuantity": 100, "Weight": 2.5, "Width": 10.0, "CustomFields": { "Color": "Red", "Size": "L" } }, "Variant": { "Quantity": 50 } }
Understanding the Data: "Description" provides the product details, "Images" populates the gallery, and "SKU" (PROD123) identifies the product in WooCommerce.

Follow these steps to set up the Publish Listings integration:
  • 1 Create a Mapping Template: Go to the Mapping Dashboard, name your template (e.g., "WooPublishTemplate"), and define the initial field mappings.
  • 2 Map Fields: Use the interface to map fields like "Description" and "SKU" from your platform to WooCommerce product fields.
  • 3 Save the Template: Click the "Save" button to store your mappings for publishing.
  • 4 Publish Listings: Manually trigger a publish or set up a schedule to automatically publish new or updated listings to WooCommerce.

The Publish Listings interface is where you configure the integration with WooCommerce. Here’s what you’ll see:
  • Header Section: Includes a back button, template name input, and action buttons (Delete, Duplicate, Save).
  • Mapping Sections: Displays groups for "Channel Custom Fields" and "WooCommerce Product Fields" with collapsible options and dropdowns for field selection.
  • Action Buttons: Provides options to delete, duplicate, or save the template.
Next Steps
After setting up, review and adjust your mappings in the "Mapping Template" section below.

The Mapping Template defines how your platform’s product data maps to WooCommerce product fields. Let’s explore the key mappings!
Mapping Fields
Below is a table of key fields you can map, with examples and purposes:
Field Maps To Example Purpose Status
Description (T) WooCommerce: Description High-quality product with great features Provides the product description Required
Images (L) WooCommerce: Images ["image1.jpg", "image2.jpg"] Populates the product image gallery Required
SKU (T) WooCommerce: SKU PROD123 Identifies the product uniquely Required
Stock Quantity (N) WooCommerce: Stock Quantity 100 Sets the available stock level Required
Weight (N) WooCommerce: Weight 2.5 Specifies the product weight Optional
Width (N) WooCommerce: Width 10.0 Defines the product width Optional
Custom Fields (K/V) WooCommerce: Custom Fields {"Color": "Red", "Size": "L"} Adds custom attributes like color or size Optional
Available Source Fields
Your platform provides these fields for mapping to WooCommerce:
  • Listing Parent: Attribute (K/V), Brand (T), Category 1 (T), Category 2 (T), Category 3 (T), Custom Field (K/V), Description (T), Image (L), Parent SKU (T), Title (T).
  • Listing Variant: ASIN (T), Custom Aggregate Field (K/V), Custom Field (K/V), Description (T), Dimensional Weight (N), Estimated Cost (N), Estimated Dropship Fee (N), Estimated Shipping Cost (N), GTIN (T), Height (N), Image (L), Length (N), List Price (N), MAP (N), MPN (T), MSRP (N), Master SKU (T), Option (K/V), Quantity (N), SKU (T), Title (T), UPC (T), Weight (N), Width (N).
Let’s Break It Down: "Description" provides the product narrative, while "Custom Fields" (e.g., {"Color": "Red"}) enhances variant options in WooCommerce.
Mapping Options
Customize how data is handled with these options:
  • Direct Copy: Copies data directly (e.g., Attributes, Images) without transformation.
  • Field: Links a platform field (e.g., SKU) to a WooCommerce field.
  • Value: Sets a fixed value (e.g., always set Weight to 1.0).
  • Mapping Set: Uses tools to combine or manipulate data.
  • Don’t Map: Skips the field in WooCommerce.
  • Set to Empty: Clears the WooCommerce field.
Try This: Use "Direct Copy" for Images to ensure all product visuals are published.
Summary
You’ve mapped key fields like Description and SKU to WooCommerce, preparing your products for publishing. Adjust as needed in the interface.

Essential details for the Publish Listings integration:
  • Current Date and Time: As of 04:11 PM -04 on Saturday, July 12, 2025, this integration is ready for use.
  • Supported Features: Publishes product data to WooCommerce with customizable templates.
Pro Tip: Verify your image URLs before publishing to ensure they load correctly in WooCommerce.
 
 


 

Order Operations

Get Orders

Supported | Get Orders

Introduction to Get Orders
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 setup involves creating a mapping template, configuring field mappings, and saving the template for use. Let’s walk through each step!

The Get Orders integration connects WooCommerce to your platform to:
  • 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.

This integration follows a clear process to get orders from WooCommerce to your platform:
  • 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.
What Does the Order Data Look Like?
Here’s a sample order data structure from WooCommerce, which the integration maps to your platform:
{ "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 the Data: "BillingAddress" (123 Main St) and "ShippingAddress" (456 Oak St) provide customer details, while "PaymentMethod" (Credit Card) tracks the transaction type.

Follow these steps to set up the Get Orders integration:
  • 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.

The Get Orders interface is where you configure the integration with WooCommerce. Here’s what you’ll see:
  • 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.
Next Steps
After setting up, review and adjust your mappings in the "Mapping Template" section below.

The Mapping Template defines how WooCommerce order data maps to your platform’s fields. Let’s explore the key mappings!
Mapping Fields
Below is a table of key fields you can map, with examples and purposes:
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 provides these fields for mapping to your platform:
  • 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).
Let’s Break It Down: "Street Address 1" (123 Main St) maps to the billing address, while "Total" (99.99) tracks the order value.
Mapping Options
Customize how data is handled with these 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.
Try This: Use "Value" to set a default Company name if missing.
Summary
You’ve mapped key fields like Street Address 1, Post Code, and Total to your platform, enabling comprehensive order retrieval from WooCommerce. Adjust as needed in the interface.

Essential details for the Get Orders integration:
  • Current Date and Time: As of 04:17 PM -04 on Saturday, July 12, 2025, this integration is ready for use.
  • Supported Features: Retrieves order data from WooCommerce with customizable templates.
Pro Tip: Test your mappings to ensure all address and order fields are correctly imported.
 
 

Sync Orders

eBay integration: Supported
eBay Legacy integration: Supported

Supported | Sync Orders

Introduction to Sync Orders
The Sync Orders feature automates the process of synchronizing order fulfillment data from your platform to WooCommerce. This integration pulls shipment details—such as carrier names, tracking numbers, and shipping methods—and maps them to WooCommerce fulfillment fields, ensuring accurate order updates. The setup involves creating a mapping template, configuring field mappings, and saving the template for use. Let’s walk through each step!

The Sync Orders integration connects your platform to WooCommerce to:
  • Sync order fulfillment data, including carrier details and tracking information, from your platform to WooCommerce.
  • Map shipment fields to WooCommerce fulfillment fields for accurate order status updates.
  • Automate the process, reducing manual updates and ensuring real-time order tracking.

This integration follows a clear process to sync orders from your platform to WooCommerce:
  • Data Extraction: Pulls shipment data like carrier names, tracking numbers, and shipping methods from your platform.
  • Field Mapping: Maps the extracted data to WooCommerce fulfillment fields using a customizable mapping template.
  • Data Synchronization: Updates WooCommerce with the mapped data, reflecting shipment status in real-time or on demand.
What Does the Shipment Data Look Like?
Here’s a sample shipment data structure from your platform, which the integration maps to WooCommerce:
{ "Shipment": { "Carrier": "UPS", "FulfillmentRequestNumber": "ORD12345", "Method": "Ground", "Note": "Handle with care", "ShippedAt": "2025-07-12T14:00:00Z", "ShippingCost": 5.99, "TrackingNumber": "1Z9999W999999999", "TrackingURL": "https://www.ups.com/track?num=1Z9999W999999999" } }
Understanding the Data: Fields like "Carrier" (UPS) map to WooCommerce’s carrier name, while "TrackingNumber" (1Z9999W999999999) ensures customers can track their orders.

Follow these steps to set up the Sync Orders integration:
  • 1 Create a Mapping Template: Go to the Mapping Dashboard, name your template (e.g., "WooOrderSync"), and define the initial field mappings.
  • 2 Map Fields: Use the interface to map fields like "Carrier Name" and "Tracking Number" from your platform to WooCommerce fulfillment fields.
  • 3 Save the Template: Click the "Save" button to store your mappings for future use or updates.
  • 4 Sync Orders: Manually trigger a sync or set up a schedule to automatically update WooCommerce with the mapped shipment data.

The Sync Orders interface is where you configure the integration with WooCommerce. Here’s what you’ll see:
  • Header Section: Includes a back button, template name input, and action buttons (Delete, Duplicate, Save).
  • Mapping Section: Displays a group for "WooCommerce Fulfillment Fields" with collapsible options and dropdowns for field selection.
  • Action Buttons: Provides options to delete, duplicate, or save the template.
Next Steps
After setting up, review and adjust your mappings in the "Mapping Template" section below.

The Mapping Template defines how your platform’s shipment data maps to WooCommerce fulfillment fields. Let’s explore the key mappings!
Mapping Fields
Below is a table of key fields you can map, with examples and purposes:
Field Maps To Example Purpose Status
Carrier Name (T) WooCommerce: Carrier Name UPS Identifies the shipping carrier Required
Note Header (T) WooCommerce: Note Header Shipping Update Customizes text before tracking info Optional
Note Footer (T) WooCommerce: Note Footer Thank you for your order Customizes text after tracking info Optional
Shipped At (D) WooCommerce: Shipped At 2025-07-12T14:00:00Z Records the shipment date Optional
Shipping Method (T) WooCommerce: Shipping Method Ground Specifies the shipping method Required
Tracking Number (T) WooCommerce: Tracking Number 1Z9999W999999999 Provides the tracking identifier Required
Tracking URL (T) WooCommerce: Tracking URL https://www.ups.com/track?num=1Z9999W999999999 Links to the tracking page Optional
Available Source Fields
Your platform provides these shipment fields for mapping to WooCommerce:
  • Shipment: Carrier (T), FulfillmentRequestNumber (T), Method (T), Note (T), ShippedAt (D), ShippingCost (N), TrackingNumber (T), TrackingURL (T).
Let’s Break It Down: "Carrier" (UPS) maps to the carrier name, while "TrackingNumber" (1Z9999W999999999) allows customers to track their orders in WooCommerce.
Mapping Options
Customize how data is handled with these options:
  • Field: Link a platform field (e.g., TrackingNumber) to a WooCommerce field.
  • Value: Set a fixed value (e.g., always set NoteHeader to "Shipping Update").
  • Mapping Set: Use tools to combine or manipulate data (e.g., concatenate fields).
  • Don’t Map: Skip the field in WooCommerce.
  • Set to Empty: Clear the WooCommerce field.
Try This: Use "Value" to set a default NoteFooter like "Contact support for issues."
Summary
You’ve mapped key fields like Carrier Name and Tracking Number to WooCommerce, ensuring accurate order fulfillment updates. Adjust as needed in the interface.

Essential details for the Sync Orders integration:
  • Current Date and Time: As of 04:06 PM -04 on Saturday, July 12, 2025, this integration is ready for use.
  • Supported Features: Syncs shipment data to WooCommerce with customizable templates.
Pro Tip: Test your mappings to ensure tracking details sync correctly with WooCommerce.
 
 

 

Related Articles

WooCommerce as a Source

WooCommerce comes in as an open source plugin for your ecommerce or dropshipping ...