Add photos to your inventory and choose which categories to keep in sync with your WooCommerce store.
Requirements
- Working and web-accessible WooCommerce v2.6 +. We recommend v3.0 or higher.
Note: Currently the integration does not work with GoDaddy shared hosting services.
What it does
- You can add photos to products (via web interface only).
- We will create matching nested categories in WooCommerce (WC) to match what you have in Syncro.
- You can choose which categories to send to your WC store.
- You can set up webhooks to point to us and we'll try to create matching invoices/payments when your orders are marked "Complete" in WC, i.e. "Paid".
- Syncs inventory levels based on sales in WC.
- Imports products from WC.
What it doesn't do
- Generate unpaid invoices.
- Create a customer. The customer must already exist for the invoice to be created.
- Updates products with "Maintain Stock" unchecked.
- Sync serialized items in WC back to Syncro. Any updates made to serialized items in WC will need to manually be made to the same items in Syncro.
Table of Contents
How it works
Setup
Import Button and One Way Sync
One Way Sync
Processing Orders
Troubleshooting
How it works
Inventory levels will be synced when the product is updated in our software for all products that say maintain stock: true. Other products will be created and available in WC at all times.
Product imports from WooCommerce will also pull the associated product descriptions into Syncro.
Descriptions are synced from Syncro to WC thereafter and changes in Syncro will be reflected in WC. This is a one-way sync, however, and manual changes to product descriptions in WC will halt further product description syncing to prevent accidental overwrites. This behavior can be overridden by forcing a "Sync With Descriptions" from the WooCommerce app card in your Syncro account.
We will attempt to set the first image as the "featured image" on the product, and we'll use the same categories when we first create the products (you can edit those).
We setup a SKU on the product in WooCommerce that is an identifier we need to be able to make updates to the product and not create duplicates, so don't change that.
When we get a webhook POST about an order, we'll try to find a customer on email/phone/full name, otherwise we won't create it for you within the software.
Setup
1. Head to your WordPress site and make sure you have the latest WooCommerce plugin.
2. Enable the REST API in WooCommerce.
Note: Make sure that your WordPress permalinks are enabled. The link below will walk you through those steps.
https://www.2can.io/woocommerce/enable-woocommerce-api-access/
3. Setup an API key on your user, make sure it has write access.
4. In our application, head to Admin > App Center > WooCommerce to set up the app.
Be sure your URL has https, if you don't have SSL we cannot use the REST API and the integration will not work.
Your URL should be set to the root domain and should look like this: https://yourstore.com/
It should NOT look like this: https://yourstore.com/shop
To test whether you're using the correct domain, try entering the URL into your browser and adding /wc-api/v3 to the URL. The wrong URL will show a -1 or 404. The right one will display a page of data.
5. Setup the webhooks from WooCommerce to your account with us by copying the webhook URL out of the App page and putting it into WooCommerce.
6. Optionally go to products and start adding photos.
Import Button and One Way Sync
The 'Import Products' button will import all WooCommerce items into Syncro. This is designed to run once when WooCommece is first being set up and doesn't check for duplications. When that button is pressed, everything in WooCommece is coming into Syncro:
These settings will automatically sync Syncro products in the selected category to WooCommerce. SyncroMSP does not support automatic syncing of newly created products in WooCommerce to Syncro. The new items will have to be created in Syncro and then sent to WooCommerce. In the example below with the current settings, products in the 'Quoter' category will sync to WooCommerce;
One Way Sync
These sync buttons will do the same thing as the 'Auto-Publish Products' option for our users that want to manually choose when products are synced instead of having it happen automatically:
Processing Orders
Inside your Integration card, click the WooCommerce Orders button to see the status of your invoices. Please keep in mind that the invoice will not be created until it is in "Completed" status, in other words there needs to be a payment on the invoice for it show up in Syncro.
Those statuses are based on WooCommerce's invoice processing workflow. Please refer to WooCommerce Documentation here for more information.
WooCommerce Managing Orders
Troubleshooting
WooCommerce error in product sync WORDPRESS-CONNECTION-PROBLEM-401-{"errors":[{"code":"woocommerce_api_authentication_error","message":"Consumer Secret is invalid"}]}
That error means that either:
1. The consumer key/secret were not entered correctly.
2. Your host is not allowing the connection. Users with GoDaddy have not been able to connect. We are recommending https://www.bluehost.com/ as a known host that works with WooCommerce.
NOTE: We have received reports that suggest that GoDaddy shared hosting services will not pass auth headers but that the Business level may. We recommend investigating and potentially updating your hosting service.
3. The key is set to WRITE only.
Important Note:
There is know problem with iThemes security plugin for Wordpress. It doesn't allow us to sync products. To work around this you need to turn off the setting "iThemes plugin > System Tweaks > Filter Long URL Strings" in your WordPress to allow us sync products.