Troubleshooting common Zettle Integration errors

Error 1: The Zettle service was not able to reach your site (needed for updates from Zettle). Remove any ‘coming soon’ plugins, enable https and try to refresh the connection. 

Solution:

This error indicates that the Zettle service is unable to communicate with your website, which is essential for receiving updates from Zettle.

Short-term Solution:

1. Refresh the Connection:
   • Go to the Advanced settings section in the plugin.
   • Click the Refresh button.
2. Re-authorize the plugin:
   • If refreshing the connection doesn’t work, go to the General settings of the plugin.
   • Authorize the plugin against Zettle again.

Long-term Solution:

1. Check for Blocking Plugins:
   • If re-authorization fails, something might be blocking the connection between Zettle and your site.
   • Ensure that you have no plugins that can potentially block requests from Zettle (e.g., “coming soon” plugins, security plugins with restrictive firewall settings).
2. Whitelist the Webhook Endpoint:
   • If you have a firewall or CDN in front of your site, make sure that the endpoint /wp-json/izettle/webhook is whitelisted in the settings.
3. Contact Support:
   • If the error persists after trying the above steps, contact the BjornTech support at [email protected].

Error 2: [izettle-product-uuid] found on more posts than expected ([product_id]). when creating Zettle product from WooCommerce product [product_id]

Solution:

This error usually arises when a product in WooCommerce is duplicated using a plugin (like the Duplicate Post plugin) instead of the built-in functionality in WooCommerce.

Short-term Solution:

1. Identify Affected Products:
   • Find the affected products in WooCommerce (the error message will list the product IDs).
2. Trash and Restore:
   • Move these products to Trash (without permanently deleting them). This will break the link between the WooCommerce products and Zettle.
   • Restore the products from Trash.
3. Re-sync:
   • Run a new sync from WooCommerce to Zettle.

Long-term Solution:

• To prevent this issue, always use the built-in feature in WooCommerce for duplicating products, as it is the only method that works correctly with the Zettle integration plugin.

Error 3: Communication error with Zettle when creating/updating Zettle product from WooCommerce product [product_id]. Please try to sync the product to Zettle again by clicking Update in the WooCommerce product view.

Solution:

This error typically occurs when you have initially exported a simple product from WooCommerce to Zettle, and then later added variants to it directly in Zettle, effectively changing it into a variable product.

To resolve this, enable the Allow conversion from simple to variable products setting in the Advanced settings of the plugin.

This should allow the plugin to correctly handle the change from a simple to a variable product and resolve the communication error.