Plugin Sync (Firewall-Proof)
Use this page to install and connect the Brother POS plugin on your WordPress site — the recommended, firewall-proof way to keep WooCommerce in sync.
Quick steps
- In Brother POS, go to Settings > More Actions > WooCommerce Integration > Edit Settings and make sure Sync direction is Plugin push / pull (the default). Click Save Settings.
- On the WooCommerce Integration page, under Connect your website in 3 steps, click Download the BrotherPOS plugin. In WordPress, go to Plugins > Add Plugin > Upload Plugin, install the .zip and click Activate Plugin.
- 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 runs a first full sync straight away and says how many products are in sync. The WooCommerce Integration page in Brother POS then shows Connected to your website.
- Open WooCommerce > BrotherPOS Diagnostics in WordPress if you want the full report.
With Plugin push / pull and Products on the website set to BrotherPOS manages them (the default), product edits made in WooCommerce are sent back and change your Brother POS products too. For a website that keeps its own products, see Websites that keep their own products.
Common questions
Do products update on their own after the first sync? Yes. After a change in Brother POS (a product edit, a sale, an order status), Brother POS asks your website to check in straight away, so the change is usually there within seconds (plugin 1.8.7 or newer). If your host blocks that call, the plugin still checks for changes at most every 15 minutes while your site gets visits. In WordPress, BrotherPOS > Sync now checks in on demand.
The big first import stopped partway. Click Sync all products from BrotherPOS now again (on the plugin's API Setup tab under WooCommerce > Weight Pricing). Products are matched by SKU, so nothing is duplicated.
Which plugin version should I have? The latest, 1.9.6. Download it from the WooCommerce Integration page and upload it in WordPress (Plugins > Add Plugin > Upload Plugin > Replace current with uploaded). The Diagnostics page shows your version.
Do I set tax and shipping in WordPress? No. Set them once in Brother POS; the plugin applies them to your website.
My website already takes orders. Will connecting change its checkout? Not without your OK. If your site already has orders, the plugin changes nothing and shows a notice in WordPress. Click Keep my own checkout settings to keep your payment, shipping and tax as they are. Click Let BrotherPOS manage checkout to use the Brother POS settings instead. Your old settings are saved first, and WooCommerce > BrotherPOS Diagnostics has a Restore my settings from before BrotherPOS button. To stop Brother POS changing them at all, untick Auto-configure this store from BrotherPOS in Brother POS. This needs plugin 1.8.6 or newer.
More detail: the two sync modes and why the plugin is more reliable
The recommended way to connect a WooCommerce store to Brother POS is the Brother POS plugin. The plugin does the work from your website's side: it pulls your product catalog and storefront settings from Brother POS, and sends online orders back. Every connection starts from your website, so it gets past Cloudflare, security plugins, and host firewalls that block the older connection.
Two Sync Modes
You choose the mode in Brother POS under Settings > More Actions > WooCommerce Integration > Edit Settings, in the Sync direction field.
| Mode | How it works | When it is used |
|---|---|---|
| Plugin push / pull (recommended) | Your website's plugin reaches out to Brother POS to pull the catalog and settings, and sends orders in. | The default for new WooCommerce setups. |
| Legacy pull | Brother POS reaches into your website over the WooCommerce REST API. | Stores set up before the plugin existed. Existing setups kept this mode. |
Why Plugin Sync Is More Reliable
In legacy pull mode, Brother POS connects into your website. Security tools are built to stop exactly that kind of connection:
- Cloudflare and other firewalls can rate-limit or block Brother POS.
- Security plugins (Wordfence, Sucuri) can reject the requests.
- Some hosts block product updates and deletes entirely, even when your API keys are valid.
With plugin push / pull, every connection starts on your website and goes out to Brother POS, so none of these blocks get in the way.
More detail: what the plugin keeps in sync
What the Plugin Keeps in Sync
1. Catalog Pull (products in)
The plugin pulls your product catalog from Brother POS and saves each product in WooCommerce.
- Automatic and incremental. After a change in Brother POS, your website is asked to check in straight away (plugin 1.8.7 or newer; some hosts block this). Otherwise, when your site gets visits, the plugin checks for changed products at most every 15 minutes. Either way it only pulls what changed since last time.
- Full sync on demand. Sync all products from BrotherPOS now pulls the whole catalog in batches of 100.
- Matched by SKU. Products are found or created by SKU, so running it again never creates duplicates. If a big import stops partway, just run it again. From plugin 1.9.6, a product that WordPress's own SKU index has lost track of is still found by its SKU (and the index is fixed) instead of being listed a second time.
- What it carries. Name, price, sale price, description, stock, categories (with category images), weight pricing, quantity pricing, cannabis details (THC/CBD, strain type, dominant terpene), and images.
- Products with variations (plugin version 1.8.0 or newer). A product with variations shows on your website as one product with a Variation drop-down, and each choice has its own price, stock and image. A variation you deactivate or delete is hidden on your website at the next pull. When a customer orders a variation online, Brother POS takes it off that variation's stock. Older plugin versions leave products with variations off your website.
- What it leaves out. Inactive and deleted products are not listed. Neither are products with Don't sync to WooCommerce ticked, or products whose categories all have WooCommerce Sync turned off on the Categories page. Combos with choice slots, build-your-own platters and buckets are left out too, because someone at the counter has to choose part of what the customer gets. Fixed bundles and regular products sync as normal.
- Taking products off your website (plugin version 1.7.21 or newer). When a product your website already has is deactivated, deleted, or left out for one of the reasons above, the next catalog pull sets it to draft in WooCommerce, so it leaves your storefront. It is never deleted, so past orders still point to it. A product your website never had is skipped. If you make the product active or sellable online again, a later pull publishes it again.
The first catalog pull after you update the plugin also drafts products that were deactivated or left out before the update. When you turn off WooCommerce Sync for a whole category, the message says how many of its products will come off your website at the plugin's next sync, and how many stay listed because they're also in another synced category.
See Product Sync for more detail.
2. Config Pull (storefront settings in)
The plugin pulls your storefront settings from Brother POS (at most every 5 minutes, when your site gets visits) and applies them to WooCommerce. You set these once in Brother POS instead of in each website. This only happens while Auto-configure this store from BrotherPOS is ticked, and a website that already had orders waits until an admin clicks Let BrotherPOS manage checkout in WordPress. They include:
- Payment methods: Interac e-Transfer and Pay on Pickup (see Order Sync).
- Tax, built from your Brother POS tax settings (see below).
- Shipping: free over a threshold, a flat delivery fee, and local pickup (see below).
- Checkout add-ons: tip selector and delivery/pickup scheduling.
- Freebie deals: your synced freebie campaigns (see Freebie Sync).
- Go live: turns off WooCommerce's "Coming soon" mode and turns on order sending.
3. Orders and Changes Out
When a customer checks out, the plugin sends the order to Brother POS right away. See Order Sync.
When you complete, void or refund a website order in Brother POS, your website shows it as Completed, Cancelled or Refunded too (plugin version 1.8.4 or newer). The plugin checks for these changes about once a minute while people are visiting your website, so a quiet website can take a little longer.
When Sync direction is set to Plugin push / pull, the plugin also sends changes made in WooCommerce back, and they change the matching Brother POS product:
- Editing a product in WooCommerce updates its name, description, price, stock and whether it is active in Brother POS. Products are matched by SKU, and a product added in WooCommerce is added to Brother POS too.
- Trashing or deleting a product in WooCommerce deactivates it in Brother POS, once the two are linked (for example, after the product has been edited in WooCommerce, or came across in an import or export).
Make your product changes in Brother POS so the two stay consistent.
A store on Legacy pull ignores these product and stock changes, even if the plugin is installed (unless the store is part of a Multi-Brand Network). Online orders still come in whichever mode you use.
Older versions of the plugin also sent back the products it had just pulled, the updates Brother POS itself made in WooCommerce, and the stock WooCommerce took off for an online order. That could overwrite your Brother POS prices and stock with WooCommerce's copy, or take an online sale off your stock twice. From version 1.7.20, only real changes made in WooCommerce are sent back. The Diagnostics page shows which version you have.
More detail: installing and connecting the plugin
Connecting the Plugin
- In Brother POS, open Settings > More Actions > WooCommerce Integration. Under Connect your website in 3 steps (or Connect again, or on another website once connected), click Copy next to Connection key. Only admins see the key. Keep it private: it lets a website sync with your store.
- In WordPress, click BrotherPOS in the left menu.
- Paste the key and click Connect. The plugin checks the key with Brother POS before saving it, then runs a first full sync.
The BrotherPOS page in WordPress then shows what it's connected to, when it last synced, what stays in sync, a Sync now button, and Disconnect (which stops syncing but leaves your products and orders as they are).
The key holds the three connection details (BrotherPOS Ingest URL, Site ID and Shared Secret). Support can still enter them one by one: they're under Connect the WordPress plugin manually on the WooCommerce Integration page (admins only), and go under BrotherPOS Catalog Sync (Pull) on the plugin's API Setup tab (WooCommerce > Weight Pricing).
Every message between the plugin and Brother POS is signed with your store's private secret, so only your store's plugin can send or pull your data.
More detail: websites that keep their own products
Websites That Keep Their Own Products
In the WooCommerce settings, Products on the website decides who owns the products on your website:
| Choice | What happens |
|---|---|
| BrotherPOS manages them (default) | Names, prices, categories and stock on the website come from Brother POS. |
| The website keeps its own; BrotherPOS only keeps the stock counts | Brother POS never rewrites the website's products. Changes made on the website still come into Brother POS, and Brother POS keeps stock in step. Needs plugin 1.8.7 or newer. |
| The website keeps its own; edits and new products go both ways | Name, price, description, on/off and stock: change them on either side and the other follows. A product you make in Brother POS is made on the website too. Products you make in Brother POS, and your cost and retail prices, need plugin 1.9.0 or newer. |
Orders placed on the website come into Brother POS whichever you choose.
More detail: automatic tax and shipping setup
Automatic Tax Setup
The plugin builds your WooCommerce tax rates from the tax settings in Brother POS, so you don't need a separate tax plugin.
- Prices stay entered before tax, like in the POS. Tax is added at checkout.
- Split tax (for example GST + PST) gets one rate line for each tax.
- An additional tax (such as the SK Vapour Products Tax) is added as its own line.
- Every customer is charged your store's rate, based on your shop's location.
When you change your tax settings in Brother POS, the next pull replaces the old rates, so duplicates don't build up. If no tax rate is set in Brother POS, WooCommerce tax is turned off.
Automatic Shipping Setup
The plugin sets up WooCommerce shipping from your Brother POS delivery settings:
| Method | Behavior |
|---|---|
| Free shipping | Added when Offer free shipping is ticked. Free over your free-delivery threshold, or always free if no threshold is set. |
| Flat-rate delivery | Your delivery fee. Labeled "Delivery" if your store does local delivery, otherwise "Shipping". |
| Local pickup | Free, when pickup is enabled for your store. |
- Every shipping zone is set up, not just one, so a leftover zone (such as "United States") can't override your rates. Old free-shipping, flat-rate and pickup methods are removed first, so nothing is left over.
- The paid delivery option is hidden when free shipping applies, so customers don't see a delivery charge next to a free option.
- Cached shipping rates are cleared after each update, so shoppers see the new rates right away.
More detail: installing the plugin, step by step
Installing the Plugin
- Download the plugin. Click Download the BrotherPOS plugin on the WooCommerce Integration page in Brother POS. Leave the .zip zipped.
- Upload it to WordPress. Go to Plugins > Add Plugin > Upload Plugin, choose the .zip, and click Install Now.
- Activate Plugin.
- Connect it as described in Connecting the Plugin. The first full sync runs as soon as you click Connect. After that, products and settings refresh on their own.
After connecting, the WooCommerce Integration page in Brother POS shows Connected to your website and when it last synced. For more, open WooCommerce > BrotherPOS Diagnostics: it shows whether the ingest URL and shared secret are set, and when the last product pull ran. See Diagnostics.
More detail: troubleshooting and good habits
Troubleshooting
| Problem | Solution |
|---|---|
| Products not appearing online | Check the plugin is connected (BrotherPOS in the WordPress menu), or check Diagnostics for the ingest URL and shared secret. Click Sync all products from BrotherPOS now, then check Last product pull. Make sure the product is active and its category has WooCommerce Sync on. |
| Storefront still shows "Coming soon" | Tick Take store live (disable "coming soon") in the WooCommerce settings. The plugin applies it on its next settings pull. |
| Orders not reaching Brother POS | Make sure Take store live is ticked, and check the ingest URL and shared secret on Diagnostics. |
| An order made in the WooCommerce admin or by another app shows in Brother POS with no items, or the register says its products are missing | Update the plugin to version 1.8.5 or newer. Brother POS fills in an order like that by itself when its items arrive. For an order that's already waiting, open it in WooCommerce and click Update. |
| A website order stays Processing after you complete it in Brother POS | Update the plugin to version 1.8.4 or newer. Orders you completed, voided or refunded before the update change on your website within a few minutes. |
| Tax not calculating online | Make sure your tax rates are set in Brother POS. The plugin only turns on WooCommerce tax when a rate is set. |
| Brother POS prices or stock change after a catalog pull, or an online order takes stock off twice | Update the plugin to version 1.7.20 or newer. |
| A product with variations isn't on your website | Update the plugin to version 1.8.0 or newer, then click Sync all products from BrotherPOS now. |
| A product you deactivated or deleted in Brother POS is still for sale online | Update the plugin to version 1.7.21 or newer, then click Sync all products from BrotherPOS now. The product is set to draft in WooCommerce. |
| Big catalog import stops partway | Click Sync all products from BrotherPOS now again. It matches by SKU and skips images that are already there. |
| Old store still using the REST API | Switch Sync direction to Plugin push / pull in the WooCommerce settings, then install and connect the plugin. |
| The same product shows twice on the website after a sync | Update the plugin to version 1.9.6, which finds a product by its SKU even when WordPress's SKU index has lost it. |
Best Practices
- Use plugin push / pull for new stores. It avoids firewall problems entirely.
- Set payment, tax, and shipping once in Brother POS. The plugin applies the same settings to your website.
- Keep the plugin up to date so new sync features work. Use version 1.7.20 or newer so catalog pulls and online orders don't change your Brother POS prices and stock, 1.7.21 or newer so deactivated products come off your website, 1.8.0 or newer so products with variations reach your website, 1.8.1 or newer so website orders keep their payment and shipping method and products without a SKU aren't duplicated, 1.8.2 or newer so products sold by weight show your real price for each weight, 1.8.3 or newer so products with variations show each variation's own weight prices and the settings page hides your keys, 1.8.4 or newer so orders you complete, void or refund in Brother POS change on your website and online orders show when they were placed, 1.8.5 or newer so orders made in the WooCommerce admin or by other apps reach Brother POS with their items, 1.8.7 or newer so changes reach your website within seconds, and 1.9.6 so a product is never listed twice when WordPress's SKU index is out of date.
- Check Diagnostics after installing to confirm the connection before you go live.
What's Next?
- Product Sync — What the catalog pull sends and how products are matched.
- Order Sync — How online orders and payment options flow back to Brother POS.
- Diagnostics — The troubleshooting page on your WordPress site.
- Health Monitor — Sync activity from the Brother POS side.