WooCommerce
Connect WooCommerce to the WMS: orders arrive automatically, products link by SKU, stock is sent once you turn it on, and shipments are reported back.
What it does
Connect your WooCommerce store to the WMS so orders come in on their own, products are linked to your WMS products by SKU, WooCommerce is told when an order ships and, once you're ready, the WMS keeps the store's stock up to date.
How it works
- Orders (WooCommerce → WMS), automatic: the WMS checks your store every few minutes and imports the orders that match your Order Import Filters. Once you've selected Register webhooks, new orders arrive straight away instead of waiting for the next check. Imported orders go to the warehouse and shipping process of the location marked Default for Orders.
- Cancellations: an order cancelled on WooCommerce is never brought into the WMS. If it had already been imported, the WMS cancels its shipping order too.
- Order Import Filters: filter by Order Status, Payment (paid or unpaid) and Payment method. Leave a filter empty to import everything. A cash-on-delivery order counts as unpaid until it's paid, so include Unpaid if you want those orders.
- Carriers: under Shipping Carrier Mappings, link each WooCommerce shipping method to a WMS carrier so imported orders get their carrier automatically. If you need to, also pick a Payment method: the same shipping method can have one rule per payment method, and the rule set to Any covers the rest.
- Products (WooCommerce → WMS): on the Product Mappings tab, Sync all products reads your whole WooCommerce catalogue and Sync changed products only what changed since the last sync. Each item is matched to the WMS product with the same SKU; when there's no match, a new WMS product is created, unless you turn on Skip products without a WMS match. Both run in the background with progress, so you can leave the page. Once webhooks are registered, products created or updated in WooCommerce are picked up the same way, automatically. Product sync never changes stock or existing mappings.
- Products new in the WMS: the regular check also links products recently created in the WMS (by your ERP, for example) to the WooCommerce product with the same SKU. A SKU found on more than one product is left alone. To re-check one product, select Link to the WooCommerce product with this SKU on its row in Product Mappings.
- Stock (WMS → WooCommerce), when you turn it on: the Stock Sync switch is off by default, so nothing is written to WooCommerce until you decide. Once it's on, the WMS sends each product's available stock from the locations with Sync Stock turned on, replacing the quantity in WooCommerce. Units WooCommerce is holding for orders the WMS hasn't reserved yet are taken off, so the store doesn't sell them twice. Drops in stock go out straight away; increases (a reception, for example) go out with the next regular check. Products whose stock WooCommerce doesn't manage are left alone, and so is any product whose Sync switch is off in Product Mappings.
- Shipping (WMS → WooCommerce), automatic: when an order ships in the WMS, WooCommerce is told. If everything shipped, the order is marked completed, with the tracking number when there is one. If only part shipped, the order stays in processing so you can refund or cancel the rest, and the customer gets a note saying what was sent. Customer notes are written in the language of the country the order ships to.
- Order Search: on the Order Search tab, type an order number (with or without the
#) to see whether it's in the WMS and, if not, why: a filter it didn't match, cancelled on WooCommerce, an earlier import that failed, or simply not collected yet. Unless it's cancelled, you can bring it in on the spot with Import to WMS. This tab is available to administrators.
How to set it up
- In WooCommerce, create a REST API key with Read/Write permission and keep its consumer key and consumer secret.
- In the WMS, open Plugins, find WooCommerce under Marketplace and activate it.
- On the Connection tab, enter the Store URL, Consumer Key and Consumer Secret, then select Connect. Use Test Connection at any time to check the link.
- Under Location Mappings, select Add Location, enter a Location ID and Location Name, choose the Warehouse and Shipping Process, and select Add. The first location you add is the Default for Orders.
- Set up your Shipping Carrier Mappings, Order Import Filters and Product Import Settings, then select Save.
- Select Register webhooks so new orders and product changes arrive at once. It's safe to repeat.
- On Product Mappings, run Sync all products for the first import.
- When you've checked that stock in the WMS is right, turn on Stock Sync.
Important notes
- Product sync never creates stock; it only links catalogues.
- Location, carrier and filter changes only take effect after Save. The switches save as soon as you flip them.
- Stores connected before Stock Sync existed also start with it off: turn it on if you want the WMS to keep sending stock.
- If Register webhooks says WooCommerce refused them, check that the API key has read/write permission.