WooCommerce integration

Prerequisites

This section outlines the various settings and conditions required for a smooth integration of your WooCommerce store with your Stock&Buy account.
  • Make sure that all your products and their variants have their SKUs defined
  • Make sure that your products are marked as visible in WooCommerce (Visibility > Public) and that the option to track inventory is selected at either the product or variation level
  • Check 'Manage stock' option for all your products and their variants so that Stock&Buy can manage your WooCommerce orders and inventory for you
  • Your store must be running WooCommerce version 2.1 or above.
  • The WooCommerce REST API must be enabled in read/write mode so that Stock&Buy and sync data into and out of your store. Please read this article to get more details on enabling the WooCommerce REST APIs

Installation

Once you are logged into your Stock&Buy account, go to the INTEGRATIONS page accessible from the main application navigation menu on the left hand side of your screen.
Look for the WooCommerce add-on and click on 'Install'. A dialog will pop up to guide you through the installation process. 

Note: At installation time, Stock&Buy will create a couple of WebHooks on your WooCommerce store. These WebHooks are required to ensure your orders created on your WooCommerce store flawlessly flow into Stock&Buy in real time. This is crucial to keep you inventory always in sync with your stores, especially if you have multiple sales channels enabled. Please do not edit or remove these WebHooks manually.

Operations

The section describes the operations offered by the WooCommerce addon for Stock&Buy. 

Products

Once your WooCommerce addon is installed, Stock&Buy will automatically add a section into the Import Products wizard module available on the INVENTORY page. Open the Import Products wizard and select WooCommerce, click next and you will be presented with a screen outlining the various conditions that must be fullfilled to properly import your WooCommerce products into Stock&Buy.
Notes: 
  • Stock&Buy will not sync your product information (other than the stock on hand quantities) after the import is done
  • Products and variants will be imported exactly as they are defined on your WooCommerce store - the structure will be kept intact!
  • Products and variants with no SKUs defined will be skipped and will not be imported into your Stock&Buy account

Sales Orders

Orders and contacts are automatically synced from your WooCommerce store into your Stock&Buy account. Given that orders on WooCommerce have different statuses in Stock&Buy, the following mapping is applied:
WooCommerce order status Stock&Buy order status Notes
Processing Invoiced If the order already exists in Stock&Buy (has previously been synced) 
The allocated inventory on Stock&Buy will depend on the previous state of the order. 
If the order was in Allocated state then the inventory is allocated.
The total available stock will automatically decrease on all your connected sales channels.
If the order was in Shipped state then the units enclosed in the order will be put back to the total available stock but will be allocated.
This will not change the available quantities on your sales channels as the units being put back to your inventory will remain in the allocated state.  
If the order is new in Stock&Buy
The total amount of allocated inventory increases.
The total quantity remains the same in Stock&Buy.
The available stock of all products included in the order will automatically decrease in all your connected sales channels
On-Hold Invoiced If the order already exists in Stock&Buy (has previously been synced) 
The allocated inventory on Stock&Buy will depend on the previous state of the order. 
If the order was in Allocated state then the inventory is allocated.
The total 
available stock will automatically decrease on all your connected sales channels.
If the order was in Shipped state then the units enclosed in the order will be put back to the total available stock but will be allocated.
This will not change the available quantities on your sales channels as the units being put back to your inventory will remain in the allocated state.  

If the order is new in Stock&Buy
The total amount of allocated inventory increases.
The total quantity remains the same in Stock&Buy.
The available stock of all products included in the order will automatically decrease in all your connected sales channels
Pending Allocated The total amount of allocated inventory increases.
The total quantity remains the same in Stock&Buy.
The available stock of all products included in the order will automatically decrease in all your connected sales channels
Failed Invoiced If the order already exists in Stock&Buy (has previously been synced)
The allocated inventory on Stock&Buy will depend on the previous state of the order.
If the order was in Allocated state then the inventory is allocated.
The total available stock will automatically decrease on all your connected sales channels.
If the order was in Shipped state then the units enclosed in the order will be put back to the total available stock but will be allocated.
This will not change the available quantities on your sales channels as the units being put back to your inventory will remain in the allocated state.  
If the order is new in Stock&Buy
The total amount of allocated inventory increases.
The total quantity remains the same in Stock&Buy.
The available stock of all products included in the order will automatically decrease in all your connected sales channels
Completed Shipped The total stock on hand in Stock&Buy will decrease
No updates are pushed to your connected sales channels
Cancelled Quote All units that are in the order will be put back to the stock on hand
Refunded Quote All units that are in the order will be put back to the stock on hand
Custom statuses Not applicable This is currently not supported
Note: When an existing order is synced from WooCommerce to Stock&Buy, only the order status is updated. Newly added line items will not be imported.

Purchase Orders

Purchase orders will automatically increase the purchased goods quantities on Stock&Buy and on all your sales channels as soon as the order is fully received (in Received state) 

Contacts

Contacts are automatically imported from your WooCommerce store when importing sales orders. Contacts are matched to the existing contacts in Stock&Buy by email. All orders that do not have customer information will be assigned to an 'Anonymous' customer which will be added to your contacts list. 

Logging

Stock&Buy will log an activity event for each and every interaction that occurs with your WooCommerce store. You can find all the logs under the ACTIVITY page accessible from the main application navigation bar.


Feedback and Knowledge Base