Important: Maropost Commerce Cloud POS is not available outside of Australia and New Zealand.
So that your registers can run offline and as quickly and smoothly as possible, data is periodically synced between registers and your Maropost Commerce control panel.
When does a sync happen?
You must be online for synchronisation to happen. When online, a full sync will happen:
- On the register setup.
- When you click on the synchronise data button under the menu icon.
What is a full sync?
Full synchronisation will update the following details:
- Register configuration
- Receipt details (phone number, address, etc.)
- Staff user details (new pin codes, images, etc.)
- Products (newly added and updated)
- Categories (newly added and updated)
Activating Product Partial Sync
For merchants with a large product catalogue approved for Neto POS, a full sync may take longer than usual. To address this, you can enable the Product Partial Sync option, which only syncs products that have been modified since the last sync.
When enabled, selecting Synchronise data will initiate a partial product sync. All other data, including register settings, receipt details, and categories, will continue to sync fully and update as normal.
Note: Deleted products not captured by the partial sync will persist on Neto POS. To prevent this, make sure to uncheck Active and/or Approved to show on Neto POS on any product before deleting it.
Bulk updates can be made through the Import Wizard, API, or the product listing page. However, be aware that certain bulk actions on the product listing page do not update a product's timestamp, meaning those products won't be included in the partial sync.
If a product has been deleted without first being set to inactive or unapproved, you can disable the partial product sync and run a data sync on the POS register to perform a full sync.
What is a transaction sync?
Transaction synchronisations occur immediately after completing the transaction and returning to the main sale screen, while being online. They will happen frequently to get your transactions into your Maropost Commerce control panel as quickly as possible.
You can tell when a transaction sync is in progress by opening the side menu, and the synchronisation icon will be spinning next to the number of unsynchronised transactions.
Can I tell if any transactions have not synchronised yet?
If you are offline, transactions will not synchronise with your Maropost Commerce control panel. To see how many orders have not been synchronised, open your side menu. You will be able to see the count of unsynchronised transactions at the bottom of the menu. You will also be able to see the date your register was last fully synchronised.
Transactions will attempt to synchronise when you are back online.
What happens if I lose internet connection?
Warning: Do not clear your browser history while in offline mode; otherwise, all sales that are still on the device that have not been pushed to your Maropost Commerce control panel will be lost.
After you have set up a register and synced its data, you can use your register offline. The data required to run your register is stored locally in your browser.
What can’t I do when offline?
The great news is that you can complete sales while offline! Some advanced functionality will not be available, though. This includes:
- Accessing your back office/control panel.
- Creating and editing items.
When you regain internet connection, the system automatically syncs any sales made while offline with your Maropost Commerce control panel, and all advanced functionality becomes available again.
Synchronisation Errors
Sometimes, there are issues that can prevent sales and returns from synchronising with your Maropost Commerce control panel.
To help diagnose these issues with Maropost support, synchronisation errors can be viewed from your Maropost POS register.
A common issue occurs when a customer is added to the order; it's missing either first, last, or email/username details. If this information is missing, the order will not sync.
To view and troubleshoot synchronisation errors:
- Click on the Sales history button on the register's side menu.
- Locate the order that is having trouble synchronising. The following information gets displayed:
Transactions that had an issue synchronising will have a red icon.
Transactions that have successfully synchronised will have a green tick.
Transactions that haven't tried to synchronise yet will have an orange icon indicating synchronisation is pending.
- Click on the transaction that you wish to troubleshoot.
- Click on the Error button. Do remember this button only appears on transactions that face synchronisation issues, and won't appear for transactions that have synchronised or haven't attempted to synchronise yet.
- The sync errors page displays the following error messages that may appear in your account:
The number of times the transaction has attempted to synchronise.
Last time it tried to synchronise (in the local time of your register).
A list of error code(s).
A list of error messages, if available.
See the table below to troubleshoot the issue:
Warning Message | Reason | Solution |
|---|
“message”: “ORDERLINE: PRODUCT_SKU is an invalid SKU” | This error is the result of a product being deleted. Because POS allows transactions to be completed whilst offline against potentially old sets of data, there are instances where the product may still be sold despite a deletion. | Re-create the product in the control panel with the same SKU. Once the transactions have synced, the product can then be deleted again if it is no longer needed. Ensure you sync your POS register after deleting to avoid creating additional transactions with the product. |
“message”: “ORDERLINE: PRODUCT_SKU is an invalid component SKU” | This error is the result of a product being deleted. Because POS allows transactions to be completed whilst offline against potentially old sets of data, there are instances where the product may still be sold despite a deletion. | Re-create the product in the control panel with the same SKU. Once the transactions have synced, the product can then be deleted again if it is no longer needed. Ensure you sync your POS register after deleting to avoid creating additional transactions with the product. |
“message”: “Validation Failed”, “paymentMethod”: “This value is not valid.” | For POS to sync transactions, the following payment methods are required: “POS Cash”, “POS Card”, or “Account Credit”. The names of these payment methods should not be changed, as it results in transactions failing to sync. | Revert the payment methods back to their original name as listed in the explanation. |
“message”: “ORDERLINE: PRODUCT_SKU is not a kitting item” | If a product is sold as a kit in POS, then it must still be a kit when trying to sync the transaction to the control panel. | Change the product back to being a kit. Once the transactions have synced, the product can then be converted back to a regular product. Ensure you sync your POS register after updating the product to avoid further sync issues. |
Cannot create more vouchers for <voucher_SKU> for order <order#>. All vouchers had been created. | This happens when a gift voucher was sold, but the voucher program is not visible to the customer group of the customer it was sold to (only the voucher product was). | In your control panel, make the voucher available to that customer group, then in POS, go back to the sale and complete it again. |
This shift is no longer active. | The shift has been closed on the server but is still active on the device. | Reload the page/restart the app to trigger a new shift opening. |
If the error you are encountering isn’t detailed above, please get in touch with our support team, who can assist further in resolving the issue.