WooCommerce Integration - Setup and Activation

Updated 1 month ago by Dylan Mattos

Flourish Wholesale Portal

The information here focuses on the Flourish WooCommerce Integration Setup for Flourish Wholesale Portal.

Here are the steps to set up and activate your Flourish WooCommerce Integration, enabling direct order fulfillment from your website within Flourish.

  1. Initial WordPress and WooCommerce Setup
  2. Flourish WooCommerce Plugin Installation
  3. Flourish WooCommerce Plugin Setup
  4. Configure and Enable Webhooks for both WordPress and Flourish
  5. Sync Items/Products

Initial WordPress and WooCommerce Setup

The first step will be to set up your WordPress site and install the WooCommerce plugin. To learn more about setting up WordPress and WooCommerce, click here.

We recommend the following WooCommerce themes for an easy setup:

We also recommend putting an Age Gate, and Password Protecting on your website. Below are some plugins that are relatively cheap and have been tested.

Flourish is currently supporting WooCommerce hosting and setup internally. For Agencies and customers working with them, we'd love to support you, too. Please contact partners@flourishsoftware.com.

Flourish WooCommerce Plugin Installation

Now, you will install the Flourish WooCommerce plugin using the latest version.

  1. Navigate to the Release Page and download the .zip file.
    1. Select "Tags" to find the latest version.
  2. Go to: WordPress Admin > Plugins > Add New to upload.
  3. Click Upload Plugin at the top.
  4. Click Choose File and select the .zip file you downloaded in step 2.
  5. Select Choose.
  6. Click Install Now.
  7. Click Activate.

Once the Flourish plugin is installed and activated on your WordPress site, you can access it through the “Settings” tab in the left navigation bar.

WooCommerce
Updating the Plugin

When we release an update, you can download the latest .zip from the Release Page. Follow the same Procedure as above to upload the new .zip file. Instead of installing, WooCommerce will prompt you to upgrade.

Flourish WooCommerce Plugin Setup

Follow these steps to set up your Flourish WooCommerce Plugin: generate your Flourish Username and External API Key, apply them in the Plugin settings, and lastly enable Item Attributes.

Generate and Apply your Flourish Username and External API Key
  1. Generate your Username and External API Key from Flourish by following these instructions: Generate or Reset External API key.
WooCommerce
  • Username - API key username generated from Flourish
  • External API Key - Also found in Flourish when you generate your API key
  1. Go back to the Flourish Plugin settings and Copy and Paste the Username and External API Key you just generated.
WooCommerce
The API URL and Webhook Signing Key will be auto-generated after these two boxes are filled.
  1. Select the Facility you want all incoming orders populated into and by which Order Type
    • Select the Order Type “Outbound” for Flourish Wholesale Portal wholesale customers.
WooCommerce

DO NOT select “Retail”.  The information here focuses on the Flourish WooCommerce Integration Setup for the Flourish Wholesale Portal. “Retail” if for testing only.

Enable Item Attributes

The last step in the plugin setup is to choose the item attributes that will flow from Flourish to WooCommerce, and also filter the brands you want to sync between the two systems.

WooCommerce

Once you are done, make sure to click Save Changes

Configure and Enable Webhooks for both WordPress and Flourish

Webhooks are automated messages sent when an action/trigger happens. They have a message and are sent to a unique URL. Outlined below is how you will configure Webhooks in both WordPress and Flourish.

Configure the Webhooks in WordPress

Go into your WordPress ADMIN so that your Webhook endpoints are available by using "Post name" permalinks.

  1. Go to Settings
  2. Click Permalinks
  3. Select Post name
Signing Key: Make sure to Copy the signing key. This will be used when enabling your Flouish webhook.
  1. Click Save
Enable the Webhooks in Flourish
  1. Enable Webhooks from Flourish by following these instructions: How to enable Webhooks in Flourish.
    1. You need to create them for:
      1. Item
      2. Retail Order
      3. Outbound Order
      4. Inventory Summary
🔗 Endpoint URL example: https://demoshop.flourishsoftware.com/wp-json/flourish-woocommerce-plugin/v1/webhook
  1. Paste the key generated "Signing Key" that you save when configuring the Webhooks in WordPress
  2. Click Save
Security for Webhooks (click to expand)
More information about securing webhooks with a signing key in Flourish can be found here: Securing your webhooks.

Sync Items/Products

Now that all data and connections are established, now is the time to sync products between the two systems. Simply hit the “Import Products” button. Clicking this will match existing items/products based on SKU, and push all new E-commerce active items from Flourish to WooCommerce. 

WooCommerce
You will see a success validation message and also the number of items that have been updated.

To confirm if all items have been synced. Follow these steps:

  1. Go to Products
  2. Click All Products

You will also see the “In Stock” number against each item. This will always match the “Sellable” number in Flourish.

Add any additional attributes that you want for items like pictures, notes, etc., directly in WooCommerce.

Congratulations! The integration between Flourish and WooCommerce is active!

How did we do?