WooCommerce

WooCommerce Stores

Integrating your WooCommerce store with the Insight shipping app allows for seamless order processing and fulfillment. This guide will walk you through the steps to generate the necessary API keys in WooCommerce and configure your store within the Insight app.

Prerequisites

• WooCommerce Administrator Access: Ensure you have admin privileges to your WooCommerce store.

• Insight Shipping App Account: Access to your Insight account to configure the store integration.

Generate API Keys in WooCommerce

To allow the Insight app to communicate with your WooCommerce store, you'll need to generate API keys with the appropriate permissions.

1. Navigate to REST API Settings

• Log in to your WordPress admin dashboard.

• Go to WooCommerce > Settings > Advanced > REST API.

Note: In WooCommerce versions prior to 3.4, API keys were located under WooCommerce > Settings > API > Key/Apps.

2. Add a New API Key

• Click on Add Key to open the key creation page.

3. Configure API Key Details

• Description: Enter a descriptive name, e.g., "Insight Shipping Integration".

• User: Select the admin user or the user you wish to associate with these keys.

• Permissions: Choose Read/Write access. This allows the Insight app to read order data and update order statuses when they are fulfilled.

4. Generate the API Key

• Click on Generate API Key.

• WooCommerce will display your new Consumer Key and Consumer Secret.

•  Copy these keys; you'll need them for the Insight app configuration.

Important: Treat these keys like passwords. Keep them secure and do not share them publicly.

5. Note Your Store's API Endpoint

Your WooCommerce store's API endpoint is typically in the following format:

• https://yourstore.com/wp-json/wc/v3/

Going back to Insight, we can complete the store information:

• REST API ENDPOINT: https://yourstore.com/wp-json/wc/v3/

• API VERSION: We leave this field as blank for WooCommerce

• TOKEN 1: Consumer Key value provided from the REST-API key we created.

• TOKEN 2: Consumer Secret value provided from the REST-API key we created.

• STORE NAME: The name of your store, only to be used as an identifier.

• STORE WEB. ADDRESS: This field should automatically be populated from the first page.

Price at Checkout for WooCommerce

Before you start, please ensure that you obtain your BEX token from your sales representative. You will need this to complete the plugin installation.

To obtain the plugin file, download it from https://track.bex.co.za/bex-woocommerce-plugin.zip

Head over to your site’s admin panel and proceed as follows:

1. Hover over the Plugins menu and select Add New.

2. Click on the Upload Plugin button.

3. Click the Choose File button and browse to the location where the plugin file downloaded to. More often than not, this will be in your Downloads folder. Select the file and then proceed by clicking the Install Now button.

4. Some informational messages will be printed alongside an activation button. Click on the Activate Plugin button to activate our plugin.

5. Head over to the WooCommerce settings page armed with your BEX token as discussed at the start of this document.

6. Select the Shipping tab and then select BEX Express.

7. Enter your BEX token and hit the Save button. 

That concludes the plugin installation and configuration and should enable shipping rates at check-out.