WooCommerce POS integration

How the sync works

SeroPOS is where you keep your catalogue. From the WooCommerce dashboard in the back office you sync categories first, then products, and the shop builds its listings from them: variations and attributes for things like size and colour, images, the selling price and the stock on hand. You can sync new products only, or all of them when prices change.

Orders flow the other way. Press Sync orders, or let the signed webhooks bring them in as they are placed, and each web order becomes a sale in SeroPOS with its customer and items. Stock comes off the same count the till uses, so the shop and the counter share one inventory.

Connecting your store

In WooCommerce, create REST API keys with read and write access. Then open WooCommerce in the SeroPOS sidebar, go to API Settings, and enter your store URL with the consumer key and secret. Choose the business location the web shop sells from, because its stock is what the website will show.

The Webhooks tab gives you the URLs and secret to add in WooCommerce for order created, updated, deleted and restored. With those in place, orders arrive in real time. Turn on auto-sync as well and SeroPOS runs a full sync twice a day, at 1:00 and 13:00, to catch anything missed.

• Create REST API keys in WooCommerce
• Enter store URL, key and secret in API Settings
• Pick the location the shop sells from
• Add the order webhooks to WooCommerce
• Map tax rates and order statuses
• Sync categories, then products, then orders

Product settings that matter

The Product sync tab decides how your listings look. Set a default tax class, whether prices go up tax inclusive or exclusive, and which selling price group the shop uses, so web prices can differ from counter prices if you want. You also choose whether the long or short description is sent.

Separate choices for create and update let you protect work done in WooCommerce. For example, you might send name, price, images and description when a product is first created, then only price and stock afterwards. Products you never want online can be kept off with the Disable WooCommerce sync box on the product form.

Orders, statuses and customers

WooCommerce orders move through statuses such as pending, processing, completed, cancelled, refunded, failed and on-hold. On the Order sync tab you map each one to a SeroPOS sale status and a shipping status, so, for example, a processing web order can come in as a sale that is still waiting to ship, while a cancelled one is mapped to a status that keeps it out of your sales.

If the shopper has an account, SeroPOS links the sale to that customer. Guest orders create a customer from the billing address. Those customers then appear in your contacts with their purchase history, alongside people who buy at the counter, and a notification tells you when new orders have synced.

Fixing a sync and starting over

The Sync Log lists every run, with details for each entry, so a product that did not appear on the website can be traced to the reason. Most problems are a missing tax mapping or a product set not to sync. Fix the cause, run the sync again and check the log to confirm the product went up.

If you change shops or want a clean start, the dashboard has reset actions for synced categories and synced products. These clear the link between SeroPOS and the old listings, so the next sync creates them fresh. Each part of the integration has its own permission, so you can let a staff member sync orders without giving them the API settings.