Integrator for EposNow & WooCommerce
Your complete guide to setup, configuration, and troubleshooting.
Introduction
Welcome! This plugin seamlessly integrates your Epos Now point-of-sale system with your WooCommerce online store. It allows for automatic synchronization of products, stock levels, and pricing, saving you time and preventing manual data entry errors. This guide will walk you through every step, from installation to advanced configuration.
Installation
- Download the plugin .zip file from your account.
- Log in to your WordPress dashboard.
- Navigate to
Plugins > Add New
. - Click the "Upload Plugin" button at the top of the page.
- Choose the downloaded .zip file and click "Install Now".
- Once installed, click "Activate Plugin".
Initial Configuration
After activation, you must configure the plugin to connect to your Epos Now account.
- Navigate to
Epos Now Sync > Configuration
in your WordPress menu. - License Key: Enter the license key you received upon purchase. This is vital for activating the plugin and receiving updates. Click "Activate".
- Epos Now API v4 Key: Enter your Epos Now API Access Key. You can generate this from your Epos Now back office under
Apps > API
. - Sync Settings: Choose the default synchronization behavior for products, stock, and prices.
- Click "Save Changes". The plugin will test the API connection. A success message will appear if the credentials are correct.
Core Features
- Two-Way Product Sync: Sync products from Epos Now to WooCommerce or from WooCommerce to Epos Now.
- Real-time Stock Management: Keep stock levels accurate across both your physical and online stores.
- Automated Price Updates: Ensure pricing is consistent between Epos Now and WooCommerce.
- Category Mapping: Link your Epos Now categories to your WooCommerce categories for organized product listings.
- Manual & Cron-based Sync: Trigger a manual sync anytime or set up automated synchronization at regular intervals.
Per-Product Sync Control
While the plugin has global sync settings, you have granular control over each individual product. This is useful for products you only want to sell online or in-store.
- In your WordPress dashboard, navigate to
Products
and edit a product. - Scroll down to the "Product data" section and click on the "Epos Now Sync" tab.
- You will see two checkboxes: Sync Price and Sync Stock. Uncheck these to manage the price or stock for this specific product independently from Epos Now.
- Click the "Update" button to save your changes.
Handling Variable Products
The plugin fully supports WooCommerce variable products (e.g., a T-shirt that comes in different sizes and colors). The synchronization is handled at the individual variation level.
- SKU is Key: Each product variation in WooCommerce must have a unique SKU that exactly matches the corresponding product's Barcode/SKU in Epos Now.
- Parent Product: The main variable product in WooCommerce does not need an SKU, but each variation does.
- Syncing: When a sync runs, the plugin uses the variation's SKU to update its specific price and stock level from the matching product in Epos Now.
System Requirements
To ensure the plugin runs smoothly, please make sure your hosting environment meets the following requirements:
PHP
Requires: 8.2+
Tested up to: 8.4
WordPress
Requires: 6.0+
Tested up to: 6.8.1
WooCommerce
Requires: 9.0+
Tested up to: 9.9.5
Troubleshooting Guide
Encountering an issue? Here are some common problems and their solutions.
Products are not syncing correctly.
▾- API Credentials: Go to
Epos Now Sync > Configuration
and double-check that your API key is correct. - Cron Jobs: If you rely on automatic sync, ensure WordPress cron jobs are running correctly on your server.
- Product SKU: The plugin uses the SKU to match products. Ensure the SKU is identical on both platforms.
- Individual Product Settings: Check the product's "Epos Now Sync" tab to ensure sync is enabled.
Variable products are not syncing.
▾- Go to the
Products > Variations
tab for the product in WooCommerce. - Ensure that every single variation has a unique SKU assigned to it.
- Confirm that these SKUs exactly match the Barcodes/SKUs of the corresponding products in Epos Now.
I see a "cURL error" or "API connection failed".
▾- Firewall: Your web host's firewall might be blocking outgoing connections. Ask them to whitelist connections to
api.eposnowhq.com
. - PHP cURL Extension: Ensure the cURL extension for PHP is installed and enabled on your server.
Frequently Asked Questions
Can I sync orders from WooCommerce to Epos Now?
▾Order synchronization is currently in development and is planned for release in a future version. The plugin's primary focus at this time is on providing robust product, stock, and price synchronization.
How does the automatic sync work?
▾While the plugin syncs automatically after key events like a purchase, it also includes a scheduled sync as a failsafe to ensure data consistency. You can set the interval for this scheduled sync (in minutes or hours) directly on the plugin's configuration page. This acts as a regular check to correct any potential discrepancies.
Does the plugin sync product images?
▾While the plugin currently focuses on core data like SKU, name, price, and stock, product image synchronization is in development and planned for a future release. For now, we recommend managing your product imagery directly within WooCommerce for the best results.
What happens if I change a product's SKU or Barcode?
▾The SKU or Barcode is the unique identifier used to link products between the two systems. If you change it in one system, you must change it in the other to match. If the identifiers do not match, the plugin will not be able to sync that product, and may even create a new duplicate product during the next sync cycle.