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 > Edit Settings, Sales & Integrations tab. Tick Enable WooCommerce Integration and click Update Settings. A WooCommerce Integration button now appears on Settings.
- Set the sync mode. Click Settings > WooCommerce Integration > Edit Settings. Tick Enable WooCommerce Integration, set Sync direction to Plugin push / pull, fill in your Store URL, and click Save Settings.
- Install the plugin. On Settings > Online Menu, click Download WordPress Plugin. In WordPress, go to Plugins > Add New > Upload Plugin, choose the ZIP, click Install Now, then Activate.
- Connect it. Copy the Brother POS API Key from the WooCommerce Integration page. In WordPress, open WooCommerce > Weight Pricing, API Setup tab, paste it into POS API Key, and click Save POS API Key.
- Add the connection details. On the WooCommerce Integration page, open Connect the WordPress plugin manually and copy the BrotherPOS Ingest URL, Site ID and Shared Secret into the matching boxes under BrotherPOS Catalog Sync (Pull) in WordPress. Click Save Catalog Sync Settings.
- Sync. Click Sync all products from BrotherPOS now. Then open WooCommerce > BrotherPOS Diagnostics to check it's connected.
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. 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.
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 buttons appear under Settings once you tick Enable WooCommerce Integration under Settings > Edit 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 can copy the plugin's connection details from the Connect the WordPress plugin manually section on 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 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 applies the settings below to WooCommerce. |
| 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). |
More detail: testing the connection and choosing how to start
Step 4: Test the Connection
- Go back to Settings > 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
The WooCommerce Integration page has a WordPress Application Password section. 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 > 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). |
| 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.