Overview WooCommerce connector

The WooCommerce connector is aimed at e-commerce vendors who want to synchronise data between WooCommerce and other connectors. The focus lies heavily on e-commerce data, but contact data is also collected when possible. 

On this page you have the following options:

Spotler Connect

Spotler Connect allows you to synchronise and transform data such as contacts, orders, or activities between external systems, even if no direct integration is available between them. Connect gathers your data, saves it in your account environment, and changes the format before exporting it to other systems if necessary. By doing this continuously for all connectors in your account, the software can maintain a complete overview of your data in different systems and keep it in sync.

In Connect, you can add account-wide or integration-specific rules to modify data based on conditions, block import or export, or add actions when a condition is met. These rules allow you to customise data being handled in a way that works for external systems—for example, when you want to synchronise mailing opt-ins, activities, or orders.

Available Data

Spotler Connect supports shops that run on WooCommerce version 3.5 or higher. The following data is available through the WooCommerce connector:

Data type Import to Connect Export to WooCommerce Timeframe
Orders Yes No Real-time
Products Yes No Every 5 min
Stocks No* Yes* Real-time
Checkouts Yes No Real-time
Shipments No Yes* Real-time
Contacts Yes Yes Real-time
Contact lists No No -
Organisations No No -
Activities No No -

* this depends on the selected preset during onboarding. For more information, see connector presets.

Orders

WooCommerce orders are imported to Connect in real-time by utilising WooCommerce’s inbuilt webhooks. Therefore, webhooks mustn’t be manually disabled in the WooCommerce admin interface. Default WooCommerce order statuses are mapped to default Spotler Connect order statuses.

Products

Products in WooCommerce will be imported and, if necessary, created as master products in Spotler Connect. When a product exists through another connector, the WooCommerce product will be linked to the Connect master product. When a product doesn’t exist, it will be created in Connect. A product is classified as new or existing based on a barcode or SKU.

Product creation only works in one direction: WooCommerce to Connect. Products created in other integrations are created or linked in Spotler Connect, but not propagated to WooCommerce. If that particular product is later manually created in WooCommerce, it will be linked to the existing central Connect master product based on SKU or barcode.

Stocks

Stock levels updated through other connectors (such as e-fulfillment) are exported to WooCommerce in real time. By default, stock levels adjusted in WooCommerce are not imported into Connect.

Please note

If you are using (custom) server-side caching, make sure that routes starting with /api are not cached. This can cause stock levels and shipment info to be outdated.

Checkouts

The Spotler Connect plugin for WooCommerce allows capturing checkouts from WooCommerce, even though WooCommerce doesn’t offer this feature in its own plugin. Details about this plugin are listed below.

Shipments

As soon as shipment information is gathered in Connect, it will be exported to WooCommerce for updating. This causes the order status to be set to Completed. If displaying and emailing tracking information through WooCommerce is needed, either the Spotler Connect plugin for WooCommerce plugin or the Shipment Tracking for WooCommerce plugin is required. The tracking code will then be placed in the customer-note field that is available with each order.

Please note

When a Tracking code is manually updated in WooCommerce, this information is not automatically propagated to Spotler Connect. Shipments are only propagated from Spotler Connect to WooCommerce, not vice versa.

Contacts

The WooCommerce integration allows importing contacts into Connect and updating WooCommerce customer profiles based on changes in other connectors. This information is imported to Connect and exported to WooCommerce in real time. When changes to a WooCommerce contact are made through another connector (for example, in a CRM), these changes are exported back from Connect into WooCommerce.

WooCommerce Connect Plugin

The Spotler Connect for WooCommerce plugin has been developed in order to facilitate the capture of checkouts, and the placement of tracking information in WooCommerce. Although this can be done through external plugins in WooCommerce, it's not feasible to support all external plugins. That's why this plugin has been developed.

 

Plugin installation

Download the plugin from the Downloads & Tools page in your Spotler Connect dashboard, install the plugin in the plugin overview in WooCommerce, and activate it.

Shipments

For shipments, the Spotler Connect plugin can be used in two ways:

  • To import Tracking information from Spotler Connect into WooCommerce
  • To create Tracking information in WooCommerce and propagate this to Spotler Connect. This is recommended if the shop is used as a fulfilment source for external platforms, such as Bol. Spotler Connect will automatically propagate the Tracking information to the order source platform.

When the plugin is activated, an extra column named Shipments is created on the order detail page in WooCommerce. This column allows filling out a shipment provider, a tracking link, and a tracking number for the shipment. As soon as the shipment is saved, it is created in both WooCommerce and Spotler Connect. Tracking information in WooCommerce is processed through the default settings in WooCommerce, meaning the information is collected in a table and sent to the customer along with the order completed notification. When the shipment is created in Spotler Connect, the Tracking information is automatically propagated to the order source if applicable.

Shipment3.jpg

Getting Started with Onboarding

Keep the following items ready when onboarding this connector:

  • API key
  • API secret
  • Shop URL

Follow the detailed WooCommerce onboarding guide for detailed instructions on onboarding.