Connect WooCommerce to Pipe17

In this Article

• Overview
• Requirements
• Connecting WooCommerce
• Connection Flows
• Integration Specific Settings

Overview

WooCommerce is an open-source e-commerce plugin for WordPress designed for small to large sized online merchants. Pipe17 supports the following order flows for the WordPress integration:

• Pull orders from WooCommerce
• Pull products from WooCommerce
• Push inventory updates to WooCommerce
• Push fulfillments to WooCommerce
• Pull locations from WooCommerce

Requirements

Before getting started on this guide, be sure that you have administrator permissions for your WordPress account. This will be needed to obtain your connection credentials for the Pipe17 WooCommerce connector.

Connecting WooCommerce

1. In WooCommerce, navigate to Settings > Advanced > REST API
2. Click on Add Key
3. In the description row, give your new API Key a name (we recommend 'Pipe17', but the name does not have to be specific)
4. In the Permissions row, ensure that Read/Write is selected
5. Click Generate API Key
6. After you click Generate API Key, a new screen titled Key details will appear. 
7. IMPORTANT: Be sure to copy your Consumer Key and Consumer Secret and store these in a secure and safe place. After you leave the Key details screen, you will not be able to view your Consumer secret again.

In Pipe17

1. Click on Integrations > Add Integration > Search for WooCommerce > Add
2. Click on the Integrations tab again, WooCommerce will now appear in your list of connectors. 
3. Open the WooCommerce V3 connector, click on the Connection tab
4. Enter your Store URL without the /wp-admin at the end. Example: www.mystore.com 
5. Enter the Consumer Key you saved earlier in the Consumer API key field
6. Enter the Consumer secret you saved earlier in the Consumer API secret field
7. Click Save

Congrats! Your WooCommerce store is now connected to Pipe17. After you configure your connection flows (next section), Pipe17 will begin importing your orders and sending them to your connected platforms (fulfillment, ERP, etc)

Connection Flows

Pipe17 supports the following order flows for WooCommerce

• Pull orders from WooCommerce
  • Turning on this connection flow will enable Pipe17 to pull in your orders from WooCommerce
• Pull products from WooCommerce
  • Turning on this connection flow will enable Pipe17 to pull in your product catalog, which can be viewed in the Products tab
• Push inventory updates to WooCommerce
  • Turning on this flow will allow Pipe17 to push inventory updates per SKU (from your fulfillment provider) into your WooCommerce account
  • IMPORTANT: Be sure to enable Inventory Tracking Per Product in WooCommerce. This will ensure that WooCommerce receives and records our inventory push successfully. 
• Push fulfillments to WooCommerce
  • Turning on this flow will allow Pipe17 to push fulfillments (including tracking) to your WooCommerce account so that your customers can stay notified.
  • IMPORTANT: Please add and enable the Shipment Tracking for WooCommerce plugin on the connected account if you want to have Pipe17 push fulfillment tracking downstream.
• Pull locations from WooCommerce
  • Turning on this flow will create a location in Pipe17 which can then be mapped to your fulfillment provider if necessary

Integration Specific Settings

• Products
  • Enter a SKU in the field to tell Pipe17 to only pull specific SKUs from your WooCommerce catalog
  • Force products re-sync: This toggle will force Pipe17 to pull in new/updated products on demand.
• Orders
  • Exclude orders created before this date: Enter a date/time to ensure that Pipe17 will not pull in orders before the selected date. 
  • Swap order ID/number: This field is only required if you are migrating from the V1 connector with orders already imported. Leave this option turned off if you have never used the V1 WooCommerce integration with Pipe17
  • Order lines bundle options: WooCommerce includes both bundle and the bundle items (components) in order line items. This option determines whether Pipe17 creates line items based on the bundle SKU or the bundle item SKU. 
  • Update WooCommerce order status for newly imported orders: With a status set, Pipe17 will update the WooCommerce order with this status once it successfully imports into Pipe17
  • Only pull orders in following states: This field gives you the option to have Pipe17 import orders from specific states only
  • Cancel Pipe17 order if cancelled in WooCommerce: Turning on this toggle will cause orders to be cancelled in Pipe17 if they are cancelled in WooCommerce first
  • Apply refunded status to Pipe17 order if refunded in WooCommerce: Turning on this toggle will allow Pipe17 to apply a refunded status to an order if it is manually refunded in WooCommerce first 
  • Cancel WooCommerce order if canceled in Pipe17: Turning on this toggle will cancel the order in WooCommerce if it is cancelled in Pipe17 first 
    • WooCommerce order status for canceled orders: Apply a status label here which will then be applied to orders in WooCommerce if they are canceled in Pipe17
  • Update WooCommerce order status when order is sent to fulfillment: Apply a status here which will then be applied to your order in WooCommerce once the order is sent to fulfillment in Pipe17
• Inventory
  • Only apply inventory updates for specific SKUs: This field gives you the option for Pipe17 to apply inventory updates for those SKUs. 
  • Apply 'Manage stock' option automatically: This option must be enabled for any product for which you want Pipe17 to set inventory values. You can do this in WooCommerce manually or via this setting
  • Force inventory sync: Toggling this setting ON will allow Pipe17 to push an inventory update to WooCommerce on demand