WooCommerce Sync for NexoPOS 4.x is a module that ensures permanent connectivity with a WooCommerce store. This module is helpful to have a unified inventory online with NexoPOS 4.x, and ensure every time an order is created online, it's reflected on both sides (WooCommerce and NexoPOS) but that's not only what it does.
Every store owner having an eCommerce website and using for their store NexoPOS 4.5. This module will make sure the stock available on NexoPOS 4.5 is the same on WooCommerce so that only available stock is sold online.
At the moment, this module uses WooCommerce API and Webhooks to notify NexoPOS of every change that occurs on your online store and to reflect all your modification from NexoPOS to your online store. You'll then be able to perform the following synchronization operations :
Before being able to sync the products to WooCommerce and NexoPOS, you need to configure the module. The first configuration will happen on WooCommerce, then we'll see the configuration possible on NexoPOS.
First of all, we'll head to WooCommerce settings and make sure to create Rest API Keys.
While adding a new key, we'll give :
Once you're done, click on "Generate API Key".
Once you're set, you'll see the consumer key and the secret key, which must be added to this module setting on NexoPOS 4.5.
Now, let's head to NexoPOS 4.x and open WooCommerce settings.
Then we'll need to fill in the following details :
And don't forget to save your changes. This will ensure NexoPOS can submit changes to WooCommerce.
Now we want to make sure that every time something happens on WooCommerce, NexoPOS is notified somehow. In order to do that, we'll need to create webhooks. Let's head to WooCommerce > Settings > Advanced and now let's click on Webhooks.
We'll make sure to register all the topics available and assign them to NexoPOS address. NexoPOS 4.x doesn't support topics for restored entry. Since NexoPOS doesn't have trash where orders, products can be temporarily moved, such topics aren't supported on NexoPOS. Additionally, NexoPOS doesn't support yet WooCommerce coupons. Here are the most recommended topics that should be used :
While creating these entries, all should point to https://yournexopos.com/webhook/wc. Make sure to replace yournexopos.com with your actual domain where NexoPOS 4.5 is installed. Here is an example of one topic being created
We'll cover other settings that need to be made before using this module.
You must set what is the shipping method that should be used for every order that is synchronized from NexoPOS to WooCommerce. For that, you need to open the "Orders" settings within WooCommerce settings.
Don't forget to save your settings.
If you would like to restrict few things that should be synchronized to your online store, you'll head to "Sync To WooCommece" settings select the feature you would like to enable/disable.
Not all data submitted to NexoPOS will have an existing reference. Sometimes, you'll be invited to define what is the default information that will be used if, for a request submitted to NexoPOS, there is no existing reference.
For example, if a product is submitted to NexoPOS while a category assigned to that product doesn't exist yet on NexoPOS, you must define a default category so that every product with a nonexisting category is assigned to that default category.
To configure the defaults for NexoPOS, let's head to "Sync to NexoPOS" tab.
You should define :
from there you'll have to save so that the "default unit" dropdown is populated with the units that belong to the unit group selected. You'll also select :
Once you're done, save your settings.
Let's see what are the tips that can ease your life with this module.
If you would like to synchronize all your existing products to NexoPOS, you'll need to bulk edit those products and just update them (not necessary to change any value). WooCommece will trigger a webhook for every product and those will be created on NexoPOS 4.5.
This only works for products, categories, and customers. If you would like to bulk synchronize your entries, on each component table, you'll select all the entries you would like to synchronize and select the action "Sync Selected".
The module might not work perfectly according to your installation. This module has been tested and developed with WooCommerce 5.6.0. According to the extra WordPress plugins you might have, some errors might occur especially if those plugins change the way WooCommerce works normally.
Also, while creating a product on WooCommerce, NexoPOS will attempt to find if a category attached to that product is already synchronized. If it's not, NexoPOS will get all existing categories and synchronize them. However, this is limited to 99 categories and sub-categories. Beyond that, those categories will be ignored causing some product not synchronizing.
This module is not yet compatible with the multistore module. Once the support is defined, this guide will be updated accordingly.