WooCommerce Setup
Use this page to connect your WooCommerce website to Brother POS, so your products go online and online orders come into Brother POS.
Quick steps
These steps use the Brother POS plugin (Plugin push / pull), which is recommended for every new store.
- Turn it on. Go to Settings, Sales & Integrations tab. Tick Enable WooCommerce Integration and click Update Settings. (If you don't see the box, click Advanced at the top of Settings to show all settings.) A WooCommerce Integration link now appears under Settings > More Actions.
- Check the settings. Click Settings > More Actions > WooCommerce Integration > Edit Settings. Tick Enable WooCommerce Integration, make sure Sync direction is Plugin push / pull (the default), and click Save Settings.
- Install the plugin. Back on the WooCommerce Integration page, under Connect your website in 3 steps, click Download the BrotherPOS plugin (leave the .zip zipped). In WordPress, go to Plugins > Add Plugin > Upload Plugin, choose the file, click Install Now, then Activate Plugin.
- Connect it. In Brother POS, click Copy next to Connection key. In WordPress, click BrotherPOS in the left menu, paste the key and click Connect. The plugin checks the key, then runs a first full sync and tells you how many products are in sync.
- Check it. The WooCommerce Integration page now shows Connected to your website. In WordPress, WooCommerce > BrotherPOS Diagnostics shows the full report.
After the first sync, make product changes in Brother POS, not in WooCommerce. Brother POS is the master.
Common questions
I don't see the WooCommerce buttons. Do step 1 first (the links are under Settings > More Actions). If they still don't appear, WooCommerce isn't included on your plan — contact Brother POS support.
Do I need WooCommerce API keys? Not for Plugin push / pull. The Consumer Key and Secret are only for the older Legacy pull method.
My website already has its own products. Will Brother POS overwrite them? Only if you let it. In the WooCommerce settings, Products on the website has three choices: BrotherPOS manages them (names, prices, categories and stock come from Brother POS), The website keeps its own; BrotherPOS only keeps the stock counts, or The website keeps its own; edits and new products go both ways (name, price, description, on/off and stock). Pick one of the last two for a website that's already set up.
The website already has old orders. Will they be sold again? Set Bring in website orders placed from to the date you start. Older orders are left out, so their stock isn't taken twice. Leave it blank to bring in every order the website sends.
Online orders become sales straight away. Can I check them first? Untick Auto-fulfill Orders in the WooCommerce settings. Orders then wait on the Orders page for staff to complete them.
How do I stop syncing? Untick Enable WooCommerce Integration in the WooCommerce settings and click Save Settings. Your settings are kept.
More detail: the two connection methods
Connect your WooCommerce-powered website to Brother POS to publish your products online, bring online orders into Brother POS for fulfillment, and keep stock levels accurate across both.
The WooCommerce Integration and WooCommerce Monitor links appear under Settings > More Actions once you tick Enable WooCommerce Integration under Settings, Sales & Integrations tab, and click Update Settings. WooCommerce isn't included on the entry plan — if the buttons still don't appear, contact Brother POS support.
Choose Your Connection Method
There are two ways to connect. You pick one in the Sync direction field on the WooCommerce settings form:
| Method | How it connects | Recommended for |
|---|---|---|
| Plugin push / pull | The Brother POS plugin on your website pulls your catalog and storefront settings from Brother POS and sends orders back. Works behind Cloudflare and firewalls. | All new stores (this is the default for new setups). |
| Legacy pull | Brother POS reaches into your website over the WooCommerce REST API using a Consumer Key and Consumer Secret. | Older stores set up before the plugin existed. |
Online orders come into Brother POS with either method. Product and stock edits made in WordPress only come back into Brother POS on Plugin push / pull. On Legacy pull they are ignored, even if the plugin is installed.
If you are setting up a new store, install the Brother POS plugin and follow Plugin Sync (Firewall-Proof). Admins copy the plugin's Connection key from the WooCommerce Integration page. Steps 1 and 2 below (REST API keys) are for the legacy pull method.
Prerequisites
- A live WooCommerce store. The Brother POS plugin supports WooCommerce 6.0 or later.
- Admin access to your WordPress / WooCommerce dashboard.
- Admin or Manager access to Brother POS.
- An HTTPS address for your store (a valid SSL certificate).
If you type your store address without http:// or https://, Brother POS adds https:// for you. A trailing slash is removed automatically, so https://shop.example.com and https://shop.example.com/ both work. Your Consumer Key and Secret are stored encrypted.
More detail: legacy pull — REST API keys and connection settings
Step 1: Generate WooCommerce REST API Keys
Steps 1 and 2 apply to the legacy pull method.
- Log in to your WordPress admin dashboard.
- Go to WooCommerce > Settings > Advanced > REST API.
- Click Add key.
- Fill in the fields:
- Description:
Brother POS Integration - User: Select an administrator account.
- Permissions: Select Read/Write.
- Description:
- Click Generate API key.
- Copy the Consumer Key and Consumer Secret right away. The secret is only shown once.
The Consumer Secret is displayed only once. If you lose it, delete the key in WooCommerce and create a new one.
Step 2: Configure WooCommerce in Brother POS
- In Brother POS, go to Settings, open More Actions and click WooCommerce Integration.
- Click Edit Settings.
- Under Connection Settings, tick Enable WooCommerce Integration and choose your Sync direction.
- For legacy pull, fill in:
| Field | Description | Example |
|---|---|---|
| Store URL | Your WooCommerce store address | https://shop.example.com |
| Consumer Key | The key from Step 1 | ck_abc123... |
| Consumer Secret | The secret from Step 1 (leave blank later to keep the saved one) | cs_xyz789... |
- Click Save Settings.
More detail: every sync and storefront setting
Step 3: Configure Sync Options
The Sync Settings section of the same form has these options:
| Setting | What it does |
|---|---|
| Import Products from WooCommerce | Allows the first product import from WooCommerce. After that first import, Brother POS is the master for your products and no longer pulls product changes from WooCommerce. |
| Import Orders from WooCommerce | Brings online orders into Brother POS. In legacy pull, Brother POS checks for new Processing orders on each sync cycle. In plugin mode, the plugin sends orders as they are placed. |
| Push Inventory to WooCommerce | Legacy pull only: sends Brother POS stock levels to WooCommerce on each sync cycle. In plugin mode, stock travels with the catalog instead. |
| Auto-fulfill Orders | When ticked (the default), imported orders become sales automatically. When unticked, they wait on the Orders page for staff to complete them. |
| Auto-print Labels on Import | Prints product labels when an online order comes in (needs a label printer set up). |
| Sync Tiered Pricing | Sends your quality tier pricing settings to your WooCommerce site on each sync cycle. |
| Auto-correct Unauthorized Changes | When change detection finds a product edited directly in WooCommerce, puts the Brother POS values back. Off by default. |
| Polling Interval (minutes) | How often the sync cycle runs. Default 15, minimum 5. |
| Weight Unit | The weight unit your WooCommerce store uses: grams, ounces, pounds or kilograms. |
The Storefront Setup section controls what the plugin applies to your website (see Plugin Sync):
| Setting | What it does |
|---|---|
| Auto-configure this store from BrotherPOS | The plugin replaces the website's payment methods, shipping methods and tax with the Brother POS settings. A website that already has orders keeps its own until an admin agrees in WordPress. |
| Take store live (disable "coming soon") | Turns off WooCommerce's "Coming soon" mode and turns on the plugin's order sending. |
| Enable Interac e-Transfer payment | Offers e-Transfer at checkout, but only when an e-Transfer email is filled in. |
| e-Transfer payment label | The name customers see for the payment option. |
| e-Transfer email | Where customers send payment. Shown in the checkout instructions. |
| Offer free shipping | Adds free shipping (over your free-delivery threshold, if you have one). |
The same section also has:
| Setting | What it does |
|---|---|
| Products on the website | Who owns the products on the website: Brother POS (names, prices, categories and stock), the website with Brother POS keeping only the stock counts, or the website with edits and new products going both ways. |
| Bring in website orders placed from | Website orders placed before this date aren't brought in, so their stock isn't taken twice. Blank brings in every order. |
| Show transfers to your stores as website orders | Only for a store that sends stock to its own other stores. Enter the website account email each store orders with. Transfers then show on the website as that store's completed orders, and orders a store places on the website with that login come in as a restock order (a requested stock transfer) to review and Approve & ship, not as a sale. Showing transfers on the website needs plugin 1.9.0 or newer. |
More detail: testing the connection and choosing how to start
Step 4: Test the Connection
- Go back to Settings > More Actions > WooCommerce Integration.
- Click Test Connection (shown while the integration is enabled).
- If it works, you'll see "Connection successful!" with your WooCommerce version.
- If it fails, check:
- Are your Consumer Key and Secret correct? Re-copy them from WooCommerce.
- Is your store URL correct and reachable?
- Is your SSL certificate valid?
- Is a security plugin or firewall blocking the WooCommerce REST API?
Security plugins (Wordfence, Sucuri) and firewalls such as Cloudflare often block the legacy connection. If you keep hitting blocks, switch to plugin push / pull, which doesn't need Brother POS to reach into your site.
Step 5: Choose How to Start
While the integration is enabled and setup isn't finished, the Data Sync Setup section on the WooCommerce Integration page offers three choices:
- Import from WooCommerce: for when your products already live in WooCommerce. Click Start Import. The import runs in the background, so you can leave the page.
- Export to WooCommerce: for when your products live in Brother POS. Click Start Export.
- Skip Setup (Manual Configuration): turns on sync without moving any products first.
During an import:
- Categories are brought in first, then products.
- Variable products have their variations brought in too.
- Products get their name, SKU, price, description, stock, and cannabis details from WooCommerce.
When the import finishes, the section shows setup as completed. From then on Brother POS is the master for products: make product changes in Brother POS, not in WooCommerce. Progress and results appear under Recent Sync Activity (click View All Logs for the full list) and on the Health Monitor.
Reset Setup clears the "setup completed" mark so you can run a fresh import.
More detail: advanced options, turning it off, and troubleshooting
Advanced Connection Options (Legacy Pull)
| Setting | When to use it |
|---|---|
| Use REST Route Fallback (?rest_route=) | Your site returns "not found" for WooCommerce API addresses (common on sub-folder installs or hosts with broken permalinks). |
| Use Query Parameter Authentication | Your host strips login headers (common on cPanel/shared hosting), so the normal connection fails even with correct keys. |
WordPress Application Password
On Legacy pull, the WooCommerce Integration page has a WordPress Application Password section (stores on Plugin push / pull don't see it, because they don't need it). Brother POS uses this password to upload product images to your site. Set up the password in the plugin, then click Fetch Credentials (Brother POS also tries this automatically after you save settings or test the connection).
Disabling the Integration
- Go to Settings > More Actions > WooCommerce Integration and click Edit Settings.
- Untick Enable WooCommerce Integration.
- Click Save Settings.
Syncing stops, but your credentials and settings are kept. Tick the box again to resume.
Troubleshooting
| Problem | Solution |
|---|---|
| Health Monitor says "Missing credentials" | Fill in Store URL, Consumer Key and Consumer Secret (legacy pull). |
| Health Monitor says "Waiting for your website to connect" | Plugin push / pull: make sure the plugin is active and connected on your WordPress site, then check its Diagnostics page. |
| Connection test fails | Check the store URL, SSL certificate and keys, and whether a firewall is blocking the connection. Consider plugin push / pull. |
| Orders not appearing (legacy pull) | Make sure Import Orders from WooCommerce is ticked. Only Processing orders are imported. |
| Stock not updating online (legacy pull) | Make sure Push Inventory to WooCommerce is ticked and the product is linked to a WooCommerce product (see Product Mappings). |
What's Next?
- Plugin Sync (Firewall-Proof) — The recommended plugin-based connection for new stores.
- Product Sync — How products get to your website.
- Order Sync — How online orders flow into Brother POS.
- Inventory Sync — How stock levels stay in sync.
- Diagnostics — Troubleshoot host issues from the plugin's in-admin report.
- Health Monitor — Check the health of your WooCommerce integration.