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.

Who Should Use This Module ?

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.

Requirements

Before using this module, it's important to meet the following requirements:

• WooCommerce should be hosted online
• NexoPOS should be hosted online

This module shouldn't then be used with NexoPOS being installed locally. This way, WooCommerce won't be able to send orders to NexoPOS.

How It Works ?

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 :

• Sync Products on both side (NexoPOS <=> WooCommerce)
• Sync Products Category on both side (NexoPOS <=> WooCommerce)
• Sync Customers on both side (NexoPOS <=> WooCommerce)
• Sync Orders on both side (NexoPOS <=> WooCommerce)

Configuration

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.

Synchronization from NexoPOS to WooCommerce

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 :

• a description
• the author who's assigned every modification
• the permissions, which must be read/update

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 :

• The endpoint which should be the address to your online store. Typically is the address that shows your home page.
• The consummer key as copied on WooCommerce
• The consummer secret as copied on WooCommerce
• A random string for encrypting every request

And don't forget to save your changes. This will ensure NexoPOS can submit changes to WooCommerce.

Synchronization From WooCommerce to NexoPOS

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 :

• Customer Created
• Customer Updated
• Customer Deleted
• Order Created
• Order Updated
• Order Deleted
• Product Created
• Product Updated
• Product Deleted

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

Other Useful Settings

We'll cover other settings that need to be made before using this module.

Defining Shipping

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.

Choose what can be synchronized to WooCommerce

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.

Configure Default for Synchronization to NexoPOS

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 :

• the default category
• default unit group

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 :

• the default tax group
• to which users all transaction should be assigned
• for every created customer, to which group they are assigned

Once you're done, save your settings.

Tips And Tricks

Let's see what are the tips that can ease your life with this module.

How to bulk synchronize from WooCommerce

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.

How to bulk synchronize to WooCommerce

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".

Knowns Limitations

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.